Những gì bạn sẽ xây dựng
Bạn sẽ gửi một tác vụ Kling text-to-video, lưu task ID được trả về, thăm dò endpoint tác vụ Kling tương ứng và quyết định khi nào cần thêmcallback_url để nhận thông báo đẩy.
Điều kiện tiên quyết
- Một API key CometAPI được lưu trong
COMETAPI_KEY - Python 3.10+ với
requests, hoặc Node.js 18+ - Một worker phía máy chủ để thăm dò hoặc một endpoint callback HTTPS cho webhook
API key, base URL, xác thực
Tạo một tác vụ Kling text-to-video bằng:Ví dụ mã
Sử dụng các tab bên dưới để xem các ví dụ có thể sao chép trong cURL, Python và Node.js.Giải thích luồng
Quá trình tạo video Kling là bất đồng bộ. Endpoint tạo sẽ trả vềdata.task_id. Hãy poll GET /kling/v1/videos/text2video/<task_id> cho đến khi data.task_status đạt succeed hoặc failed. Khi tác vụ thành công, hãy sao chép URL asset đã hoàn tất từ data.task_result vào bộ lưu trữ của riêng bạn nếu bạn cần quyền truy cập bền vững.
Thêm callback_url khi bạn muốn các bản cập nhật trạng thái tác vụ được đẩy đến một endpoint HTTPS do bạn kiểm soát. Vẫn giữ cơ chế polling để đối soát và xử lý các trường hợp callback bị bỏ lỡ.
Các tham số phổ biến
Khắc phục sự cố / FAQ
Cấu trúc phản hồi khác với các route video của OpenAI
Cấu trúc phản hồi khác với các route video của OpenAI
Kling sử dụng các trường JSON đặc thù của nhà cung cấp như
data.task_id, data.task_status, và data.task_result. Đừng parse nó như các route /v1/videos tương thích OpenAI.Tác vụ không bao giờ đạt trạng thái succeed
Tác vụ không bao giờ đạt trạng thái succeed
Sử dụng polling có giới hạn và kiểm tra
data.task_status_msg khi tác vụ thất bại. Lưu task ID để chẩn đoán sau này.Tôi nên dùng callback_url hay polling
Tôi nên dùng callback_url hay polling
Dùng polling làm phương án cơ bản. Thêm
callback_url để nhận cập nhật theo cơ chế đẩy, sau đó đối soát trạng thái cuối cùng bằng polling.Các bước tiếp theo
- Đọc tài liệu tham chiếu API Kling text-to-video.
- Poll với Lấy một tác vụ Kling.
- Cấu hình callback với Sử dụng URL callback của Kling.
- Tìm các model video Kling trong Models.
- Xem lại Sử dụng polling và webhook cho việc tạo video.
- Ước tính chi phí tác vụ với Ước tính chi phí yêu cầu trước khi gọi một model.