Skip to main content

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êm callback_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:
Thăm dò tác vụ bằng:
Xác thực bằng Bearer token:

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

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.
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.
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