TokenLab

Worlds

取得世界狀態

檢索 World Labs Marble 世界生成任務的狀態與結果

GET
/v1/worlds/generations/{id}

GET /v1/worlds/generations/{id} 為相容性端點。它仍支援現有的整合。新的整合應輪詢 GET /v1/tasks/{id} 並使用相同的任務 id;請參閱 取得任務狀態。

此端點會回傳 World Labs Marble 生成任務的狀態。請使用建立回應中的任務 id。

已過期或無法存取的公開任務可能會回傳 404 async_task_not_found。如果無法為目前的 API key 建立任務所有權,回應將為 403 task_not_owned。

路徑參數 (Path Parameters)

idstringpath必填

世界生成任務 ID。

回應 (Response)

在成功的狀態回應中,僅 id 和 status 為必要欄位。任務別名、操作 ID、世界資產與說明文字將在可用時回傳。已完成的任務不保證會包含所有資產 URL。失敗的任務仍會回傳 HTTP 200:請讀取 status、error 與 error_details。

world_marble_url 會開啟互動式 World Labs 檢視器。結果檔案(如 glb_url、pano_url 與 thumbnail_url)均為 TokenLab 連結;在任務完成前,這些連結將為空或不存在。

idstring

公開任務 ID。

task_idstring

非同步任務識別碼別名。

operation_idstring

World Labs 操作 ID。

statusstring

任務狀態:pending、processing、completed、failed 或 timeout。

world_idstring

任務完成時的 World Labs 世界 ID。

world_marble_urlstring

任務完成時生成的 Marble 世界 URL。

model_urlstring

主要生成世界/模型 URL 的別名。

glb_urlstring

碰撞網格 (Collider mesh) GLB URL(若可用)。這是一個有效期為 30 天的 TokenLab 媒體結果連結。

pano_urlstring

全景影像 URL(若可用)。這是一個有效期為 30 天的 TokenLab 媒體結果連結。

thumbnail_urlstring

縮圖影像 URL(若可用)。這是一個有效期為 30 天的 TokenLab 媒體結果連結。

captionstring

生成世界的說明文字。

errorstring | object

任務失敗時的錯誤訊息。

error_detailsobject

任務失敗時的詳細資訊:包含 status、message、type、code、retryable,以及當請求欄位出錯時的 param。

media_retentionobject

已完成回應中 TokenLab 媒體結果連結的儲存狀態:包含 days 以及包含 url、kind、status 與 expires_at 的 items[]。此欄位可能不存在;連結仍可正常運作。請參閱 資料保留。

請求

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "world_id": "string",  "world_marble_url": "string",  "model_url": "string",  "glb_url": "string",  "pano_url": "string",  "thumbnail_url": "string",  "caption": "string",  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  },  "media_retention": {    "days": 0,    "items": [      {        "url": "http://example.com",        "kind": "image",        "content_type": "string",        "status": "saving",        "expires_at": "2019-08-24T14:15:22Z"      }    ]  }}

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

id*string

世界生成任務 ID。

回應

application/json

application/json

application/json