Skip to main content
Dùng polling làm phương án cơ bản cho việc tạo video vì mọi job bất đồng bộ đều trả về một task ID mà bạn có thể truy vấn. Chỉ thêm webhook khi endpoint video được chọn hỗ trợ callback URL, và vẫn dùng polling làm nguồn xác thực chính cho các callback bị bỏ lỡ hoặc việc phân phối callback mang tính đặc thù của từng nhà cung cấp.

Tạo một video task

Yêu cầu sau tạo một video task tối thiểu và lưu ID được trả về. Chỉ thêm các trường duration, resolution hoặc callback khi trang model được chọn có tài liệu mô tả các trường đó.
Phản hồi bao gồm task ID và trạng thái:

Poll trạng thái

Yêu cầu sau kiểm tra trạng thái của video task:
Phản hồi sẽ thay đổi theo tiến trình của task. Các phản hồi hoàn tất có thể bao gồm video_url khi model adapter có URL kết quả; nếu không, hãy dùng các trường kết quả đặc thù của model hoặc route nội dung /v1/videos/{id}/content khi model đó hỗ trợ tải xuống được proxy.

Nhận một webhook

CometAPI không định nghĩa một payload callback phổ quát cho mọi model video. Hãy coi callback là các sự kiện pass-through đặc thù theo từng nhà cung cấp, lưu phần body thô và đối chiếu trạng thái cuối cùng bằng polling. Trình xử lý Express sau chấp nhận một callback video và lưu sự kiện:
Một payload callback thường bao gồm các trường nhận dạng task và trạng thái, nhưng cấu trúc lồng chính xác phụ thuộc vào model hoặc nhà cung cấp được chọn:

Các lỗi thường gặp

Liên kết liên quan

Lần sửa đổi cuối 25 tháng 6, 2026