Tạo video
Tạo tác vụ video Wan 3.0 bằng cấu trúc đầu vào gốc.
Dùng model/input/parameters gửi tác vụ bản tiêu chuẩn. Định dạng gốc vẫn dùng địa chỉ API và API Key nền tảng, không cần Workspace ID Alibaba Cloud. Nền tảng tự bật bất đồng bộ; không cần thêm X-DashScope-Async.
/api/v1/services/aigc/video-generation/video-synthesisXá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.
Gửi cấu trúc gốc. Nền tảng tự bật bất đồng bộ, không cần X-DashScope-Async.
Nội dung phản hồi
application/json
application/json
application/json
Quy tắc tư liệu và kết hợp
Cần lời nhắc hoặc media không rỗng. Ảnh, video và âm thanh được đánh số riêng theo thứ tự cùng loại trong mảng, có thể dùng “图1”, “视频1”, “音频1”; không cần ID tham chiếu tư liệu.
| Tư liệu | Định dạng và số lượng | Giới hạn chính |
|---|---|---|
| Khung đầu/cuối | first_frame, last_frame mỗi loại tối đa 1 ảnh | Khung cuối cần khung đầu; không dùng cùng ảnh, video, âm thanh tham chiếu, tệp hoặc trang web |
| Ảnh tham chiếu | Tối đa 10 reference_image | JPEG/JPG/PNG không alpha/BMP/WEBP; mỗi ảnh 20MB; mỗi cạnh 240–8000px; tỷ lệ không quá 8:1 |
| Video tham chiếu | Tối đa 5 reference_video | MP4/MOV; mỗi đoạn 1–15 giây, tổng tối đa 15 giây; mỗi tệp 100MB; mỗi cạnh 240–4096px; ít nhất 16fps; tỷ lệ tối đa 8:1 |
| Âm thanh tham chiếu | Tối đa 5 reference_audio | WAV/MP3; mỗi đoạn 1–15 giây, tổng tối đa 15 giây; mỗi tệp 15MB |
| Tệp | Tối đa 1 file | Tối đa 100MB; PDF, Word, PowerPoint, Keynote, Pages tối đa 50 trang; định dạng xem bảng trường |
| Trang web | Tối đa 1 link | Trang công khai HTTP/HTTPS không đăng nhập; không dùng cùng tệp |
Ảnh khung đầu/cuối có cùng giới hạn với ảnh tham chiếu. Ảnh hỗ trợ URL công khai hoặc Base64 có tiền tố, như data:image/png;base64,...; tư liệu khác dùng URL. Tư liệu thường cũng dùng được địa chỉ OSS có quyền truy cập; trang web chỉ HTTP/HTTPS. Trừ trang web, phần mở rộng URL phải khớp định dạng nếu có; URL không phần mở rộng vẫn phải đạt thông số nội dung.
Có thể kết hợp ảnh, video, âm thanh tham chiếu và thêm tệp hoặc trang web, nhưng file và link loại trừ nhau. Tệp/trang web cần bật prompt_extend. Chỉnh sửa và kéo dài dùng video tham chiếu cùng lời nhắc; kéo dài dùng ratio: "adaptive".
Thời lượng là -1 thông minh hoặc số nguyên 2～30 giây. Nếu có video tham chiếu, tổng thời lượng video đầu vào và đầu ra không vượt 30 giây.
Kết quả tạo và bước tiếp theo
Sau khi gửi, lưu output.task_id, dùng API truy vấn gốc lấy trạng thái và kết quả. request_id để theo dõi, không truy vấn tác vụ. Không tạo lại cùng tác vụ để lấy tiến độ.
Muốn dùng trường chung, chọn tạo theo định dạng nền tảng. Không trộn hai định dạng.
Lỗi thường gặp
Với HTTP 400, dựa vào lỗi kiểm tra JSON, tên mô hình, input/parameters và kết hợp tư liệu. Lỗi có thể ở code/message/data hoặc error lồng. Khi liên hệ hỗ trợ, cung cấp lỗi và ID yêu cầu, không cung cấp API Key.