Chuyển đến nội dung

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à succeeded hoặc failed.
  • 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"