Worlds - TokenLab

World 生成会异步创建可探索的 Marble World。当输出是用户可以打开或再次访问的环境时使用 Worlds；如果需要可下载的单独模型资产，请使用 3D 生成。

输入与媒体资产

World 任务可根据所选模型和请求形态从文本、图片、多图或视频开始。可复用的媒体提示应先准备媒体资产，再在 World 请求中引用。媒体资产和完成后的 World 只对你的账户可用。

创建与轮询

创建响应包含公共任务 ID，通常也包含 poll_url。展示进度前先保存这个 ID，然后跟随 poll_url 或 GET /v1/tasks/，直到任务 completed 或 failed。

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": "A quiet coastal town at sunset with narrow alleys and warm lights"
  }'

管理已完成的 Worlds

Worlds 列表和详情端点用于查看当前账户里已完成的 World。待处理或失败的生成任务请使用任务状态端点。只有用户明确删除产品里的生成 World 时才调用删除。

常见问题

不要假设每个 World 模型都支持所有输入类型。
签名图片或视频 URL 要保持足够长的有效期，覆盖服务端拉取重试。
超时后重试前，先保存并查询已返回的任务 ID。
需要可下载模型文件时使用 3D 生成，而不是 Worlds。

API 参考

主题	参考
创建 World	创建 World
获取 World 状态	获取 World 状态
准备媒体资产上传	准备媒体资产上传
获取媒体资产	获取媒体资产
列出 Worlds	列出 Worlds
获取 World	获取 World
删除 World	删除 World
异步任务	异步任务
3D 生成指南	3D 生成指南

​输入与媒体资产

​创建与轮询

​管理已完成的 Worlds

​常见问题

​API 参考

输入与媒体资产

创建与轮询

管理已完成的 Worlds

常见问题

API 参考