Wan 3.0 影片 API
APIMaster 上 wan3.0-video 的參數、媒體組合、非同步任務、下載與按秒計費。
Wan 3.0 影片 API
wan3.0-video 是標準的 Wan 3 模型;它與 wan3.0-video-prime 是不同的模型。它支援文字、圖片、影片、音訊、文件以及公開網頁。每個成功的任務會產生一個 MP4/H.264 影片,最長 30 秒。整合審核日期:2026-11-17。
每個請求最多包含 20 項媒體素材;生成影片的幀率為 30 fps。
端點與認證
| 操作 | 端點 |
|---|---|
| 建立 | POST https://apimaster.ai/v1/videos |
| 查詢 | GET https://apimaster.ai/v1/videos/{task_id} |
| 下載 | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
所有請求參數
同一請求請選擇一種媒體格式。使用 metadata.input.media 提交混合參考素材或文件。
| 參數 | 類型 | 必填/預設值 | 含義與有效值 |
|---|---|---|---|
model |
string | 必填 | 必須為 wan3.0-video;請勿替換為 Prime |
prompt |
string | 必填 | 以中文或英文描述結果;官方限制為 20,000 個字元,較長的原生文字會被截斷。依媒體順序以 Image 1、Video 1、Audio 1 指稱;每種媒體類型各自獨立編號 |
duration |
integer | 5 |
輸出秒數 2–30;-1 表示由模型自行選擇時長。使用參考影片時,輸入加上輸出的時長不得超過 30 秒 |
seconds |
string | 選填 | 時長別名,例如 "5" 或 "-1";兩者同時提供時必須與 duration 一致 |
resolution |
string | 1080P |
480P、720P、1080P;頂層的小寫值會被正規化 |
aspect_ratio |
string | adaptive |
adaptive、21:9、16:9、4:3、1:1、3:4、9:16 |
ratio |
string | 選填 | aspect_ratio 的別名;影片延伸時建議使用 adaptive |
size |
string | 選填 | 相容性別名:解析度等級,或支援的像素對應值(例如 1280x720);建議明確指定 resolution 與 ratio,而非任意像素尺寸 |
generate_audio |
boolean | 上游預設 true |
輸出是否包含音軌。明確指定 false 會被保留。音訊不會改變每秒費率 |
audio |
boolean | 選填 | generate_audio 的別名;請只使用一個音訊開關 |
prompt_extend |
boolean | true |
智慧提示詞改寫;明確指定 false 會被保留。文件/頁面輸入時必須為 true |
watermark |
boolean | 上游預設 false |
在輸出加上浮水印;明確指定 false 會被保留 |
seed |
integer | 隨機 | -1 或 0–2147483647。省略或設為 -1 會要求隨機種子;0 會原樣轉送。重複使用相同種子不保證輸出一致 |
input_reference |
string | 選填 | 第一幀圖片 URL;會取代原生媒體陣列。請勿混用輸入風格 |
images |
string[] | 選填 | 便利陣列,在 input_reference 不存在時以 reference_image 項目附加 |
metadata |
object | 選填 | 下列原生物件的容器;無法變更所選模型 |
metadata.input |
object | 選填 | 原生輸入物件 |
metadata.input.prompt |
string | 選填 | 原生提示詞覆寫;仍需保留必填的頂層 prompt |
metadata.input.media |
object[] | 選填 | 有序媒體陣列。每個項目必須有 type 與 url;限制請見下方 |
metadata.input.media[].type |
string | 每個項目必填 | first_frame、last_frame、reference_image、reference_video、reference_audio、file、link |
metadata.input.media[].url |
string | 每個項目必填 | 公開的 HTTP(S) 媒體 URL;圖片類型也接受 data:{MIME_type};base64,... 字串。非圖片媒體必須使用公開 URL |
metadata.parameters |
object | 選填 | 原生參數物件;不可為 null |
metadata.parameters.resolution |
string | 1080P |
大寫 480P、720P、1080P |
metadata.parameters.ratio |
string | adaptive |
同上列出的長寬比數值 |
metadata.parameters.duration |
integer | 5 |
2–30 或 -1;合併時長限制相同 |
metadata.parameters.audio |
boolean | 上游預設 true |
同輸出音訊開關 |
metadata.parameters.prompt_extend |
boolean | true |
同提示詞改寫開關;file/link 必須為 true |
metadata.parameters.watermark |
boolean | 上游預設 false |
同浮水印開關 |
metadata.parameters.seed |
integer | 隨機 | 相同種子範圍,包括明確指定 0 |
原生的 negative_prompt、img_url、first_frame_url、last_frame_url 與 audio_url 欄位並非 Wan 3 的媒體控制項。請改用文件所述的媒體陣列。
媒體限制與有效組合
| 媒體類型 | 數量與限制 |
|---|---|
first_frame、last_frame |
各最多一個。尾幀需要首幀。幀控制不能與任何參考、檔案或連結類型組合 |
reference_image |
最多 10 個。JPEG/JPG、無透明度的 PNG、BMP 或 WEBP;每邊 240–8,000 像素,長寬比最多 8:1,每個檔案最多 20 MB |
reference_video |
最多 5 個 MP4/MOV 片段;每個 1–15 秒,合計輸入最多 15 秒;至少 16 fps;每邊 240–4,096 像素,長寬比最多 8:1,每個檔案最多 100 MB |
reference_audio |
最多 5 個 WAV/MP3 片段;每個 1–15 秒,合計最多 15 秒;每個檔案最多 15 MB |
file |
最多一個 DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD 檔案;最多 100 MB。PDF、DOCX、DOC、PPTX、PPT 及 KEY/PAGES 分頁文件有 50 頁限制 |
link |
最多一個無需登入即可公開存取的頁面;不要與 file 組合 |
參考圖片、影片和音訊可以組合。檔案或連結可以伴隨參考媒體。首/尾幀模式僅接受幀控制;音訊驅動生成請使用參考圖片加參考音訊模式。媒體解析和內容審核仍受上游檢查約束。
文字轉影片使用不含媒體的提示詞。首幀動畫使用 first_frame;轉場使用 first_frame 加上 last_frame。參考生成使用參考類型。若要編輯或延伸,請提供 reference_video 並在提示詞中描述編輯或延伸;延伸請使用 adaptive。
範例
文字轉影片
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}'
首尾幀
{"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"}]}}}
參考圖片與音訊
{"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"}]}}}
影片編輯/延伸與智慧時長
{"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"}]}}}
文件/網頁
{"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"}]}}}
請將所有範例 URL 替換為真實的公開媒體。若為網頁輸入,請將 file 項目替換為 {"type":"link","url":"https://example.com/product"}。首幀範例也可在沒有其末幀項目的情況下運作。
回應、輪詢、下載與日誌
建立後會回傳 APIMaster 任務 ID,而非上游 ID:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| 回應欄位 | 意義 |
|---|---|
id / task_id |
查詢與下載所使用的平台任務識別碼 |
status |
queued、in_progress、completed、failed |
progress |
進度指示;請等待最終狀態 |
error.code、error.message |
適用時的失敗資訊 |
metadata.url |
完成時所回傳的內容位置 |
請使用相同的 API 金鑰,每約 15 秒輪詢一次。請勿建立另一個任務來檢查進度。原生供應商的任務 ID 與輸出 URL 會在 24 小時後過期;請及時下載並保留成功的結果。相較於儲存暫時性的上游 URL,建議優先使用 APIMaster 的已驗證內容端點。
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
使用量日誌包含該任務與成功的影片結果。完成後請檢查最終費用;受理並不代表生成成功。重複輪詢不會產生額外的生成費用。
計費
每秒費率請查看模型卡片。
APIMaster 將所有輸入影片的長度與輸出影片的長度相加,合計無條件進位一次,再乘以所選輸出解析度的每秒費率。輸入 2.3 秒、輸出 5 秒,按 8 秒收費。沒有輸入影片時只計輸出秒數。參考影片請求無須詢價或填寫輸入長度。生成失敗會退回預扣,最終金額可在使用記錄查看。
錯誤與修正
| 症狀 | 修正方式 |
|---|---|
| 無效的 duration/resolution/ratio | 使用上述的 enum 與範圍;smart duration 必須正好為 -1 |
| 影格/參考衝突,只有最後影格而缺少第一影格 | 遵循組合規則 |
| 檔案/連結加上已停用的重寫 | 設定 prompt_extend:true |
| 媒體取得/格式/時長失敗 | 使用符合所有大小、格式與時長限制的公開檔案 |
| 缺少 prompt | 為 APIMaster API 保留非空的頂層 prompt |
| 任務失敗或遭審核 | 檢查 error,然後修正請求;請勿將受理視為成功 |
