Tham số đường dẫn
string
bắt buộc
ID tác vụ trả về từ yêu cầu tạo video. Xem
id và task_id là cùng một định danh không đồng bộ (async).Nếu phản hồi create trả về
poll_url, hãy gọi đúng URL đó. Khi nó trỏ tới /v1/tasks/{id}, hãy coi đó là endpoint trạng thái cố định chuẩn.Nếu tác vụ không còn tồn tại hoặc không còn có trong bản ghi tác vụ công khai, TokenLab trả về async_task_not_found với thông báo Task not found or no longer available.Phản hồi
string
Định danh tác vụ async chuẩn.
string
Bí danh định danh tác vụ async.
string
URL ưu tiên để thăm dò khi phản hồi tạo cung cấp.
string
ID giao dịch billing của TokenLab khi việc settlement đã hoàn tất. Đây là mã giao dịch dùng cho dashboard/đối soát và tách biệt với
id / task_id bất đồng bộ.string
Trạng thái tác vụ:
pending, processing, completed, failed.number
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.string
URL của video đã tạo (khi hoàn thành).
object
Payload video đơn với
url, duration, width, và height khi có.array
Nhiều payload video khi tác vụ tạo trả về hơn một kết quả.
string
Thông báo lỗi (nếu thất bại).
integer
Dấu thời gian tạo.
integer
Dấu thời gian cập nhật cuối cùng.
string
Mô hình được sử dụng cho tác vụ.
Thực hành tốt nhất khi thăm dò
- Thăm dò (poll) mỗi 5-10 giây
- Triển khai exponential backoff cho các tác vụ chạy lâu
- Đặt thời gian chờ tối đa (ví dụ: 10 phút)
- Xử lý trạng thái
failedmột cách phù hợp