API Video Wan 3.0
Tham số, tổ hợp phương tiện, tác vụ bất đồng bộ, tải xuống và tính phí theo giây cho wan3.0-video trên APIMaster.
API Video Wan 3.0
wan3.0-video là mô hình Wan 3 tiêu chuẩn; đây là một mô hình riêng biệt với wan3.0-video-prime. Mô hình hỗ trợ văn bản, hình ảnh, video, âm thanh, tài liệu và các trang web công khai. Mỗi tác vụ thành công tạo ra một video MP4/H.264, tối đa 30 giây. Thời điểm rà soát tích hợp: 2026-11-17.
Mỗi yêu cầu hỗ trợ tối đa 20 mục đa phương tiện tổng cộng. Video được tạo ở 30 fps.
Các endpoint và xác thực
| Thao tác | Endpoint |
|---|---|
| Tạo | POST https://apimaster.ai/v1/videos |
| Truy vấn | GET https://apimaster.ai/v1/videos/{task_id} |
| Tải xuống | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
Tất cả tham số request
Dùng một định dạng phương tiện cho mỗi yêu cầu. Dùng metadata.input.media cho phương tiện tham chiếu kết hợp hoặc tài liệu.
| Tham số | Kiểu | Bắt buộc / mặc định | Ý nghĩa và giá trị hợp lệ |
|---|---|---|---|
model |
string | Bắt buộc | Chính xác là wan3.0-video; không thay thế bằng Prime |
prompt |
string | Bắt buộc | Mô tả kết quả bằng tiếng Trung hoặc tiếng Anh; giới hạn chính thức 20.000 ký tự, văn bản gốc dài hơn sẽ bị cắt bớt. Tham chiếu Image 1, Video 1, Audio 1 theo thứ tự media; mỗi loại media có cách đánh số riêng |
duration |
integer | 5 |
2–30 giây đầu ra; -1 cho phép model tự chọn thời lượng. Khi có video tham chiếu, thời lượng đầu vào cộng đầu ra không được vượt quá 30 giây |
seconds |
string | Tùy chọn | Alias của duration, ví dụ "5" hoặc "-1"; phải khớp với duration khi cung cấp cả hai |
resolution |
string | 1080P |
480P, 720P, 1080P; các giá trị cấp cao nhất viết thường sẽ được chuẩn hóa |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | Tùy chọn | Alias của aspect_ratio; nên dùng adaptive khi nối dài video |
size |
string | Tùy chọn | Alias tương thích: mức resolution, hoặc ánh xạ pixel được hỗ trợ như 1280x720; nên dùng resolution và ratio rõ ràng, không dùng kích thước pixel tùy ý |
generate_audio |
boolean | true phía upstream |
Đầu ra có track âm thanh hay không. false chỉ định rõ sẽ được giữ nguyên. Âm thanh không làm thay đổi mức giá theo giây |
audio |
boolean | Tùy chọn | Alias của generate_audio; chỉ dùng một công tắc âm thanh |
prompt_extend |
boolean | true |
Viết lại prompt thông minh; false chỉ định rõ sẽ được giữ nguyên. Phải là true với đầu vào document/page |
watermark |
boolean | false phía upstream |
Thêm watermark vào đầu ra; false chỉ định rõ sẽ được giữ nguyên |
seed |
integer | Ngẫu nhiên | -1 hoặc 0–2147483647. Bỏ qua hoặc đặt -1 sẽ yêu cầu seed ngẫu nhiên; 0 được chuyển tiếp. Lặp lại cùng seed không đảm bảo đầu ra giống hệt nhau |
input_reference |
string | Tùy chọn | URL ảnh khung đầu tiên; thay thế mảng media gốc. Không trộn lẫn các kiểu đầu vào |
images |
string[] | Tùy chọn | Mảng tiện dụng được thêm vào dưới dạng các mục reference_image khi không có input_reference |
metadata |
object | Tùy chọn | Vùng chứa cho các đối tượng gốc bên dưới; không thể thay đổi model đã chọn |
metadata.input |
object | Tùy chọn | Đối tượng input gốc |
metadata.input.prompt |
string | Tùy chọn | Ghi đè prompt gốc; vẫn phải giữ prompt cấp cao nhất bắt buộc |
metadata.input.media |
object[] | Tùy chọn | Mảng media có thứ tự. Mỗi mục yêu cầu type và url; xem các giới hạn bên dưới |
metadata.input.media[].type |
string | Bắt buộc với mỗi mục | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Bắt buộc với mỗi mục | URL media HTTP(S) công khai; các loại image cũng chấp nhận chuỗi data:{MIME_type};base64,.... Media không phải image yêu cầu URL công khai |
metadata.parameters |
object | Tùy chọn | Đối tượng tham số gốc; không được là null |
metadata.parameters.resolution |
string | 1080P |
Viết hoa 480P, 720P, 1080P |
metadata.parameters.ratio |
string | adaptive |
Các giá trị aspect-ratio giống như liệt kê ở trên |
metadata.parameters.duration |
integer | 5 |
2–30, hoặc -1; cùng ràng buộc về tổng thời lượng |
metadata.parameters.audio |
boolean | true phía upstream |
Cùng công tắc âm thanh đầu ra |
metadata.parameters.prompt_extend |
boolean | true |
Cùng công tắc viết lại prompt; file/link yêu cầu true |
metadata.parameters.watermark |
boolean | false phía upstream |
Cùng công tắc watermark |
metadata.parameters.seed |
integer | Ngẫu nhiên | Cùng khoảng seed, bao gồm cả 0 chỉ định rõ |
Các trường gốc negative_prompt, img_url, first_frame_url, last_frame_url, và audio_url không phải là các điều khiển media của Wan 3. Thay vào đó, hãy dùng mảng media đã được tài liệu hóa.
Giới hạn media và các tổ hợp hợp lệ
| Loại media | Số lượng và ràng buộc |
|---|---|
first_frame, last_frame |
Tối đa một mỗi loại. Khung cuối yêu cầu phải có khung đầu. Điều khiển khung không thể kết hợp với bất kỳ loại reference, file hay link nào |
reference_image |
Tối đa 10. JPEG/JPG, PNG không có độ trong suốt, BMP hoặc WEBP; mỗi cạnh 240–8.000 pixel, tỷ lệ khung hình tối đa 8:1, mỗi file tối đa 20 MB |
reference_video |
Tối đa 5 clip MP4/MOV; mỗi clip 1–15 giây, tổng đầu vào tối đa 15 giây; tối thiểu 16 fps; mỗi cạnh 240–4.096 pixel, tỷ lệ khung hình tối đa 8:1, mỗi file tối đa 100 MB |
reference_audio |
Tối đa 5 clip WAV/MP3; mỗi clip 1–15 giây, tổng cộng tối đa 15 giây; mỗi file tối đa 15 MB |
file |
Tối đa một file DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD; tối đa 100 MB. PDF, DOCX, DOC, PPTX, PPT và các tài liệu dạng trang KEY/PAGES có giới hạn 50 trang |
link |
Tối đa một trang truy cập công khai không cần đăng nhập; không kết hợp với file |
Ảnh, video và âm thanh reference có thể được kết hợp. Một file hoặc link có thể đi kèm media reference. Chế độ khung đầu/khung cuối chỉ chấp nhận điều khiển khung; hãy dùng chế độ reference-image kèm reference-audio để tạo video điều khiển bằng âm thanh. Việc phân tích media và kiểm duyệt nội dung vẫn phải chịu các kiểm tra từ phía upstream.
Text-to-video sử dụng prompt không kèm media. Tạo hoạt ảnh từ khung đầu dùng first_frame; chuyển cảnh dùng first_frame kèm last_frame. Tạo bằng reference sử dụng các loại reference. Để chỉnh sửa hoặc kéo dài, hãy cung cấp reference_video và mô tả nội dung chỉnh sửa hoặc kéo dài trong prompt; dùng adaptive cho kéo dài.
Ví dụ
Văn bản thành video
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
Khung hình đầu và khung hình cuối
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
Hình ảnh và âm thanh tham chiếu
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm of Audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}
Chỉnh sửa / kéo dài video và thời lượng thông minh
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Tài liệu / trang web
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Thay thế tất cả URL ví dụ bằng media công khai thực tế. Với đầu vào là web, thay thế mục file bằng {"type":"link","url":"https://example.com/product"}. Ví dụ khung hình đầu cũng hoạt động khi không có mục khung hình cuối.
Phản hồi, polling, tải xuống và log
Thao tác tạo trả về ID tác vụ của APIMaster, không phải ID của nhà cung cấp gốc:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Trường phản hồi | Ý nghĩa |
|---|---|
id / task_id |
Mã định danh tác vụ trên nền tảng, dùng cho truy vấn và tải xuống |
status |
queued, in_progress, completed, failed |
progress |
Chỉ báo tiến độ; hãy chờ đến trạng thái kết thúc |
error.code, error.message |
Thông tin lỗi khi có |
metadata.url |
Vị trí nội dung khi được trả về lúc hoàn tất |
Thực hiện polling khoảng mỗi 15 giây bằng cùng API key. Không tạo tác vụ khác để kiểm tra tiến độ. ID tác vụ và URL đầu ra của nhà cung cấp gốc sẽ hết hạn sau 24 giờ; hãy tải xuống và lưu giữ kết quả thành công ngay. Nên dùng endpoint nội dung có xác thực của APIMaster thay vì lưu trữ các URL tạm thời từ nhà cung cấp gốc.
curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o wan3.mp4
Log sử dụng chứa tác vụ và kết quả video thành công. Kiểm tra khoản phí cuối cùng sau khi hoàn tất; việc chấp nhận không phải là bằng chứng tạo thành công. Polling lặp lại không tạo thêm phí tạo.
Tính phí
Xem đơn giá mỗi giây trên thẻ mô hình.
APIMaster cộng thời lượng của tất cả video đầu vào với thời lượng video đầu ra, làm tròn tổng lên đến giây nguyên một lần rồi nhân với đơn giá mỗi giây của độ phân giải đầu ra đã chọn. Đầu vào 2,3 giây và đầu ra 5 giây được tính là 8 giây. Khi không có video đầu vào, chỉ tính thời lượng đầu ra. Yêu cầu không cần báo giá riêng hoặc khai báo thời lượng đầu vào. Nếu tạo thất bại, khoản giữ trước được hoàn lại. Khoản phí cuối cùng có trong nhật ký sử dụng.
Lỗi và cách khắc phục
| Triệu chứng | Cách khắc phục |
|---|---|
| Thời lượng/độ phân giải/tỷ lệ không hợp lệ | Sử dụng enum và các khoảng ở trên; thời lượng thông minh chính xác là -1 |
| Xung đột khung/tham chiếu, có khung cuối mà không có khung đầu | Tuân theo quy tắc kết hợp |
| Tệp/liên kết kèm tính năng viết lại bị tắt | Đặt prompt_extend:true |
| Lỗi tải/định dạng/thời lượng media | Sử dụng tệp công khai đáp ứng mọi ràng buộc về kích thước, định dạng và thời lượng |
| Thiếu prompt | Giữ prompt cấp cao nhất không rỗng cho API APIMaster |
| Tác vụ thất bại hoặc bị kiểm duyệt | Kiểm tra error, sau đó sửa yêu cầu; không coi việc chấp nhận là thành công |
