1in8b Engine · 80億分の1を動かす人生シミュレーション

1in8b Engine API ベータ

80億分の1では、いま生まれてくる赤ちゃんのひとりになって、一度きりの人生を最後まで生きます。生まれる場所は選べません。1in8b Engine APIは、その土台にあるエンジンをお貸しするものです。国や生まれた年などの条件を決めてたくさんの人生を一度に走らせ、人生がどう変わるかを統計で比べられます。コードが書けなくても大丈夫。AIに頼めば、自分だけの実験ページができあがります。

キーを受け取ったら、すぐに試せます。コードなしにボタンだけでエンジンを呼び出す 1in8b Engine を試す ページがあります。キーのメールのリンクを押すと、キーが入った状態で開きます。

企業や団体で使う

会社、学校、報道機関、団体も、自分のコンテンツやサービスの中で1in8b Engineを使えます。商用利用もでき、「1in8b Engine (1in8b.life)」と出典を書くだけです。

• 教育コンテンツ：教材や学習アプリで「ほかの国に生まれていたら」を自分で生きてみる
• 記事とレポート：読者が自分で生まれてみるインタラクティブ記事、国や時代を並べたグラフィック
• キャンペーンと展示：会社や団体のキャンペーンページ、博物館や展示会場のキオスク
• 物語の人物：小説、映像、仮想世界に出てくる人たちの背景
• 多様性研修：社員研修で、ほかの国の一年一年を選びながら生きてみる
• AIアプリ：MCPでAIアプリにつなぎ、会話の中で人生を呼び出す

長く使えるように：v1のアドレスと項目はなくしません。半年ごとにエンジンを凍結した研究版があり、同じ結果をもう一度出せます。答えに実在の人はおらず、呼び出しに必要なのはキーだけです。

できないこと：実在の人についての判断（採用、保険、融資など）に使うこと、シミュレーションを予測や公式統計・市場データのように示すこと、答えでAIモデルを学習させること、APIの転売やキーの共有。くわしくは規約にあります。

量と料金：まず無料のキーで試し、使う量が増えたら料金プランに移れます。利益を目的としない研究・授業・非営利・報道は申請すれば無料です。いちばん大きなプランより多く使うときや、決まった期間に大きく使うときはcontact@1in8b.lifeまでお知らせください。

プロジェクトで使う

• NPCと仮想世界: いま生きている人（/person）を町の住人に。仕事、家族、生きてきた歴史がついてきます。/live を1回呼べば10人が1年を生きます。
• アプリとインタラクティブ・ストーリー: /live が決断をひとつ、世界の確率と一緒に届けます。画面はあなたが作り、選ぶのはその人です。
• AIの評価と研究: 住んでいる場所の割合で選んだ人々でAIを試したり、条件を分けて人生を比べたり。結果はシミュレーションだと必ず明記してください。
• 授業と歴史: 1950年以降のどの年にも生まれてみられます。毎年、その頃の国と、人々に届いた歴史がついてきます。
• すべての呼び出しと条件は英語の説明書に、AIツール向けの仕様は /api/v1/openapi.json にあります。

コードなしで、AIと使ってみる

1. キーをもらう：api@1in8b.life に何でもいいのでメールを送ると、無料のキーがすぐ返信で届きます。キーは k8b_ で始まります。
2. AIに頼む：下の文をそのままコピーして、使っているAIチャットに貼り付けてください。キーはAIに教えないでください。
3. ファイルを開く：AIが作ったHTMLファイルをダウンロードして、ブラウザで開いてください。チャットの中のプレビューでは通信がブロックされて動かないことがあります。
4. 実験する：ページのいちばん上の欄にキーを入れ、二つの国を選んで比べてみましょう。エラーが出たら、画面のメッセージをそのままAIに貼り付ければ直してくれます。

コピーして貼り付ける文

ウェブブラウザでそのまま開けるHTMLファイルを1つ作ってください。HTML・CSS・JavaScriptをすべてそのファイル1つに入れ、インストールするものはなしにしてください。
1in8b Engine API（説明: https://1in8b.life/en/api/）を使って、二つの国でシミュレーションした人生を比べるページです。

1. いちばん上にAPIキーを貼り付ける欄を置いてください。キーは k8b_ で始まります。ページを開いている間だけ使い、ファイルの中には書かないでください。
2. 国を選ぶメニューを二つ。一覧は https://1in8b.life/api/v1/countries から取得します（キー不要）。各項目の iso3 を使い、名前は name.ja で表示してください。生まれた年の欄も一つ（1950〜2025、空欄なら今日の世界）。
3. 「比べる」ボタンを押すと、国ごとに次のアドレスを呼び出します。
   https://1in8b.life/api/v1/simulate?country=ISO3&n=15
   生まれた年を入れたら &year=年 を付け、ヘッダーは Authorization: Bearer <キー>
