1in8b Engine · mô phỏng cuộc đời đứng sau 1 trong 8 tỷ

1in8b Engine API beta

Ở 1 trong 8 tỷ, bạn trở thành một trong những em bé đang chào đời lúc này và sống trọn một cuộc đời duy nhất. Bạn không chọn được nơi mình sinh ra. 1in8b Engine API cho bạn mượn bộ máy đứng sau đó: đặt điều kiện như quốc gia hay năm sinh, chạy nhiều cuộc đời cùng lúc và so sánh bằng số liệu xem các cuộc đời khác nhau thế nào. Không biết lập trình cũng không sao: nhờ AI, bạn sẽ có trang thử nghiệm của riêng mình.

Đã có khóa? Dùng thử ngay. Trang Dùng thử 1in8b Engine gọi engine chỉ bằng nút bấm, không cần lập trình. Bấm đường liên kết trong thư gửi khóa, trang sẽ mở với khóa đã điền sẵn.

Dành cho doanh nghiệp và tổ chức

Công ty, trường học, tòa soạn và tổ chức cũng có thể dùng 1in8b Engine trong nội dung và dịch vụ của mình, kể cả để kinh doanh, chỉ cần ghi nguồn "1in8b Engine (1in8b.life)".

• Nội dung giáo dục: trong giáo trình và ứng dụng học tập, tự sống thử "nếu mình sinh ra ở nước khác"
• Bài báo và báo cáo: bài báo tương tác nơi người đọc tự sinh ra, đồ họa đặt các nước và các thời đại cạnh nhau
• Chiến dịch và triển lãm: trang chiến dịch của công ty hay tổ chức, ki-ốt ở bảo tàng và nơi triển lãm
• Nhân vật trong câu chuyện: lý lịch của những người trong tiểu thuyết, phim và thế giới ảo
• Đào tạo về đa dạng: trong đào tạo nhân viên, sống từng năm ở một nước khác và tự chọn trên đường đi
• Ứng dụng AI: nối ứng dụng AI qua MCP để gọi các cuộc đời ngay trong cuộc trò chuyện

Dùng được lâu dài: v1 không bỏ địa chỉ hay trường nào. Mỗi nửa năm có một bản nghiên cứu đóng băng engine, nên có thể chạy lại cùng một kết quả. Trong câu trả lời không có người thật, và mỗi lần gọi chỉ cần khóa.

Không được: dùng để quyết định về người thật (tuyển dụng, bảo hiểm, cho vay…), đưa mô phỏng ra như dự báo, thống kê chính thức hay dữ liệu thị trường, dùng câu trả lời để huấn luyện mô hình AI, bán lại API hay dùng chung khóa. Chi tiết có trong điều khoản.

Lượng dùng và giá: hãy thử trước bằng khóa miễn phí, khi dùng nhiều thì chuyển sang gói trả phí. Nghiên cứu, giảng dạy, phi lợi nhuận và báo chí không nhằm kiếm tiền thì đăng ký là miễn phí. Khi dùng nhiều hơn gói lớn nhất, hoặc dùng nhiều trong một khoảng thời gian nhất định, hãy viết cho contact@1in8b.life.

Dùng trong dự án

• NPC và thế giới ảo: những người đang sống hôm nay (/person) làm cư dân của bạn, kèm công việc, gia đình và lịch sử họ đã trải qua; một lần gọi /live đưa 10 người sang năm mới.
• Ứng dụng và truyện tương tác: /live gửi từng quyết định kèm xác suất mà thế giới đưa ra. Bạn vẽ màn hình, người đó tự chọn.
• Đánh giá AI và nghiên cứu: thử AI với những người được chọn theo tỷ lệ nơi con người sinh sống, hoặc so sánh các cuộc đời theo từng điều kiện. Hãy ghi rõ kết quả đến từ mô phỏng.
• Lớp học và lịch sử: sinh ra vào bất kỳ năm nào từ 1950; mỗi năm mang theo đất nước khi ấy và lịch sử đã chạm đến con người.
• Mọi lệnh gọi và điều kiện có trong tài liệu tiếng Anh; công cụ AI có thể đọc /api/v1/openapi.json.

Dùng cùng AI, không cần lập trình

