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
Hãy gửi yêu cầu đến endpoint này để kiểm tra trạng thái của tác vụ tạo World Labs Marble. Nếu phản hồi tạo tác vụ có bao gồm poll_url, hãy ưu tiên gọi chính xác URL đó.
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 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 (operation IDs), tài nguyên thế giới (world assets), chú thích (captions), chi phí và chuỗi error 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.
ID tác vụ công khai.
Bí danh định danh tác vụ bất đồng bộ.
ID vận hành của World Labs.
Trạng thái tác vụ: pending, processing, completed, failed, hoặc timeout.
ID thế giới của World Labs khi hoàn thành.
URL của thế giới Marble được tạo khi hoàn thành.
Bí danh cho URL thế giới/mô hình chính được tạo.
URL của tệp GLB lưới va chạm (collider mesh) khi có sẵn.
URL của hình ảnh toàn cảnh (panorama) khi có sẵn.
URL của hình ảnh thu nhỏ (thumbnail) khi có sẵn.
Chú thích cho thế giới được tạo.
Chi tiết chi phí tạo khi có sẵn, bao gồm total_credits. Hãy kiểm tra hồ sơ sử dụng của bạn để biết số tiền đã thanh toán.
Thông báo lỗi khi tác vụ thất bại.
Yêu cầu
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/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", "cost": {}, "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" } }}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