1in8b Engine API چیست؟

API شبیهسازی زندگی: مسیرهای زندگیِ شبیهسازیشده برای هر تولدی در ۱۷۲ کشور و سرزمین، بر پایهٔ آمار سازمان ملل، سازمان جهانی بهداشت و بانک جهانی. زندگیهای کامل، چشماندازها و آدمهایی که اکنون زندگی میکنند، برای اپها، پژوهش، آموزش و محتوای شرکتها. طرح رایگان دارد و بیبرنامهنویسی هم با هوش مصنوعی ساخته میشود.

آیا شرکت یا مدرسه هم میتواند از آن استفاده کند؟

بله. جهانِ «یک در هشت میلیارد» را میتوان از راه 1in8b Engine API قرض گرفت و در محتوا و خدمات خود به کار برد: مواد آموزشی، گزارشها، کارزارها، نمایشگاهها، شخصیتهای داستان، اپهای هوش مصنوعی. استفادهٔ تجاری با ذکر منبع آزاد است، و پژوهش، آموزش، سازمانهای غیرانتفاعی و روزنامهنگاری بیدرآمد با درخواست آن را رایگان میگیرند. جزئیات در راهنمای API است. برای به کار بردن خود این سایت در کلاس، راهنمای معلمان را ببینید.

آیا اینها دادهٔ آدمهای واقعی است؟

نه. هر زندگی بر پایهٔ آمار عمومی مانند آمار سازمان ملل، سازمان جهانی بهداشت و بانک جهانی شبیهسازی شده است. اینها آدم واقعی، سند یا پیشبینی نیستند؛ هر جا نشانشان میدهید بگویید که شبیهسازیاند.

1in8b Engine · شبیه‌سازی زندگی پشت «یک در هشت میلیارد»

1in8b Engine API آزمایشی

در «یک در هشت میلیارد» یکی از نوزادانی می‌شوید که همین حالا به دنیا می‌آیند و زندگی همان یک نفر را تا پایان زندگی می‌کنید. نمی‌توانید انتخاب کنید کجا به دنیا بیایید. 1in8b Engine API موتوری را که پشت این کار است به شما قرض می‌دهد: شرط‌هایی مثل کشور یا سال تولد را مشخص کنید، زندگی‌های زیادی را یک‌جا اجرا کنید و با آمار مقایسه کنید که زندگی‌ها چگونه با هم فرق دارند. برنامه‌نویسی لازم نیست: از هوش مصنوعی بخواهید تا صفحهٔ آزمایش‌های خودتان را برایتان بسازد.

کلید گرفتید؟ همین حالا بیازمایید. صفحهٔ آزمودن 1in8b Engine موتور را با دکمه فرا می‌خواند، بی‌برنامه‌نویسی. پیوندِ ایمیلِ کلیدتان آن را با کلیدِ گذاشته‌شده باز می‌کند.

برای شرکت‌ها و نهادها

شرکت‌ها، مدرسه‌ها، رسانه‌ها و سازمان‌ها هم می‌توانند 1in8b Engine را در محتوا و خدمات خودشان به کار ببرند، حتی برای کار تجاری، تنها با ذکر منبع: «1in8b Engine (1in8b.life)».

محتوای آموزشی: کتاب‌های درسی و اپ‌های یادگیری که در آن‌ها خودتان «اگر در کشور دیگری به دنیا آمده بودم» را زندگی می‌کنید
گزارش و مقاله: گزارش‌های تعاملی که خواننده در آن‌ها خودش به دنیا می‌آید، نمودارهایی که کشورها و دوره‌ها را کنار هم می‌گذارند
کارزار و نمایشگاه: صفحهٔ کارزار یک شرکت یا سازمان، کیوسکی در موزه یا نمایشگاه
شخصیت‌ها: گذشتهٔ آدم‌های رمان‌ها، فیلم‌ها و جهان‌های مجازی
آموزش تنوع: کارکنانی که سال‌به‌سال در کشور دیگری زندگی می‌کنند و در راه انتخاب می‌کنند
اپ‌های هوش مصنوعی: وصل کردن یک اپ هوش مصنوعی از راه MCP و آوردن زندگی‌ها به گفت‌وگو

برای مدت طولانی: v1 هیچ نشانی یا فیلدی را حذف نمی‌کند. سالی دو بار موتور به شکل نسخهٔ پژوهشی منجمد می‌شود تا بتوان همان نتیجه را دوباره گرفت. در هیچ پاسخی آدم واقعی نیست، و برای هر فراخوانی تنها کلید لازم است.

