Sử dụng polling làm nền tảng 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 giữ polling làm nguồn thông tin chuẩn 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 provider.Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Tạo một video task
Yêu cầu sau tạo một video task tối giản và lưu ID được trả về. Chỉ thêm các trường thời lượng, độ phân giải hoặc callback khi trang model được chọn có tài liệu mô tả các trường đó.Poll trạng thái
Yêu cầu sau kiểm tra trạng thái của video task:video_url khi bộ điều hợp model 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 qua 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ù của provider, 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:Các lỗi thường gặp
| Error | Cách khắc phục |
|---|---|
| Callback bị mất | Poll theo task ID cho đến khi ứng dụng của bạn đã lưu một trạng thái kết thúc. |
| Callback trùng lặp | Làm cho việc xử lý callback có tính idempotent theo task ID. |
| Callback bị từ chối | Trả về phản hồi 2xx nhanh chóng, sau đó xử lý job ở nền. |
| Không khớp payload đặc thù của provider | Lưu payload callback thô và chuẩn hóa nó trong ứng dụng của bạn. |
Thiếu video_url | Coi video_url là tùy chọn và sử dụng polling cùng với các trường kết quả đặc thù của model hoặc /v1/videos/{id}/content khi có sẵn. |