Công Việc Không Đồng Bộ & Kiểm Tra

Nhiều điểm cuối truyền thông là không đồng bộ. Một yêu cầu tạo bắt đầu công việc và trả về một danh tính công việc TokenLab công khai; ứng dụng của bạn sẽ kiểm tra cho đến khi công việc đó đạt trạng thái cuối cùng. Không xây dựng quy trình làm việc của khách hàng xung quanh các URL công việc upstream, ID định tuyến, hoặc hành vi callback của nhà cung cấp.

Hợp Đồng Công Việc Công KhaiCopy Anchor Link

Các phản hồi tạo có thể bao gồm:

/v1/tasks/{id} là điểm cuối trạng thái cố định chuẩn cho các công việc truyền thông không đồng bộ công khai. Các tuyến trạng thái cụ thể cho truyền thông có thể tồn tại để tương thích, nhưng các tích hợp mới nên ưu tiên poll_url hoặc /v1/tasks/{id}.

Quy Trình Được Khuyến NghịCopy Anchor Link

1. Xác thực yêu cầu của người dùng và gửi cuộc gọi tạo với một model rõ ràng.
2. Lưu trữ id / task_id, poll_url, điểm cuối, mô hình, ID người dùng, và ID công việc của bạn trước khi trả lại quyền kiểm soát cho UI.
3. Kiểm tra mỗi 5-10s cho các công việc truyền thông chạy lâu.
4. Dừng lại chỉ khi công việc đã hoàn thành hoặc thất bại.
5. Khi hoàn thành, đọc các trường kết quả cụ thể cho truyền thông và lưu trữ các URL hoặc siêu dữ liệu cuối cùng.
6. Khi thất bại, lưu trữ lỗi công khai và chỉ đề nghị thử lại như một công việc mới có thể nhìn thấy bởi người dùng.

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "model": "veo3.1"
}

Ví Dụ Kiểm TraCopy Anchor Link

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Các trạng thái công khai mong đợi là pending, processing, completed, và failed. Các công việc bị hủy được biểu thị là failed với cancelled: true và cancellation_status: "cancelled" để xử lý trạng thái cũ vẫn hoạt động.

Quy Tắc Thử Lại của Khách HàngCopy Anchor Link

Thời gian chờ mạng là nguồn gốc phổ biến nhất của các công việc trùng lặp. Sử dụng quy tắc này:

Không gửi yêu cầu tạo thứ hai chỉ vì trình duyệt đã làm mới hoặc một cuộc kiểm tra trạng thái thất bại.

Thanh Toán Và Giải QuyếtCopy Anchor Link

Các công việc không đồng bộ có thể giữ một số tiền ước tính khi yêu cầu tạo được chấp nhận. Giải quyết cuối cùng xảy ra sau trạng thái cuối cùng. Khi có sẵn, phản hồi trạng thái công việc có thể tiết lộ billing_transaction_id và tiêu đề X-Billing-Transaction-ID.

Để đối chiếu, kết hợp các định danh này trong nhật ký của bạn:

• request_id từ yêu cầu tạo.
• task_id / id từ công việc.
• billing_transaction_id khi có mặt.
• ID người dùng, ID dự án, hoặc ID công việc của riêng bạn.

Hủy BỏCopy Anchor Link

DELETE /v1/tasks/{id} được giới hạn có chủ ý. Khi tác vụ đã chọn hỗ trợ hủy, endpoint này áp dụng cho các tác vụ video Seedance đang chờ như seedance-1.5-pro, seedance-2.0 và seedance-2.0-fast.

Các công việc không được hỗ trợ trả về 400 unsupported_task_cancel. Các công việc đã chạy hoặc ở trạng thái cuối cùng trả về 409 task_not_cancellable. Xây dựng giao diện hủy bỏ như "yêu cầu hủy bỏ" thay vì một nút dừng đảm bảo.

Khắc Phục Sự CốCopy Anchor Link

Gói Hỗ TrợCopy Anchor Link

Khi liên hệ với hỗ trợ, bao gồm request_id, task_id, billing_transaction_id khi có mặt, điểm cuối, mô hình, dấu thời gian, và hình dạng yêu cầu đã được làm sạch. Không bao gồm khóa API, truyền thông riêng tư, URL đã ký, hoặc toàn bộ yêu cầu trừ khi hỗ trợ yêu cầu một mẫu đã được chỉnh sửa.

Tài Liệu APICopy Anchor Link