TokenLab

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/tasks/{id}

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)

idstringpathbắt buộc

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ụ đó.

idstring

ID của tác vụ.

task_idstring

Bí danh định danh tác vụ bất đồng bộ khi được cung cấp.

poll_urlstring

URL trạng thái cho tác vụ này. Thực hiện poll GET /v1/tasks/{id} với id.

statusstring

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.

progressinteger

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.

model_urlstring

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.

glb_urlstring

URL để tải xuống mô hình định dạng GLB (khi có sẵn).

fbx_urlstring

URL để tải xuống mô hình định dạng FBX (khi có sẵn).

errorstring | object

Thông báo lỗi (khi 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 gặp lỗi.

media_retentionobject

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

Response (Completed)
{
  "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
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ụ 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