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} 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)
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.
ID tác vụ công khai.
Bí danh định danh tác vụ bất đồng bộ.
ID vận hành World Labs.
Trạng thái tác vụ: pending, processing, completed, failed, hoặc timeout.
ID thế giới World Labs khi hoàn tất.
URL cho thế giới Marble được tạo khi hoàn tất.
Bí danh cho URL thế giới/mô hình chính được tạo.
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.
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.
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.
Chú thích cho thế giới được tạo.
Thông báo lỗi khi tác vụ thất bại.
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.
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 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 tác vụ tạo thế giới.
Phản hồi
application/json
application/json
application/json