TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

3D

Lấy trạng thái mô hình 3D

Truy xuất trạng thái và kết quả của tác vụ tạo mô hình 3D

GET
/v1/tasks/{id}

Thực hiện poll endpoint này để kiểm tra trạng thái của tác vụ tạo mô hình 3D của bạn.

Nếu phản hồi tạo bao gồm poll_url, hãy ưu tiên chính URL đó khi polling. id và task_id nên được coi là cùng một định danh của tác vụ bất đồng bộ.

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

Tham số đường dẫn

idstringpathbắt buộc

ID của tác vụ tạo mô hình 3D.

Phản hồi

Các trường kết quả, lỗi, thời gian và model được trả về khi tác vụ cung cấp chúng.

idstring

ID tác vụ.

task_idstring

Bí danh của mã tác vụ bất đồng bộ khi có sẵn.

poll_urlstring

URL polling ưu tiên khi có sẵn.

statusstring

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

progressinteger

Giá trị tiến độ tùy chọn. Chỉ được trả về khi có giá trị tiến độ thực; hãy dùng status để xác định khi tác vụ hoàn tất.

model_urlstring

URL để tải xuống tệp mô hình 3D (khi hoàn tất).

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).

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://cdn.tripo3d.ai/abc123.glb",
  "glb_url": "https://cdn.tripo3d.ai/abc123.glb",
  "fbx_url": "https://cdn.tripo3d.ai/abc123.fbx"
}

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

Tạo Mô hình 3D

Trước

Lấy Trạng thái Tác vụ

Tiếp