3D
Lấy trạng thái mô hình 3D
Truy xuất trạng thái và kết quả của một tác vụ tạo mô hình 3D
GET /v1/3d/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}; xem Lấy trạng thái tác vụ.
Gọi GET /v1/tasks/{id} để kiểm tra trạng thái tác vụ tạo mô hình 3D của bạn.
id và task_id định danh cùng một 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 3D.
Phản hồi (Response)
Các trường mô tả kết quả, lỗi, dấu thời gian và mô hình sẽ được trả về khi có sẵn cho tác vụ đó.
ID của tác vụ.
Bí danh định danh tác vụ bất đồng bộ khi được cung cấp.
URL trạng thái cho tác vụ này. Thực hiện poll GET /v1/tasks/{id} với id.
Trạng thái tác vụ: pending, processing, completed, failed, hoặc timeout. Một tác vụ thất bại vẫn trả về HTTP 200.
Giá trị tiến độ tùy chọn. Chỉ được trả về khi có giá trị tiến độ thực tế; hãy sử dụng status để xác định trạng thái hoàn thành.
URL để tải xuống tệp mô hình 3D (khi đã hoàn thành). Một liên kết media-result của TokenLab có hiệu lực trong 30 ngày.
URL để tải xuống mô hình định dạng GLB (khi có sẵn).
URL để tải xuống mô hình định dạng FBX (khi có sẵn).
Thông báo lỗi (khi 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 gặp lỗi.
Trạng thái lưu trữ của các liên kết kết quả: days và items[] với url, kind, status, và expires_at. Trường này có thể không xuất hiện; các liên kết vẫn hoạt động. Xem Lưu trữ dữ liệu.
Yêu cầu
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Phản hồi
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"kind": "3d",
"content_type": "model/gltf-binary",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
},
{
"url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"kind": "3d",
"content_type": "application/octet-stream",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}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ụ async được trả về bởi id / task_id, hoặc được nhúng trong poll_url
Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json
application/json