مجاز نیست: تصمیم‌گیری دربارهٔ آدم‌های واقعی (استخدام، بیمه، وام و مانند آن)، جا زدن زندگی‌های شبیه‌سازی‌شده به جای پیش‌بینی، آمار رسمی یا دادهٔ بازار، آموزش دادن مدل‌های هوش مصنوعی با پاسخ‌ها، فروش دوبارهٔ API یا شریک شدن در کلید. متن کامل در شرایط است.

مقدار و قیمت: نخست با کلید رایگان امتحان کنید و وقتی استفاده بیشتر شد به یک طرح بروید. پژوهش، آموزش، سازمان‌های غیرانتفاعی و روزنامه‌نگاری بی‌درآمد با درخواست رایگان است. برای بیش از بزرگ‌ترین طرح، یا استفادهٔ زیاد در مدتی معین، به contact@1in8b.life بنویسید.

طرح‌ها

با یک کلید رایگان شروع کنید و وقتی بیشتر لازم داشتید یک طرح انتخاب کنید.

رایگان

US$0

برای امتحان موتور و آزمایش‌های کوچک

ماهی 2,000 واحد زندگی
در هر فراخوانی life تا 5 زندگی و در simulate تا 60 واحد
30 فراخوانی موتور در دقیقه

گرفتن کلید رایگان

Builder

US$9 / ماه

یا US$90 / سال · 12 ماه به قیمت 10

برای یک نفر یا یک پروژهٔ کوچک

ماهی 200,000 واحد زندگی
در هر فراخوانی life تا 50 زندگی و در simulate تا 400 واحد
300 فراخوانی موتور در دقیقه

اشتراک ماهانه اشتراک یک‌ساله

Studio

US$69 / ماه

یا US$690 / سال · 12 ماه به قیمت 10

برای پروژه‌ای بزرگ، جهانی که آدم‌های زیادی در آن زندگی می‌کنند

ماهی 5,000,000 واحد زندگی
در هر فراخوانی life تا 100 زندگی و در simulate تا 400 واحد
1,500 فراخوانی موتور در دقیقه

اشتراک ماهانه اشتراک یک‌ساله

طرح‌ها بر اساس کاربرد

کاربرد	واحد زندگی در ماه	طرح مناسب
شخصیت‌های یک رمان یا کمیک: 50 شخصیت، برای هر کدام چهار زندگی قرعه‌کشی‌شده تا انتخاب کنید	200	رایگان
یک کلاس: 30 دانش‌آموز، هر کدام پنج زندگی در چهار درس	600	رایگان
اپلیکیشنی با 10,000 کاربر: سه زندگی برای هر کاربر در ماه	30,000	Builder
پژوهشی دربارهٔ همهٔ کشورها: 300 زندگی از هر جنس در هر یک از 172 کشور و منطقه	103,200	Builder
اپلیکیشنی با 200,000 کاربر: سه زندگی برای هر کاربر در ماه	600,000	Studio
پژوهشی در میان سال‌های تولد: 600 زندگی برای هر یک از 76 سال از 1950 تا 2025 در 10 کشور (سال گذشته 2 واحد حساب می‌شود)	912,000	Studio

هر زندگی 1 واحد است (اگر در سالی گذشته یا جهان آینده آغاز شود 2 واحد). پژوهش، آموزش، سازمان‌های غیرانتفاعی و روزنامه‌نگاری، در صورتی که بدون کسب درآمد استفاده شوند، می‌توانند اندازهٔ Builder را یک سال رایگان درخواست کنند (روش).

طرح یک اشتراک است. Link از Stripe فروشندهٔ رسمی است و مالیات، رسیدها و لغو را بر عهده می‌گیرد. بعد از پرداخت به صفحه‌ای برمی‌گردید که کلیدتان را فقط یک بار نشان می‌دهد و کلیدی که پیش‌تر به آن نشانی فرستاده شده از کار می‌افتد (مصرف این ماه ادامه پیدا می‌کند). هر وقت خواستید می‌توانید لغو کنید؛ طرح تا پایان دوره‌ای که پرداخت کرده‌اید ادامه دارد. در طرح سالانه هم واحدهای زندگی هر ماه دوباره می‌آیند، به همان مقدار طرح ماهانه. اگر تا 30 روز بعد از پرداخت از contact@1in8b.life بخواهید، پرداخت پس داده می‌شود. اطلاعات پرداخت فقط نزد Stripe می‌ماند و شرایط برقرار است.

