Tài liệu API · Tác vụ
Tần suất polling khuyến nghị
Polling có backoff, dừng khi đến trạng thái cuối.
Nếu chưa cấu hình Webhook, hãy dùng endpoint truy vấn để lấy kết quả. Việc tạo video thường mất từ vài chục giây đến vài phút.
- Truy vấn lần đầu khoảng 5 giây sau khi gửi, sau đó tăng dần khoảng cách lên 1,5 lần mỗi lần, tối đa 30 giây.
- Dừng polling khi trạng thái là
succeededhoặcfailed. - Yêu cầu truy vấn không tính phí nhưng được tính vào giới hạn RPM; khi cần theo dõi nhiều tác vụ, hãy dùng endpoint danh sách
GET /v1/videos/generations. - Khi đã cấu hình Webhook, chỉ dùng truy vấn làm dự phòng, ví dụ cứ 5 phút kiểm tra một lần các tác vụ chưa nhận được callback.
curl https://cn-api.aitoken.tools/v1/videos/generations/task_xxx \
-H "Authorization: Bearer $AITOKEN_API_KEY"