跳转到主要内容
使用 World Labs Marble 生成可探索的 3D 世界。这是一个异步 API：创建响应会返回任务标识以及用于查询状态的 poll_url。 支持的模型为 marble-1.0、marble-1.1 和 marble-1.1-plus。World Labs 文档中还包含 marble-1.0-draft，但 TokenLab 目前尚未在此端点开放 draft 生成。

​
请求体

​
model
string
默认值:"marble-1.0"
要使用的 Marble 模型：marble-1.0、marble-1.1 或 marble-1.1-plus。
​
prompt
string
用于纯文本生成的文本提示词，也可作为图片或视频输入时的引导。
​
world_prompt
object
面向高级调用方的原生 World Labs world_prompt 对象。支持的提示类型包括 text、image、multi-image 和 video。
​
image
string
Base64 或 data URL 图片提示。
​
image_url
string
图片 URL 提示。
​
images
array
用于快捷多图生成的多个图片提示。最多提供 4 张图片。若使用原生 World Labs 重建模式，请传入 world_prompt.type="multi-image"、reconstruct_images: true，并最多提供 8 张图片。
​
video_url
string
视频 URL 提示。
​
is_pano
boolean | string
对于图片输入，设置为 true 表示已有全景图，false 表示普通单图，或使用 auto。
​
seed
integer
可选随机种子，范围为 0 到 4294967295。
​
display_name
string
可选的上游世界显示名称，最多 64 个字符。
​
tags
array
可选的上游标签。最多提供 10 个标签，每个标签最多 32 个字符。
​
permission
object
可选的 World Labs 权限对象。

​
响应

​
id
string
用于轮询的公开任务 ID。
​
task_id
string
异步任务标识别名。
​
operation_id
string
上游 World Labs operation ID。
​
poll_url
string
该任务的推荐轮询 URL。
​
status
string
任务状态：pending、processing、completed 或 failed。
​
world_marble_url
string
生成完成后返回的 Marble 世界 URL。
​
glb_url
string
可用时返回的碰撞网格 GLB URL。
​
pano_url
string
可用时返回的全景图 URL。

​
计费

World Labs 按 credits 计费。TokenLab 会先按请求类型的最大值预扣，并在完成的 operation 返回 cost.total_credits 时按实际 credits 结算。标准 Marble 请求最多 1,600 credits。marble-1.1-plus 请求最多 3,100 credits。

​
范围

这些管理端点覆盖 TokenLab 归属的媒体资产和已完成生成的 worlds。TokenLab 仍不开放 marble-1.0-draft 生成或独立 pano/depth 工具。 
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": "夕阳下安静的海边小镇，有狭窄小巷和温暖灯光"
  }'