poll_url。
支援的模型為 marble-1.0、marble-1.1 與 marble-1.1-plus。World Labs 文件中也列出 marble-1.0-draft,但 TokenLab 目前尚未在此端點開放 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 計費。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 工具。