1in8b Engine · la simulazione di vita dietro 1 su 8 miliardi

1in8b Engine API beta

In 1 su 8 miliardi diventi uno dei bambini che stanno nascendo adesso e vivi una sola vita fino alla fine. Dove nasci non si sceglie. L’API 1in8b Engine ti presta il motore che c’è dietro: fissa delle condizioni come il paese o l’anno di nascita, fai girare tante vite insieme e confronta con le statistiche come cambiano le vite. Non serve saper programmare: chiedilo a un’IA e avrai la tua pagina per gli esperimenti.

Hai una chiave? Provala subito. La pagina Prova il 1in8b Engine chiama il motore con dei pulsanti, senza programmare. Il link dell’e-mail con la tua chiave la apre con la chiave già inserita.

Per aziende e organizzazioni

Aziende, scuole, redazioni e associazioni possono usare il 1in8b Engine nei propri contenuti e servizi, anche a fini commerciali, citando «1in8b Engine (1in8b.life)».

• Contenuti didattici: libri di testo e app di studio in cui si vive in prima persona «se fossi nato altrove»
• Articoli e rapporti: articoli interattivi in cui chi legge nasce di persona, grafici che mettono paesi ed epoche fianco a fianco
• Campagne e mostre: la pagina di campagna di un’azienda o di un’associazione, un totem in un museo o in una mostra
• Personaggi: il passato delle persone di romanzi, film e mondi virtuali
• Formazione sulla diversità: dipendenti che vivono un anno dopo l’altro in un altro paese, scegliendo lungo la strada
• App di IA: collegare un’app di IA via MCP e portare vite dentro una conversazione

Fatto per durare: la v1 non toglie mai un indirizzo o un campo. Due volte l’anno il motore viene congelato come edizione di ricerca, così un risultato si può rifare. Nelle risposte non c’è nessuna persona reale, e a una chiamata basta la chiave.

Non è permesso: decisioni su persone reali (assunzioni, assicurazioni, prestiti e simili), presentare vite simulate come previsioni, statistiche ufficiali o dati di mercato, addestrare modelli di IA con le risposte, rivendere l’API o condividere una chiave. Il testo completo è nelle condizioni.

Volume e prezzo: inizia con una chiave gratuita e passa a un piano quando l’uso cresce. Ricerca, insegnamento, associazioni senza scopo di lucro e giornalismo che non guadagnano sono gratis su richiesta. Per più del piano più grande, o per un grande uso in un periodo stabilito, scrivi a contact@1in8b.life.

Usalo in un progetto

• PNG e mondi virtuali: persone vive oggi (/person) come abitanti, con il loro lavoro, la loro famiglia e la storia che hanno attraversato; una chiamata a /live porta avanti 10 vite di un anno.
• App e storie interattive: /live invia ogni decisione con le probabilità che il mondo le dà. Tu disegni lo schermo, la persona sceglie.
• Valutazione dell’IA e ricerca: metti alla prova un’IA con persone estratte secondo dove vive la gente, o confronta vite per condizioni. Indica che i risultati vengono da una simulazione.
• Lezioni e storia: nascere in qualsiasi anno dal 1950; ogni anno porta il paese com’era e la storia che ha raggiunto le persone.
• Tutte le chiamate e le condizioni sono nella documentazione in inglese; gli strumenti di IA possono leggere /api/v1/openapi.json.

Senza programmare, con un’IA

1. Ottieni una chiave: scrivi qualsiasi cosa a api@1in8b.life; una chiave gratuita arriva subito in risposta. Inizia con k8b_.
2. Chiedi a un’IA: copia il testo qui sotto così com’è nella chat con l’IA che usi. Non dare la tua chiave all’IA.
3. Apri il file: scarica il file HTML creato dall’IA e aprilo nel browser. L’anteprima dentro la chat può bloccare la connessione.
4. Sperimenta: incolla la chiave nella casella in cima alla pagina, scegli due paesi e confronta. Se qualcosa va storto, incolla nella chat il messaggio di errore che vedi: l’IA lo correggerà.

Il testo da copiare e incollare