اتصال به یک برنامهٔ هوش مصنوعی (MCP)

موتور را در یک اپ هوش مصنوعی مثل Claude به‌عنوان کانکتور اضافه کنید و فقط با گفت‌وگو از آن استفاده کنید، بدون کد و بدون فایل. فقط سه قدم.

1گرفتن کلید رایگان
هر ایمیلی به api@1in8b.life بفرستید، کلید همان لحظه در پاسخ می‌رسد.
2افزودن کانکتور سفارشی
در Claude (وب یا دسکتاپ) به تنظیمات ← کانکتورها بروید، «افزودن کانکتور سفارشی» را بزنید و نشانی زیر را وارد کنید. در اپ‌های هوش مصنوعی دیگر هم همین نشانی را در منوی کانکتورهای MCP بگذارید.
https://1in8b.life/mcp
3یک‌بار چسباندن کلید
«اتصال» را بزنید تا صفحه‌ای از 1in8b.life باز شود. کلیدتان را یک‌بار آنجا بچسبانید و تمام. کلید هرگز به اپ هوش مصنوعی داده نمی‌شود.

بعد از آن فقط بخواهید: «سه نسل را زندگی کن، از مادربزرگی که 1950 در کره به دنیا آمده»، «کودکان هند را در 1960 و امروز مقایسه کن». هر فراخوانی از واحدهای کلید شما استفاده می‌کند.

در یک پروژه

NPCها و جهان‌های مجازی: آدم‌هایی که امروز زنده‌اند (/person) ساکنان جهان شما می‌شوند، با کار، خانواده و تاریخی که از سر گذرانده‌اند؛ یک فراخوانی /live ده زندگی را یک سال جلو می‌برد.
اپ‌ها و داستان‌های تعاملی: /live هر تصمیم را همراه با احتمالی که جهان به آن می‌دهد می‌فرستد. صفحه را شما می‌سازید، انتخاب با آن آدم است.
ارزیابی هوش مصنوعی و پژوهش: هوش مصنوعی را با آدم‌هایی که بر پایهٔ جای زندگی مردم برگزیده شده‌اند بیازمایید، یا زندگی‌ها را بر پایهٔ شرایط مقایسه کنید. بنویسید که نتیجه‌ها از یک شبیه‌سازی است.
کلاس و تاریخ: می‌توانید در هر سالی از ۱۹۵۰ به بعد به دنیا بیایید؛ هر سال کشورِ آن روزگار و تاریخی را که به مردم رسید با خود می‌آورد.
همهٔ فراخوانی‌ها و شرایط در راهنمای انگلیسی است و ابزارهای هوش مصنوعی می‌توانند /api/v1/openapi.json را بخوانند.

بدون برنامه‌نویسی، با هوش مصنوعی

کلید بگیرید: هر چیزی به api@1in8b.life بنویسید؛ یک کلید رایگان همان لحظه در پاسخ می‌آید. کلید با k8b_ شروع می‌شود.
از هوش مصنوعی بخواهید: متن زیر را همان‌طور که هست در گفت‌وگوی هوش مصنوعی‌ای که استفاده می‌کنید بچسبانید. کلیدتان را به هوش مصنوعی ندهید.
فایل را باز کنید: فایل HTML را که هوش مصنوعی می‌سازد دانلود کنید و در مرورگرتان باز کنید. پیش‌نمایش داخل گفت‌وگو ممکن است اتصال را مسدود کند.
آزمایش کنید: کلیدتان را در کادر بالای صفحه بچسبانید، دو کشور انتخاب کنید و مقایسه کنید. اگر خطایی آمد، پیامی را که روی صفحه دیده می‌شود همان‌طور که هست در گفت‌وگو بچسبانید تا هوش مصنوعی درستش کند.

متنی که باید کپی و جایگذاری کنید

