Tạo video
Tạo tác vụ Wan 3.0 từ văn bản, ảnh hoặc tham chiếu đa phương thức bằng các trường chung của nền tảng.
Định dạng nền tảng dùng tham số cấp cao nhất và metadata; không đưa trực tiếp input/parameters gốc vào yêu cầu. Nền tảng tạo bất đồng bộ, sau đó truy vấn kết quả.
/v1/videosXác thực
bearerAuth Dùng API Key nền tảng: Authorization: Bearer your-api-key.
Vị trí truyền: header
Nội dung yêu cầu
application/json
Định nghĩa kiểu TypeScript
Sử dụng kiểu request body trong TypeScript.
Cung cấp lời nhắc hoặc metadata.media không rỗng. Dùng JSON, không dùng multipart/input_reference/image/images.
Nội dung phản hồi
application/json
application/json
application/json
Tham số và thứ tự ưu tiên
| Cấu hình | Cách điền và ưu tiên |
|---|---|
| Lời nhắc và tư liệu | Cần prompt hoặc metadata.media không rỗng; ảnh không dùng image/images/input_reference cấp cao nhất |
| Phân giải | size không rỗng → metadata.resolution không rỗng → metadata.size không rỗng → 1080P; điền mức phân giải, không dùng kích thước pixel |
| Thời lượng | duration chỉ định → seconds không rỗng → metadata.duration → 5; duration là số nguyên, seconds là chuỗi số nguyên |
| Seed | seed cấp cao nhất chỉ định ưu tiên hơn metadata.seed; 0 hợp lệ |
| Khác | Tỷ lệ, âm thanh, viết lại và hình mờ đặt trong metadata; giữ giá trị false chỉ định |
Nên dùng một cách điền cho mỗi cấu hình. Chuỗi trắng của phân giải và seconds coi như bỏ qua; có tư liệu thì có thể bỏ prompt. Giá trị ưu tiên cao không hợp lệ sẽ báo lỗi, không tự dùng giá trị thấp hơn.
Tình huống và tư liệu
Ví dụ gồm văn bản, khung đầu, khung đầu/cuối, tham chiếu hỗn hợp, tệp, trang web, chỉnh sửa và kéo dài. Khi chọn tư liệu, thay URL ví dụ bằng URL có thể truy cập của bạn.
Không trộn khung đầu/cuối với tư liệu tham chiếu; khung cuối cần khung đầu. Chọn tệp hoặc trang web và bật viết lại lời nhắc. Xem quy tắc tư liệu và kết hợp về định dạng, số lượng, kích thước, thời lượng; định dạng nền tảng áp dụng cùng quy tắc.
Kết quả tạo và đường dẫn tương thích
Tạo trả về đối tượng video. Lưu id, dùng API truy vấn nền tảng lấy kết quả. task_id tương thích bằng id. queued là đã tiếp nhận, chưa phải tạo xong.
Cũng hỗ trợ POST /v1/video/generations và POST /v1/videos/generations với cùng tham số và cấu trúc phản hồi. Tích hợp mới nên dùng POST /v1/videos.
Lỗi thường gặp
Với HTTP 400, dựa vào lỗi để kiểm tra kiểu tham số, mức phân giải, kết hợp tư liệu và tên trường metadata. Lỗi có thể dùng cấu trúc code/message/data hoặc đối tượng error lồng.