Chuyển đến nội dung chính
Tạo thế giới 3D có thể khám phá bằng World Labs Marble. Đây là API bất đồng bộ: phản hồi tạo trả về định danh tác vụ và poll_url để kiểm tra trạng thái. Các model được hỗ trợ là marble-1.0, marble-1.1 và marble-1.1-plus. World Labs có tài liệu cho marble-1.0-draft, nhưng TokenLab hiện chưa mở draft generation trong endpoint này.

​
Nội dung yêu cầu

​
model
string
mặc định:"marble-1.0"
Model Marble cần dùng: marble-1.0, marble-1.1 hoặc marble-1.1-plus.
​
prompt
string
Prompt văn bản cho sinh từ text-only hoặc làm hướng dẫn khi có đầu vào ảnh/video.
​
world_prompt
object
Đối tượng World Labs native world_prompt cho caller nâng cao. Các loại prompt được hỗ trợ là text, image, multi-image và video.
​
image
string
Prompt ảnh dạng Base64 hoặc data URL.
​
image_url
string
Prompt URL ảnh.
​
images
array
Nhiều prompt ảnh cho shortcut multi-image generation. Cung cấp tối đa 4 ảnh. Với chế độ reconstruction native của World Labs, truyền world_prompt.type="multi-image" cùng reconstruct_images: true và tối đa 8 ảnh.
​
video_url
string
Prompt URL video.
​
is_pano
boolean | string
Với đầu vào ảnh, đặt true cho panorama có sẵn, false cho ảnh đơn thông thường, hoặc auto.
​
seed
integer
Seed tùy chọn từ 0 đến 4294967295.
​
display_name
string
Tên hiển thị tùy chọn cho world upstream, tối đa 64 ký tự.
​
tags
array
Tag upstream tùy chọn. Tối đa 10 tag, mỗi tag tối đa 32 ký tự.
​
permission
object
Đối tượng permission World Labs tùy chọn.

​
Phản hồi

​
id
string
ID tác vụ công khai để polling.
​
task_id
string
Alias của định danh tác vụ bất đồng bộ.
​
operation_id
string
ID operation upstream của World Labs.
​
poll_url
string
URL polling được khuyến nghị cho tác vụ này.
​
status
string
Trạng thái tác vụ: pending, processing, completed hoặc failed.
​
world_marble_url
string
URL world Marble đã sinh khi hoàn tất.
​
glb_url
string
URL GLB của collider mesh nếu có.
​
pano_url
string
URL ảnh panorama nếu có.

​
Giá

World Labs tính phí bằng credits. TokenLab trừ trước mức tối đa theo loại request và quyết toán theo cost.total_credits của operation đã hoàn tất khi có. Request Marble tiêu chuẩn tối đa 1.600 credits. marble-1.1-plus tối đa 3.100 credits.

​
Phạm vi

Các endpoint quản lý này bao phủ media asset thuộc TokenLab và world đã tạo xong. TokenLab vẫn chưa mở tạo marble-1.0-draft hoặc công cụ pano/depth độc lập. 
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "marble-1.1",
    "prompt": "Một thị trấn ven biển yên tĩnh lúc hoàng hôn với ngõ hẹp và ánh đèn ấm"
  }'