TokenLab

Worlds

Lấy Trạng thái Thế giới

Truy xuất trạng thái và kết quả của tác vụ tạo thế giới World Labs Marble

GET
/v1/worlds/generations/{id}

GET /v1/worlds/generations/{id} là một endpoint tương thích. Nó vẫn được hỗ trợ cho các tích hợp hiện có. Các tích hợp mới nên thực hiện poll GET /v1/tasks/{id} với cùng một id tác vụ; xem Lấy Trạng thái Tác vụ.

Endpoint này trả về trạng thái của một tác vụ tạo World Labs Marble. Sử dụng id tác vụ từ phản hồi tạo tác vụ.

Một tác vụ công khai đã hết hạn hoặc không khả dụng có thể trả về 404 async_task_not_found. Nếu không thể xác định quyền sở hữu tác vụ cho API key hiện tại, phản hồi sẽ là 403 task_not_owned.

Tham số Đường dẫn (Path Parameters)

idstringpathbắt buộc

ID của tác vụ tạo thế giới.

Phản hồi (Response)

Chỉ id và status là bắt buộc trong một phản hồi trạng thái thành công. Các bí danh tác vụ (task aliases), ID vận hành, tài nguyên thế giới và chú thích sẽ được trả về khi có sẵn. Một tác vụ đã hoàn thành không đảm bảo rằng mọi URL tài nguyên đều có mặt. Một tác vụ thất bại vẫn trả về HTTP 200: hãy đọc status, error và error_details.

world_marble_url mở trình xem World Labs tương tác. Các tệp kết quả như glb_url, pano_url và thumbnail_url là các liên kết TokenLab; chúng sẽ trống hoặc không có cho đến khi tác vụ hoàn tất.

idstring

ID tác vụ công khai.

task_idstring

Bí danh định danh tác vụ bất đồng bộ.

operation_idstring

ID vận hành World Labs.

statusstring

Trạng thái tác vụ: pending, processing, completed, failed, hoặc timeout.

world_idstring

ID thế giới World Labs khi hoàn tất.

world_marble_urlstring

URL cho thế giới Marble được tạo khi hoàn tất.

model_urlstring

Bí danh cho URL thế giới/mô hình chính được tạo.

glb_urlstring

URL GLB của lưới va chạm (collider mesh) khi có sẵn. Một liên kết kết quả phương tiện TokenLab có hiệu lực trong 30 ngày.

pano_urlstring

URL hình ảnh toàn cảnh khi có sẵn. Một liên kết kết quả phương tiện TokenLab có hiệu lực trong 30 ngày.

thumbnail_urlstring

URL hình ảnh thu nhỏ khi có sẵn. Một liên kết kết quả phương tiện TokenLab có hiệu lực trong 30 ngày.

captionstring

Chú thích cho thế giới được tạo.

errorstring | object

Thông báo lỗi khi tác vụ thất bại.

error_detailsobject

Chi tiết lỗi khi tác vụ thất bại: status, message, type, code, retryable và param khi một trường yêu cầu bị lỗi.

media_retentionobject

Trạng thái lưu trữ của các liên kết kết quả phương tiện TokenLab trong phản hồi hoàn tất: days và items[] với url, kind, status và expires_at. Nó có thể không xuất hiện; các liên kết vẫn hoạt động. Xem Lưu giữ dữ liệu.

Yêu cầu

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"      }    ]  }}

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

id*string

ID tác vụ tạo thế giới.

Phản hồi

application/json

application/json

application/json