یک فایل HTML برایم بساز که در مرورگر وبم باز کنم: HTML و CSS و JavaScript همه در همین یک فایل باشند و چیزی برای نصب لازم نباشد.
این صفحه با 1in8b Engine API (توضیحات: https://1in8b.life/en/api/) زندگی‌های شبیه‌سازی‌شده در دو کشور را با هم مقایسه می‌کند.

1. بالای صفحه کادری باشد که کلید API من (با k8b_ شروع می‌شود) را در آن می‌چسبانم. فقط تا وقتی صفحه باز است از آن استفاده کن و هرگز آن را داخل فایل ننویس.
2. دو منوی انتخاب کشور باشد که از https://1in8b.life/api/v1/countries پر می‌شوند (بدون کلید): از iso3 هر مورد استفاده کن و نام کشورها را به فارسی نشان بده (فهرست name.en را می‌دهد و ترجمه‌اش با تو). یک کادر اختیاری هم برای سال تولد از 1950 تا 2025 باشد؛ اگر خالی بماند یعنی دنیای امروز.
3. دکمهٔ «مقایسه» باشد که برای هر کشور این نشانی را فراخوانی کند:
https://1in8b.life/api/v1/simulate?country=ISO3&n=15
(اگر سالی نوشته شده، &year=YYYY را اضافه کن) با سرآیند 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" پاسخ را نشان بده.
کلید رایگان من در هر فراخوانی 60 واحد زندگی و در ماه 2000 واحد اجازه می‌دهد. این مقایسه برای هر کشور 30 واحد مصرف می‌کند (60 واحد با سال تولد)؛ پس n را روی 15 نگه دار.

بعد امتحان کنید

از هوش مصنوعی بخواهید یک کشور را در دو سال مختلف مقایسه کند، مثلاً زندگی‌هایی که در 1960 آغاز شده‌اند با زندگی‌هایی که امروز آغاز می‌شوند.
برای دیدن یک زندگی به شکل داستان، از آن بخواهید از /api/v1/life?record=1 استفاده کند و ثبت را سال‌به‌سال نشان دهد. ثبت به انگلیسی می‌رسد؛ ترجمه‌اش را هم بخواهید.
هر بار فقط یک چیز را عوض کنید («نشان بده زندگی‌ها چگونه تمام می‌شوند، با نام‌های /api/v1/causes»، «نمودارها را واضح‌تر کن»): ساختن با هوش مصنوعی همین‌طور پیش می‌رود و زود به آن عادت می‌کنید.

امتحان رایگان

2000 واحد زندگی در ماه برای هر کلید. در دنیای امروز هر زندگی یک واحد است و در یک سال گذشته یا دنیای آینده دو واحد.
در هر فراخوانی: تا 5 زندگی یکی‌یکی (life) و تا 60 واحد برای مقایسه (simulate). و تا 30 فراخوانی در دقیقه.
با مقایسهٔ بالا می‌توانید ماهی حدود 33 بار امتحان کنید (با سال تولد حدود 16 بار). اگر بیشتر لازم دارید، به contact@1in8b.life بنویسید.
برای کار عام‌المنفعه و بدون کسب درآمد (پژوهش در دانشگاه یا مؤسسه، آموزش، سازمان‌های غیرانتفاعی و نهادهای عمومی، روزنامه‌نگاری) اندازهٔ طرح builder یک سال رایگان است. از نشانی‌ای که کلید به آن می‌رسد (یا خواهد رسید) به contact@1in8b.life بنویسید که چه کسی هستید و چه می‌سازید.

خلاصه برای توسعه‌دهندگان

آنچه برای فراخوانی از داخل کد لازم دارید. همهٔ پارامترها و فیلدها، با مثال، در راهنمای انگلیسی است.

`GET /api/v1/life`	زندگی یک نفر از تولد تا پایان (یا تا سنی که می‌خواهید متوقفش کنید): مدرسه، کار، خانواده، جابه‌جایی‌ها، چگونه تمام شد و اگر بخواهید عددهای هر سال و سابقه.
`GET /api/v1/simulate`	چشم‌اندازی از زندگی‌های زیاد با هم برای شرط‌هایی که انتخاب می‌کنید: طول عمر، بقا، علت‌های مرگ، تحصیل، کار و درآمد در 40 سالگی، خانواده، جابه‌جایی‌ها.
`GET /api/v1/person`	آدم‌هایی که همین حالا زنده‌اند: کسی در هر سنی، یا کسی که دنبالش می‌گردید (پرستاری در کره، مادربزرگی در پرو)، همراه با یک توکن تا از همان‌جا ادامه‌اش دهید.
`GET /api/v1/lineage`	نسل‌به‌نسلِ یک خانواده: زندگی یک نفر، سپس زندگی بزرگ‌ترین فرزندش که در همان زندگی بزرگ شد، در همان سال، کشور و وضعیتی که پدر یا مادر آن زمان داشت به دنیا می‌آید و با خانواده‌ای که آن زندگی به او داد (نام، خواهر و برادرها، سال‌هایی که پدر و مادر و پدربزرگ‌ها و مادربزرگ‌ها درگذشتند) زندگی می‌کند، تا ۲ تا ۵ نسل.
`POST /api/v1/live`	زندگی‌ای که از بیرون و گام‌به‌گام زندگی می‌شود: هر تصمیم را شما می‌گیرید و وضعیت زندگی در یک توکن مهروموم‌شده جابه‌جا می‌شود.
`GET /api/v1/countries, causes, jobs, groups`	بدون کلید: کد و نام کشورها، علت‌های مرگ، شغل‌ها و گروه‌هایی که در پاسخ‌ها می‌آیند. توصیف برای ابزارهای هوش مصنوعی در `/api/v1/openapi.json` است.

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

کلید را به شکل Authorization: Bearer k8b_… بفرستید. کلید را روی سرور خودتان نگه دارید: در یک صفحهٔ وب یا اپی که مردم دانلود می‌کنند هر کسی می‌تواند آن را بخواند.
پارامترهای پرکاربرد: country (کد سه‌حرفی ISO؛ اگر ننویسید بر پایهٔ سهم تولدها انتخاب می‌شود)، sex، year (1950–2025، دنیای گذشته) یا future=1 (دنیای آینده)، n (چند تا)، seed (seed و نسخهٔ موتور یکسان، زندگی‌های یکسان می‌دهد)، record=1 (سابقهٔ سال‌به‌سال، به انگلیسی).
با lang=ko (یا هر یک از ۱۸ زبان) سرگذشت و متن تصمیم‌ها به همان زبان می‌آید. /simulate در یک فراخوان تا ۴ کشور (country=KOR,NGA) و ۶ سال تولد (years=1960,today,future) را کنار هم مقایسه می‌کند. هر زندگی می‌گوید جهان چه چیزهایی برایش آورد (met: جنگ، بلایا، قطعی برق، نخستین برق یا تلویزیون خانه)، همراه با سن و سال.
مصرف با واحد زندگی شمرده می‌شود: یک زندگی در دنیای امروز یک واحد است و در یک سال گذشته یا دنیای آینده دو واحد. usage در هر پاسخ مصرف این ماه را نشان می‌دهد.
خطاها هم JSON هستند: error (چه شد)، code (برای برنامه‌ها)، status. 400: پارامتری که موتور نمی‌پذیرد یا شرطی که در جهان وجود ندارد، 401: کلید نیست یا ناشناخته است، 429: فراخوانی‌های زیاد (rate) یا تمام شدن واحدهای ماه (month؛ more می‌گوید بیشترش از کجا می‌آید و resets روزی که ماه دوباره شروع می‌شود).
مسیرها و فیلدهای v1 هرگز حذف یا تغییر نام نمی‌دهند. وقتی meta.engine عوض شود، همان seed ممکن است زندگی دیگری بدهد: برای بازتولید یک نتیجه، نسخهٔ موتور و تاریخ را نگه دارید.

چیزهایی که باید بدانید

زندگی‌های این API شبیه‌سازی‌هایی بر پایهٔ آمار واقعی‌اند، نه جهان واقعی و نه آدم‌های واقعی. سنگین‌ترین سطرها (خودکشی و چند مورد دیگر) فقط وقتی می‌آیند که خودتان بخواهید.
ما می‌بینیم هر کلید چگونه به کار می‌رود، و کلیدی که برخلاف شرایط به کار رود ممکن است خاموش شود.
هنگام نشان دادن نتیجه‌ها، منبع «1in8b Engine (1in8b.life)» را بیاورید.
کلید فقط مال شماست: به کسی ندهید و منتشرش نکنید. اگر گمش کردید، از همان نشانی دوباره برایمان بنویسید تا کلید تازه‌ای بگیرید.
از نتیجه‌ها برای تصمیم‌گیری دربارهٔ آدم‌های واقعی (سلامت، بیمه، وام، کار و مانند آن) استفاده نکنید.
توضیح فنی و متن کامل شرایط استفاده در صفحهٔ انگلیسی است و شرایط معتبر همان‌هاست.

برای پژوهش یا آموزش: روش و اعتبارسنجی (منابع، شیوهٔ تطبیق با داده‌ها، فاصله با واقعیت، محدودیت‌ها، شیوهٔ ارجاع) و نسخه‌های پژوهشی که یک سال ثابت می‌مانند (engine)، به انگلیسی.