Truy vấn video
Truy vấn trạng thái và kết quả tác vụ gốc Kling 4.0 từ văn bản, ảnh và Omni.
Dùng data.id từ phản hồi tạo. Khi thành công, lấy URL từ outputs và lưu ngay. Chỉ trả dữ liệu tác vụ người dùng hiện tại được truy cập.
/kling/tasks/{task_id}Truy vấn một tác vụ Kling 4.0 của người dùng hiện tại: văn bản, ảnh hoặc Omni. Dùng ID hệ thống, không phải options.external_task_id. Trạng thái submitted, processing, succeeded, failed. Dừng thăm dò không hủy tác vụ. billing chỉ công khai giá niêm yết và tiền tệ, không phải hóa đơn tài khoản hay khấu trừ nội bộ.
Xác thực
bearerAuth Dùng API Key nền tảng: Authorization: Bearer your-api-key.
Vị trí truyền: header
Tham số đường dẫn
ID hệ thống do API tạo trả về. ID mới là chuỗi; không đổi sang số để tránh mất độ chính xác.
1 <= lengthNội dung phản hồi
application/json
application/json
application/json
billing.list_price là giá niêm yết theo đồng tiền tương ứng, không phải phí nền tảng cuối cùng. Giá có thể xuất hiện muộn hơn video; thiếu giá không có nghĩa miễn phí.
Trạng thái và lưu kết quả
data là mảng tác vụ kể cả khi truy vấn một ID. code của yêu cầu khác status của tác vụ; kiểm tra trạng thái trước khi sử dụng kết quả.
status | Ý nghĩa |
|---|---|
submitted | Đã gửi, chờ xử lý |
processing | Đang xử lý, truy vấn lại sau |
succeeded | Tạo thành công, đọc video từ outputs |
failed | Tạo thất bại, đọc message và dừng thăm dò |
Kết quả video có type là video; id là ID video, duration là số giây dạng chuỗi. url là URL có bảo vệ liên kết. Với hình mờ, xem watermark_url thực tế trả về.
Kết quả nguồn bị xóa sau 30 ngày; tải và lưu sớm. Quy tắc lưu giữ này không đảm bảo URL bảo vệ liên kết còn hiệu lực 30 ngày.
Lỗi truy vấn và tác vụ thất bại
| Tình huống | Kiểm tra và xử lý |
|---|---|
HTTP 400, task_not_exist | Dùng ID hệ thống trả lúc tạo, kiểm tra Key/trang; không dùng options.external_task_id |
HTTP 401, Invalid token | Kiểm tra Bearer và Key; thiếu/sai Key có thể trả cùng lỗi |
HTTP 200, tác vụ status: "failed" | Truy vấn thành công nhưng tạo thất bại; đọc message và dừng thăm dò |
Cấu trúc lỗi HTTP có thể khác data[] thành công. Không coi HTTP 400/401 là trạng thái failed; dừng thăm dò khi lỗi xác thực hoặc không có tác vụ.