Wan 2.2 I2V Fast API 接入指南
先看結論 · Wan 2.2 I2V Fast 在 MaxAPI 影片生成 API 使用 wan-video/wan-2.2-i2v-fast。提交後保存任務 ID，並輪詢取得最終結果；受理不等於完成。可用素材、時長與解析度需依此模型項目和所選路由確認。
接入規則核對 ·
依 MaxAPI 公開目錄、網關實作與本地回歸案例核對。共用網關核驗不代表已逐個模型進行端到端測試。這是接入參考，不是上游即時可用性或效能報告。
接入前必讀
以下參數依據 MaxAPI 公開配置；所選路由可能另有輸入或權限要求。
- 請求模型 ID
wan-video/wan-2.2-i2v-fast- 輸出類型
- 影片
- Base URL
https://api.maxapi.dev- 生成方式
- 非同步任務＋輪詢
- 品質參數
480p / 720p- 解析度與尺寸
- 480p／720p · 依輸入圖片的長寬比
- 影片長度
- 81–121 幀、5–30 fps（預設 81 幀、16 fps，約 5 秒）
僅支援圖片生成影片：以公開 https 網址或 data:image/ URI 傳入一張首幀圖片（image_url），可另加尾幀（last_frame_url）。不接受文字生成影片、參考影片、音訊、aspect_ratio 與 duration；影片長度為 num_frames ÷ frames_per_second。任務提交成功不代表影片已完成。
模型特點與選型
快速的圖片生成影片草稿
Wan 2.2 I2V Fast 是 PrunaAI 優化的 Wan 2.2 A14B 圖片生成影片版本，透過 Replicate 提供。本站提供 480p 或 720p 的圖片生成影片（可加尾幀），81–121 幀、無音訊。官方路由按影片計價：480p 0.05 積分、720p 0.11 積分（插幀至 30 fps 時為 0.065／0.145）。
資料核對 ·
此模型的資料來源: Replicate · Wan 2.2 I2V Fast API schema
何時值得選擇它
適合從現有圖片快速製作動作草稿、簡單運鏡，以及兩張圖之間的轉場。先用 480p 試稿，再以 720p 輸出選定的提示詞。
限制與注意事項
不提供文字生成影片、音訊、參考影片或長寬比設定，輸出依輸入圖片。影片較短（預設約 5 秒，121 幀約 7.5 秒）。本站尾幀測試中，畫面大部分時間停留在首幀場景、接近結尾才轉換，請逐幀檢查轉場。
供應商能力描述的是模型本身，不等於 MaxAPI 已開通全部功能。本站接入以此入口列出的參數、輸入類型和路由為準；供應商的速度、品質定位不是服務保證。
MaxAPI 實際如何處理請求
究竟使用哪條路由？
路由優先順序為：API Key 已配置的 route_modes 列表 → 請求明確指定的路由 → 模型預設路由。Key 列表非空時，優先於請求中的 route_mode。測試特定路由前，先確認 Key 配置；只修改請求參數，不一定會切換實際使用的路由。
使用者 RPM 由旗下 Key 共同使用
使用者設定的有效 RPM 上限，由旗下 API Key 共同使用。Key 可以設得更嚴格，但 Key 上限高於使用者時，仍不能突破使用者限制。例如使用者 200 RPM，不代表每個 Key 都各有 200 RPM。全站 RPM 與並發控制仍另外生效，增加 Key 不是繞過限制的方法。
路由與價格
公開路由：official。圖片／影片 JSON 請求可指定 route_mode；Gemini 原生請求使用 X-MaxAPI-Route-Mode。路由代表接入與計費選擇，不是另一個公開模型 ID。
| 路由 | 公開基礎價格 | 計費單位 |
|---|---|---|
official | $0.05 | 480p · 每段影片 |
official | $0.11 | 720p · 每段影片 |
official | $0.065 | 480p + 插幀至 30 fps · 每段影片 |
official | $0.145 | 720p + 插幀至 30 fps · 每段影片 |
1 積分 = 1 美元。此處為目錄基礎價格，並非帳戶即時報價；最終消耗依帳戶倍率與生效計費配置結算。Token 單價不等於每張圖片固定價格。
查看即時價格第一次呼叫
建立 MaxAPI API Key，並在服務端設定 MAXAPI_KEY，勿放入瀏覽器程式碼。Key 已設定的路由列表優先，即使請求另有指定；列表為空時才採用請求路由，都未指定則使用模型預設。API 呼叫可能產生費用。
POST /v1/videos/generationsGET /v1/videos/generations/{task_id}
# The create call returns {"id":"task_...","poll_url":"/v1/videos/generations/task_..."}. Poll that URL.
curl -X POST "https://api.maxapi.dev/v1/videos/generations" \
-H "Authorization: Bearer $MAXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-video/wan-2.2-i2v-fast",
"prompt": "slow camera push-in, soft light moving across the scene",
"route_mode": "official",
"image_url": "https://your-cdn.com/first-frame.png",
"resolution": "480p",
"num_frames": 81,
"frames_per_second": 16
}'第一次呼叫的驗收清單
請求合約核對 ·
依公開目錄與網關程式核對；範例只說明資料結構，不是付費模型實測、延遲測量，也不保證每條路由目前可用。
先確認請求欄位
model / image_url- 傳入 wan-video/wan-2.2-i2v-fast、prompt 與首幀 image_url（公開 https 網址或 data:image/ URI）。只有兩張圖轉場時才加 last_frame_url；沒有 mode、文字生成影片或參考影片欄位。
resolution / num_frames / frames_per_second- 範例要求 480p、81 幀、16 fps（約 5 秒）。不要傳 aspect_ratio 或 duration：輸出依輸入圖片比例，長度為 num_frames ÷ frames_per_second。價格只取決於解析度與 interpolate_output。
HTTP 202 / id / poll_url- 提交成功回傳的是任務收據，不是影片。關閉客戶端前保存 id 與 poll_url；JSON 識別欄位為 id，不是 task_id。
再確認實際結果
status / video- 使用同帳戶認證輪詢。queued/running 尚未完成；succeeded 時讀取頂層 video URL。failed/canceled 時檢查 message，不要假設已有可用檔案。
estimated_charge_credits- 收據是預估費用，不是最終帳單。以最終用量與帳務記錄核對；任務完成與成功下載影片也應分開確認。
{
"id": "example-task-id",
"object": "video.generation.task",
"status": "queued",
"model": "wan-video/wan-2.2-i2v-fast",
"poll_url": "/v1/videos/generations/example-task-id"
}# Set TASK_ID to the saved response.id; this queries, it does not create a task.
curl --fail-with-body "https://api.maxapi.dev/v1/videos/generations/${TASK_ID:?Set TASK_ID from response.id}" \
-H "Authorization: Bearer $MAXAPI_KEY"先看現象，再判斷錯誤原因
429rate_limit_exceeded / capacity_exhausted
- 如何判斷
- 429 可能來自使用者／Key RPM、全站容量，或生成容量不足。結合 Retry-After 與回傳的 X-RateLimit-*／X-Global-* 標頭判斷；單一狀態碼不能代表唯一原因。
- 下一步處理
- 有 Retry-After 時依其等待，按原因降低發送速率或同時處理數，使用有限次退避重試。全站容量不等於單一帳戶可獨占的額度。
應用場景與工作方式
下方場景與提示詞是本站建議的評估方向，不是供應商評分或實測成果。
AI 生成的概念配圖，並非此模型的實測成果或效果評測。下方提示詞供起步參考，不代表能重現配圖。
創作實踐・共通製作建議
先寫清楚一個鏡頭，而不是堆疊特效
使用 Wan 2.2 I2V Fast 時，先確定一個主體、一個場景和一種運鏡意圖，再補充動作。例如商品揭幕可以從材質細節緩慢拉遠，生活情境則可以固定鏡頭，讓人物完成一個自然動作。不要讓短片段同時負擔多個場景切換、視角與複雜事件；清楚的單鏡頭需求更方便判斷成果，也更容易接到後續剪輯。
配圖只展示可能的視覺方向，不是影片模型的生成成果。選定方向後，將需求寫成時間順序：起始畫面呈現什麼、中間改變什麼、結尾要留下什麼資訊。驗收時應看完整片段的動作連貫、物體形狀與構圖，不只檢查封面；素材模式與欄位也必須依此模型文件設定，不要套用其他模型的參數。
可以直接改寫的提示詞範例
好的提示詞是一份小型創作需求：主體是什麼、要做什麼、哪些不能改。將範例換成自己的素材與用途；尺寸、路由和品質仍應在 API 參數指定，不要只寫在文字裡。
01 / 商品的緩慢推近鏡頭
鏡頭緩慢推近香水瓶，柔和光線掠過後方的緞面。保持瓶身與標籤不變，鏡頭穩定、不要剪接。生成後檢查 · 確認瓶身在各幀保持形狀，且動作沒有突然跳動。
從分鏡到可用片段
先寫驗收標準
選出具代表性的輸入，說明結果達到什麼程度才算可用。除了理想範例，也加入困難案例；比較期間固定請求參數，避免同時改變太多條件。
分開處理執行與呈現
保存請求識別碼與原始回應，再轉換成介面需要的格式。明確處理錯誤和不完整结果，介面逾時不應在背景悄悄觸發重複任務。
衡量可用成果，不只看呼叫成功
記錄模型、路由、輸入特徵、實際用量與審核結果。估算交付一份可用成果的成本時，也應計入人工修正與重複嘗試，而不只看單次 API 價格。
從測試到正式接入
測試實際準備使用的路由
首次比較時固定模型、路由與參數。除了常用素材，也測試大檔與特殊輸入。模型公開能力不代表每個上游渠道都能接受所有邊界情況。
區分限流與生成錯誤
遇到 429 時降低請求速率或並發，退避後再試；輸入無效應先修正素材。排查時保存請求與任務 ID，勿把 API Key 或敏感參考素材寫入公開日誌。
追蹤可用結果與實際消耗
以帳戶用量與帳務記錄確認最終結果與消耗。HTTP 成功回應可能只是任務受理，並非最終輸出。正式發布前，請檢查生成文字、視覺細節與參考素材使用權。
已核驗的接入案例
依 MaxAPI 公開目錄、網關實作與本地回歸案例核對。共用網關核驗不代表已逐個模型進行端到端測試。這是接入參考，不是上游即時可用性或效能報告。
多個 Key 共用使用者上限
本地回歸・通過- 驗證條件
- 使用同帳戶的兩個 Key，在記憶體測試限流器中設定較小的使用者額度。
- 實際驗證結果
- 兩個 Key 的請求消耗相同使用者額度，超出後被限流；Key 額度較大不能覆蓋使用者上限，較小的 Key 額度仍有效。
常見問題
什麼情況應選擇此模型？
適合從現有圖片快速製作動作草稿、簡單運鏡，以及兩張圖之間的轉場。先用 480p 試稿，再以 720p 輸出選定的提示詞。
此模型入口有哪些特別需要注意的限制？
不提供文字生成影片、音訊、參考影片或長寬比設定，輸出依輸入圖片。影片較短（預設約 5 秒，121 幀約 7.5 秒）。本站尾幀測試中，畫面大部分時間停留在首幀場景、接近結尾才轉換，請逐幀檢查轉場。
為什麼改了 route_mode，路由卻沒變？
路由優先順序為：API Key 已配置的 route_modes 列表 → 請求明確指定的路由 → 模型預設路由。Key 列表非空時，優先於請求中的 route_mode。測試特定路由前，先確認 Key 配置；只修改請求參數，不一定會切換實際使用的路由。
每個 API Key 都有完整的使用者 RPM 額度嗎？
使用者設定的有效 RPM 上限，由旗下 API Key 共同使用。Key 可以設得更嚴格，但 Key 上限高於使用者時，仍不能突破使用者限制。例如使用者 200 RPM，不代表每個 Key 都各有 200 RPM。全站 RPM 與並發控制仍另外生效，增加 Key 不是繞過限制的方法。
這些本地回歸案例能證明線上模型效能嗎？
本地測試使用模擬請求、回應與測試儲存，不呼叫付費模型渠道。它們驗證請求處理，不驗證模型畫質、線上成功率、延遲，也不代表參考圖上限已端到端測通。頁面其他位置的概念配圖，不是這些測試的輸出。
Wan 2.2 I2V Fast 應填哪個模型 ID？
使用 wan-video/wan-2.2-i2v-fast。請依範例的端點格式傳入；Gemini 原生網址使用短模型名稱。
頁面價格適用所有帳戶和路由嗎？
1 積分 = 1 美元。此處為目錄基礎價格，並非帳戶即時報價；最終消耗依帳戶倍率與生效計費配置結算。Token 單價不等於每張圖片固定價格。
失敗請求會扣積分嗎？
MaxAPI 公開規則為失敗請求不計費。處理期間可能暫時預留餘額，請以任務最終結果與帳務記錄核對，不要將暫時餘額變動當作最終消耗。
為什麼我的 API Key 不能使用某條路由？
路由是否可用，取決於模型、帳戶權限與 API Key 允許的路由。公開列出價格不代表已取得權限；修改 route_mode 前請先確認帳戶和金鑰配置。
處理結果前應確認什麼？
僅支援圖片生成影片：以公開 https 網址或 data:image/ URI 傳入一張首幀圖片（image_url），可另加尾幀（last_frame_url）。不接受文字生成影片、參考影片、音訊、aspect_ratio 與 duration；影片長度為 num_frames ÷ frames_per_second。任務提交成功不代表影片已完成。
失敗或逾時後要立即重試嗎？
先分辨是限流、輸入錯誤，還是任務仍在執行。已有任務 ID 時，先查狀態再決定是否重新生成。僅對可重試錯誤使用有次數限制的退避重試。