APIMaster.ai

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