poll_url。
支持的模型为 marble-1.0、marble-1.1 和 marble-1.1-plus。World Labs 文档中还包含 marble-1.0-draft,但 AI Sonar 目前尚未在此端点开放 draft 生成。
请求体
string
默认值:"marble-1.0"
要使用的 Marble 模型:
marble-1.0、marble-1.1 或 marble-1.1-plus。string
用于纯文本生成的文本提示词,也可作为图片或视频输入时的引导。
object
面向高级调用方的原生 World Labs
world_prompt 对象。支持的提示类型包括 text、image、multi-image 和 video。string
Base64 或 data URL 图片提示。
string
图片 URL 提示。
array
用于快捷多图生成的多个图片提示。最多提供 4 张图片。若使用原生 World Labs 重建模式,请传入
world_prompt.type="multi-image"、reconstruct_images: true,并最多提供 8 张图片。string
视频 URL 提示。
boolean | string
对于图片输入,设置为
true 表示已有全景图,false 表示普通单图,或使用 auto。integer
可选随机种子,范围为 0 到 4294967295。
string
可选的生成世界显示名称,最多 64 个字符。
array
可选的 World Labs 标签。最多提供 10 个标签,每个标签最多 32 个字符。
object
可选的 World Labs 权限对象。
响应
string
用于轮询的公开任务 ID。
string
异步任务标识别名。
string
World Labs 操作 ID。
string
该任务的推荐轮询 URL。
string
任务状态:
pending、processing、completed 或 failed。string
生成完成后返回的 Marble 世界 URL。
string
可用时返回的碰撞网格 GLB URL。
string
可用时返回的全景图 URL。
计费
World Labs 按 credits 计费。AI Sonar 会先按请求类型的最大值预扣,并在完成的 operation 返回cost.total_credits 时按实际 credits 结算。标准 Marble 请求最多 1,600 credits。marble-1.1-plus 请求最多 3,100 credits。
范围
这些管理端点覆盖 AI Sonar 归属的媒体资产和已完成生成的 worlds。AI Sonar 仍不开放marble-1.0-draft 生成或独立 pano/depth 工具。