1. Nhận khóa: gửi một email bất kỳ tới api@1in8b.life, khóa miễn phí sẽ được trả lời ngay. Khóa bắt đầu bằng k8b_.
2. Nhờ AI: sao chép nguyên đoạn bên dưới và dán vào cuộc trò chuyện với AI mà bạn dùng. Đừng đưa khóa cho AI.
3. Mở tệp: tải tệp HTML mà AI làm cho bạn về và mở bằng trình duyệt. Phần xem trước trong khung trò chuyện có thể chặn kết nối.
4. Thử nghiệm: dán khóa vào ô trên cùng của trang, chọn hai quốc gia rồi so sánh. Nếu có lỗi, hãy dán nguyên thông báo trên màn hình cho AI, nó sẽ sửa giúp bạn.

Đoạn để sao chép và dán

Hãy làm cho tôi một tệp HTML mở được ngay bằng trình duyệt: HTML, CSS và JavaScript đều nằm trong một tệp đó, không cần cài đặt gì.
Trang này dùng 1in8b Engine API (tài liệu: https://1in8b.life/en/api/) để so sánh những cuộc đời được mô phỏng ở hai quốc gia.

1. Trên cùng có một ô để tôi dán khóa API (bắt đầu bằng k8b_). Chỉ dùng khóa khi trang đang mở; đừng ghi khóa vào tệp.
2. Hai menu chọn quốc gia, danh sách lấy từ https://1in8b.life/api/v1/countries (không cần khóa): dùng iso3 của từng mục và hiển thị name.vi. Thêm một ô năm sinh (1950–2025; để trống là thế giới hôm nay).
3. Nút "So sánh": với mỗi quốc gia, gọi
   https://1in8b.life/api/v1/simulate?country=ISO3&n=15
   (nếu có năm sinh thì thêm &year=năm) với header Authorization: Bearer <khóa>
4. Câu trả lời có "female" và "male", mỗi phần có age_at_death.mean (tuổi thọ trung bình), survival["65"] (tỉ lệ sống đến 65 tuổi), children_by_46 (số con trung bình đến 46 tuổi), at_40.working (tỉ lệ đang đi làm ở tuổi 40) và at_40.education (tỉ lệ theo trình độ học vấn ở tuổi 40). Tỉ lệ là số từ 0 đến 1. Hãy đặt hai quốc gia cạnh nhau, trình bày bằng câu dễ hiểu và biểu đồ cột đơn giản, bằng tiếng Việt.
5. Dưới kết quả ghi: "Đây là những cuộc đời do 1in8b Engine (1in8b.life) mô phỏng, không phải người thật. Mỗi giới chỉ 15 người nên các con số chỉ là ước chừng."
6. Nếu gọi thất bại, hiển thị dòng "error" trong câu trả lời.
Khóa miễn phí của tôi cho phép 60 đơn vị cuộc đời mỗi lần gọi và 2000 mỗi tháng. Phép so sánh này dùng 30 đơn vị mỗi quốc gia (60 nếu có năm sinh), nên hãy giữ n là 15.

Thử thêm

• Nhờ AI đổi thành so sánh cùng một quốc gia ở hai năm, ví dụ những cuộc đời sinh năm 1960 và sinh hôm nay.
• Muốn xem một cuộc đời như một câu chuyện, hãy nhờ nó dùng /api/v1/life?record=1. Bản ghi bằng tiếng Anh, nên nhờ dịch luôn.
• Sửa từng điều một (“hiện cả cách cuộc đời khép lại, tên lấy từ /api/v1/causes”, “làm biểu đồ rõ hơn”): đó là cách làm việc cùng AI, bạn sẽ quen rất nhanh.

Dùng thử miễn phí

• Mỗi khóa có 2000 đơn vị cuộc đời mỗi tháng. Ở thế giới hôm nay, một cuộc đời là 1 đơn vị; ở một năm trong quá khứ hoặc thế giới tương lai là 2.
• Mỗi lần gọi: xem từng cuộc đời (life) tối đa 5, so sánh (simulate) tối đa 60 đơn vị. Tối đa 30 lần mỗi phút.
• Với phép so sánh ở trên, bạn thử được khoảng 33 lần mỗi tháng (khoảng 16 lần nếu có năm sinh). Nếu cần dùng nhiều hơn, hãy viết cho contact@1in8b.life.
• Nếu dùng cho mục đích công cộng mà không kiếm tiền, như nghiên cứu (đại học, viện), giảng dạy, tổ chức phi lợi nhuận và cơ quan công, báo chí, bạn được dùng miễn phí cỡ gói builder trong một năm. Hãy viết cho contact@1in8b.life từ địa chỉ nhận (hoặc sẽ nhận) khóa, cho biết bạn là ai và bạn làm gì.

Tóm tắt cho nhà phát triển

Chỉ gồm những điều cần biết khi gọi trực tiếp từ mã. Mọi tham số, trường và ví dụ đều có trong tài liệu tiếng Anh.

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

• Gửi khóa trong header Authorization: Bearer k8b_…. Hãy giữ khóa trên máy chủ của bạn: nếu để trong trang web hay ứng dụng người ta tải về, ai cũng đọc được.
• Các tham số thường dùng: country (mã ISO ba chữ cái; bỏ trống thì chọn theo tỉ lệ sinh), sex, year (1950–2025, thế giới quá khứ) hoặc future=1 (thế giới tương lai), n (bao nhiêu người), seed (cùng seed và cùng phiên bản bộ máy thì ra cùng những cuộc đời), record=1 (bản ghi từng năm, bằng tiếng Anh).
• Thêm lang=ko (hoặc một trong 18 ngôn ngữ) thì phần ghi chép và các câu lựa chọn sẽ đến bằng ngôn ngữ đó. /simulate so sánh cùng lúc tối đa 4 quốc gia (country=KOR,NGA) và 6 năm sinh (years=1960,today,future). Mỗi cuộc đời cho biết những gì đã trải qua (met: chiến tranh, thiên tai, mất điện, lần đầu nhà có điện hay TV), kèm tuổi và năm.
• Mức dùng được tính bằng đơn vị cuộc đời: một cuộc đời ở thế giới hôm nay là 1 đơn vị, ở một năm trong quá khứ hoặc thế giới tương lai là 2. Trường usage trong mỗi câu trả lời cho biết mức dùng của tháng.
• Lỗi cũng ở dạng JSON: error (chuyện gì đã xảy ra), code (dành cho chương trình), status. 400 là tham số bộ máy không nhận hoặc điều kiện thế giới không có, 401 là thiếu khóa hoặc khóa không được biết, 429 là gọi quá nhiều (rate) hoặc đã dùng hết đơn vị của tháng (month, kèm more cho biết lấy thêm ở đâu và resets là ngày tháng mới bắt đầu lại).
• Đường dẫn và trường của v1 sẽ không bị xóa hay đổi tên. Khi meta.engine đổi, cùng một seed có thể cho ra cuộc đời khác: muốn tái hiện kết quả, hãy giữ lại phiên bản bộ máy và ngày.

Điều cần biết

• Các cuộc đời của API được mô phỏng theo số liệu thật, không phải thế giới thật hay người thật. Những dòng nặng nề nhất (tự tử và vài chuyện khác) chỉ xuất hiện khi bạn yêu cầu.
• Chúng tôi theo dõi cách mỗi khóa được dùng, và khóa bị dùng trái điều khoản có thể bị tắt.
• Khi trình bày kết quả, hãy ghi nguồn “1in8b Engine (1in8b.life)”.
• Khóa chỉ dành riêng cho bạn. Đừng đưa cho người khác hay đăng ở nơi công khai. Nếu làm mất, hãy gửi lại email từ cùng địa chỉ để nhận khóa mới.
• Đừng dùng kết quả để đưa ra quyết định về một người thật (sức khỏe, bảo hiểm, vay vốn, việc làm…).
• Phần giải thích kỹ thuật và toàn văn điều khoản sử dụng nằm ở trang tiếng Anh, và các điều khoản đó được áp dụng.

Nếu dùng cho nghiên cứu hay giảng dạy: Phương pháp và kiểm chứng (nguồn, cách khớp với dữ liệu, độ chênh với thực tế, giới hạn, cách trích dẫn) và các bản cố định cho nghiên cứu giữ nguyên trong một năm (engine), bằng tiếng Anh.