Creami un unico file HTML che posso aprire nel browser: HTML, CSS e JavaScript tutti in quel file, niente da installare.
La pagina confronta vite simulate in due paesi con l’API 1in8b Engine (documentazione: https://1in8b.life/en/api/).

1. In alto, una casella dove incollo la mia chiave API (inizia con k8b_). Usala solo finché la pagina è aperta; non scriverla mai nel file.
2. Due menu dei paesi riempiti da https://1in8b.life/api/v1/countries (senza chiave): usa l’iso3 di ogni voce e mostra i nomi in italiano (l’elenco dà name.en: traducili tu). Una casella facoltativa per l’anno di nascita, dal 1950 al 2025; vuota = il mondo di oggi.
3. Un pulsante "Confronta" che, per ogni paese, chiama
   https://1in8b.life/api/v1/simulate?country=ISO3&n=15
   (aggiungi &year=AAAA se c’è un anno) con l’intestazione Authorization: Bearer <chiave>
4. Ogni risposta contiene "female" e "male", ciascuno con age_at_death.mean (età media alla morte), survival["65"] (quota ancora in vita a 65 anni), children_by_46 (numero medio di figli entro i 46 anni), at_40.working (quota che lavora a 40 anni) e at_40.education (quote per titolo di studio a 40 anni). Le quote sono numeri da 0 a 1. Mostra i due paesi affiancati, con frasi semplici e semplici grafici a barre, in italiano.
5. Sotto i risultati scrivi: "Vite simulate dal 1in8b Engine (1in8b.life), non persone reali. Con 15 vite per sesso, le cifre sono approssimative."
6. Se una chiamata non riesce, mostra il testo "error" della risposta.
La mia chiave gratuita permette 60 unità di vita per chiamata e 2000 al mese. Questo confronto ne usa 30 per paese (60 con l’anno di nascita), quindi lascia n a 15.

Prova ancora

• Chiedi all’IA di confrontare invece uno stesso paese in due anni, per esempio vite cominciate nel 1960 e oggi.
• Per leggere una vita come una storia, chiedile di usare /api/v1/life?record=1. Il racconto arriva in inglese: chiedi anche la traduzione.
• Cambia una cosa alla volta ("mostra anche come finiscono le vite, con i nomi da /api/v1/causes", "rendi i grafici più chiari"): si costruisce così con un’IA, e ci si abitua in fretta.

La prova gratuita

• 2000 unità di vita al mese per chiave. Nel mondo di oggi una vita vale 1 unità; in un anno passato o nel mondo che verrà, 2.
• Per chiamata: fino a 5 vite una per una (life) e fino a 60 unità per un confronto (simulate). Fino a 30 chiamate al minuto.
• Con il confronto qui sopra sono circa 33 prove al mese (circa 16 con l’anno di nascita). Se te ne servono di più, scrivi a contact@1in8b.life.
• Per un uso di interesse pubblico senza scopo di lucro (ricerca in un’università o un istituto, insegnamento, enti non profit e pubblici, giornalismo), la dimensione del piano builder è gratuita per un anno. Scrivi a contact@1in8b.life dall’indirizzo che riceve (o riceverà) la chiave, dicendo chi sei e cosa stai facendo.

In breve, per gli sviluppatori

Quello che ti serve per chiamarlo da codice. Ogni parametro e ogni campo, con esempi, sono nella documentazione in inglese.

curl -H 'Authorization: Bearer k8b_…' 'https://hayat.ajans.bond/api/v1/simulate?country=KOR&n=30'

• Invia la chiave nell’intestazione Authorization: Bearer k8b_…. Tienila sul tuo server: in una pagina web o in un’app che la gente scarica, chiunque può leggerla.
• Parametri comuni: country (codice ISO di tre lettere; omettilo per estrarre in base alla quota di nascite), sex, year (1950–2025, il mondo passato) o future=1 (il mondo che verrà), n (quante), seed (lo stesso seed e la stessa versione del motore danno le stesse vite), record=1 (il resoconto anno per anno, in inglese).
• Con lang=ko (o una delle 18 lingue) il racconto e le scelte arrivano in quella lingua. /simulate confronta fianco a fianco fino a 4 paesi (country=KOR,NGA) e 6 anni di nascita (years=1960,today,future) in una sola chiamata. Ogni vita dice che cosa le ha portato il mondo (met: guerre, disastri, blackout, la prima elettricità o televisione in casa), con l’età e l’anno.
• L’uso si conta in unità di vita: una vita nel mondo di oggi vale 1 unità, in un anno passato o nel mondo che verrà 2. Il campo usage di ogni risposta mostra l’uso del mese.
• Anche gli errori sono JSON: error (cosa è successo), code (per i programmi), status. 400: un parametro che il motore non può accettare o una condizione che il mondo non ha; 401: manca la chiave o è sconosciuta; 429: troppe chiamate (rate) o unità del mese esaurite (month, con more, da dove arriva altro, e resets, il giorno in cui il mese ricomincia).
• I percorsi e i campi di v1 non vengono mai rimossi né rinominati. Quando meta.engine cambia, lo stesso seed può dare un’altra vita: per riprodurre un risultato, conserva la versione del motore e la data.

Da sapere

• Le vite dell’API sono simulate secondo statistiche reali: non sono il mondo reale né persone reali. Le righe più pesanti (il suicidio e poche altre) compaiono solo se le chiedi.
• Controlliamo come viene usata ogni chiave, e una chiave usata contro i termini può essere disattivata.
• Quando mostri i risultati, cita la fonte “1in8b Engine (1in8b.life)”.
• La chiave è solo tua: non darla ad altri e non pubblicarla. Se la perdi, riscrivi dallo stesso indirizzo e ne arriverà una nuova.
• Non usare i risultati per decidere qualcosa su persone reali (salute, assicurazioni, credito, lavoro…).
• La spiegazione tecnica e il testo completo delle condizioni d’uso sono nella pagina in inglese, e valgono quelle condizioni.

Per la ricerca o l’insegnamento: Metodi e validazione (fonti, adattamento ai dati, scarto dalla realtà, limiti, come citare) e le edizioni di ricerca che restano uguali per un anno (engine), in inglese.