Truy vấn video
Đọc trạng thái gốc, URL video và mức sử dụng Wan 3.0.
Dùng output.task_id của phản hồi tạo để truy vấn; output.task_id trả về vẫn là ID công khai nền tảng. Kết quả và mức sử dụng nằm ở output, usage.
/api/v1/tasks/{task_id}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 tác vụ công khai do nền tảng trả về. Lưu dưới dạng chuỗi và dùng để truy vấn, tải xuống; không dùng request_id hoặc ID tác vụ thượng nguồn lồng bên trong.
1 <= lengthNội dung phản hồi
application/json
application/json
application/json
Trạng thái và kết quả
output.task_status | Ý nghĩa và xử lý |
|---|---|
PENDING | Đang xếp hàng |
RUNNING | Đang xử lý |
SUCCEEDED | Thành công, đọc output.video_url |
FAILED | Thất bại, đọc output.code/message và dừng thăm dò |
CANCELED | Đã hủy, dừng thăm dò |
UNKNOWN | Trạng thái không rõ, không coi là thành công |
Truy vấn khoảng mỗi 15 giây, đặt thời gian chờ tổng. Bản ghi lưu trên nền tảng được cập nhật nền; dùng truy vấn thay vì tạo lặp lại.
Tải và lưu video sớm sau khi tạo xong, tránh URL kết quả hết hạn.
Trường mức sử dụng và thời gian
usage.duration là tổng thời lượng sử dụng, gồm đầu vào/đầu ra nếu có video. input_video_duration/output_video_duration có thể là số thập phân, không áp dụng quy tắc số nguyên của yêu cầu. Có thể có thêm video_count, fps, SR, ratio.
submit_time/scheduled_time/end_time là chuỗi UTC+8 khi có, không phải dấu thời gian Unix. request_id dùng theo dõi yêu cầu, không truy vấn tác vụ.
Lỗi truy vấn
Với HTTP 400 và task_not_exist, kiểm tra ID công khai, trang API và tài khoản API Key; khác trạng thái UNKNOWN của tác vụ. Với HTTP 401, kiểm tra xác thực Bearer.
Phản hồi lỗi có thể chỉ chứa code/message/request_id cấp cao nhất, không có output. Muốn đối tượng video, xem truy vấn nền tảng.