Truy vấn video
Truy vấn tiến độ và kết quả đối tượng video Wan 3.0 nền tảng.
Dùng ID tác vụ công khai từ API tạo để truy vấn. Phản hồi là một đối tượng video.
/v1/videos/{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
Đọc trạng thái và URL video
status | Ý nghĩa và xử lý |
|---|---|
queued | Đang xếp hàng, truy vấn lại sau |
in_progress | Đang xử lý, truy vấn lại sau |
completed | Tạo xong, đọc metadata.url |
failed | Tạo thất bại, đọc error nếu có và dừng thăm dò |
unknown | Trạng thái chưa nhận diện, không coi là thành công |
Lưu id của phản hồi; truy vấn không phụ thuộc task_id dư thừa ở phản hồi tạo. Không kết luận thành công từ progress, completed_at hoặc sự có mặt của error. completed_at là thời điểm cập nhật bản ghi; dùng status.
Sau thành công, lưu URL hoặc dùng API tải video. Giao diện này không trả output/usage gốc; xem truy vấn gốc để lấy mức sử dụng.
Thăm dò và xử lý lỗi
Nên truy vấn khoảng mỗi 15 giây và đặt thời gian chờ tổng. Truy vấn đọc bản ghi nền tảng nên gọi liên tục có thể cùng trạng thái. Dừng thăm dò không hủy tạo video.
Với HTTP 400 và task_not_exist, kiểm tra ID thuộc đúng trang API và dùng API Key của tài khoản sở hữu tác vụ. Với HTTP 401, xử lý xác thực trước khi truy vấn tiếp. Dựa vào status để xác định tạo thành công.