Truy vấn tác vụ · Định dạng cũ
Truy vấn tác vụ Wan 3.0 bằng định dạng phản hồi cũ.
Đường dẫn trả đối tượng cũ trong code/message/data. Tích hợp mới nên dùng API truy vấn nền tảng; không hoán đổi hai cấu trúc.
/v1/video/generations/{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 kết quả kiểu cũ
code: "success" chỉ truy vấn thành công; vẫn cần kiểm tra data.status:
| Trạng thái | Ý nghĩa |
|---|---|
NOT_START/SUBMITTED/QUEUED | Chưa chạy, đã gửi hoặc đang xếp hàng |
IN_PROGRESS | Đang xử lý |
SUCCESS | Thành công, đọc data.result_url |
FAILURE | Thất bại, đọc data.fail_reason và dừng thăm dò |
data.progress là chuỗi như "100%", khác tiến độ số của truy vấn nền tảng. created_at/updated_at/submit_time/start_time/finish_time là dấu thời gian Unix theo giây; thời gian bắt đầu/kết thúc có thể là 0 trước sự kiện. Ví dụ chỉ liệt kê trường tác vụ; thực tế có thể có thêm.
Truy vấn/tải bằng ID công khai từ API tạo, chính là data.task_id ở đây. data.data là phản hồi gốc; ID bên trong không dùng truy vấn hay tải trên nền tảng.
Thăm dò và xử lý lỗi
Truy vấn khoảng mỗi 15 giây, đặt thời gian chờ tổng và dừng ở trạng thái kết thúc. Lưu video sớm sau thành công. Dừng thăm dò không hủy tạo.
HTTP 400 task_not_exist và HTTP 401 là lỗi yêu cầu truy vấn, không phải trạng thái tác vụ bình thường. Kiểm tra ID, trang API, API Key trước khi xử lý dữ liệu.