4. 返ってくる答えには female と male があり、それぞれに age_at_death.mean（平均寿命）、survival["65"]（65歳まで生きた割合）、children_by_46（46歳までの子どもの数の平均）、at_40.working（40歳で働いている割合）、at_40.education（40歳の学歴ごとの割合）があります。割合は0から1の数字です。二つの国を並べて、わかりやすい文と簡単な棒グラフで、日本語で見せてください。
5. 結果の下に「1in8b Engine（1in8b.life）がシミュレーションした人生で、実在の人ではありません。性別ごとに15人なので、数字はおおよそです。」と書いてください。
6. 呼び出しに失敗したら、答えの error の文を画面に表示してください。
無料のキーは1回に60、1か月に2000ライフユニットまでです。この比較は1か国30ユニット（生まれた年を入れると60）なので、n は15のままにしてください。

もっと試してみる

• AIに「同じ国で1960年に生まれた人生と、今日生まれた人生を比べるように変えて」と頼んでみましょう。
• ひとりの一生を物語のように見たいなら、/api/v1/life?record=1 を使うように頼んでください。記録は英語で届くので、翻訳も一緒に頼みましょう。
• 「どう人生を終えたかも見せて（名前は /api/v1/causes から）」「グラフをもっと見やすく」のように一つずつ直してもらうと、AIと一緒に作るやり方がすぐ身につきます。

無料のお試し

• キー1つにつき1か月2000ライフユニット。今日の世界では1つの人生が1ユニット、過去の年や未来の世界では2ユニットです。
• 1回の呼び出しで、一人ずつ（life）は5人まで、比較（simulate）は60ユニットまで。1分に30回まで呼び出せます。
• 上の比較なら、1か月に33回ほど（生まれた年を入れると16回ほど）試せます。もっと多く使う必要があれば contact@1in8b.life へお知らせください。
• 研究（大学・研究所）、授業、非営利団体や公的機関、報道のように、お金を稼がない公共の目的なら、ビルダープランの大きさを1年間無料で使えます。キーを受け取る（受け取る予定の）アドレスから contact@1in8b.life へ、どなたか、何を作るかを書いて送ってください。

開発者向けのまとめ

コードから直接呼び出すときに知っておきたいことだけをまとめました。すべてのパラメーターとフィールド、例は英語の説明書にあります。

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

• キーは Authorization: Bearer k8b_… ヘッダーで送ります。キーはサーバーに置いてください。ウェブページやダウンロードするアプリに入れると、誰でも読めてしまいます。
• よく使うパラメーター：country（ISOの3文字コード。省略すると出生の割合に応じて選びます）、sex、year（1950–2025、過去の世界）または future=1（これからの世界）、n（人数）、seed（同じseedと同じエンジンのバージョンなら同じ人生）、record=1（毎年の記録、英語）。
• lang=koのように入れると、記録と選択の文が18言語のうちその言語で届きます。/simulateは国を4つ（country=KOR,NGA）、生まれた年を6つ（years=1960,today,future）まで一度に並べて比べられます。人生ごとに経験したこと（met：戦争、災害、停電、家に初めて来た電気やテレビなど）が年齢と年とともに届きます。
• ライフユニットで数えます。今日の世界では1つの人生が1ユニット、過去の年やこれからの世界では2ユニットです。答えの usage に今月の使用量が出ます。
• エラーもJSONで返ります：error（何が起きたか）、code（プログラム向け）、status。400はエンジンが受け付けられないパラメーターや、世界にない条件、401はキーがない、または知らないキー、429は呼び出しが多すぎる（rate）か、今月のユニットを使い切った（month。more は追加の入手先、resets は月が改まる日）です。
• v1のパスとフィールドは削除も名前の変更もしません。meta.engine が変わると、同じseedでも違う人生になることがあります。結果を再現したいときは、エンジンのバージョンと日付を残しておいてください。

知っておいてほしいこと

• APIの人生は実際の統計に沿ってシミュレーションしたもので、現実の世界や実在の人ではありません。いちばん重い出来事（自殺などいくつか）は、求めたときだけ出てきます。
• キーごとにどんな使い方をしているかを見ています。利用条件に反して使われるキーは停止することがあります。
• 結果を見せるときは、出典として「1in8b Engine (1in8b.life)」と書いてください。
• キーは自分だけで使ってください。人に渡したり、公開の場所に載せたりしないでください。なくしたら、同じアドレスからもう一度メールを送ると新しいキーが届きます。
• 実在の人についての判断（健康、保険、ローン、仕事など）には使わないでください。
• 技術的な説明と利用条件の全文は英語のページにあり、その条件が適用されます。

研究や授業に使うなら：方法と検証（出典、データへの合わせ方、実際との差、限界、引用のしかた）と、1年間変わらない研究用の固定版（engine）を英語で案内しています。