Source: https://ailoot.ai/models/zh-hant-tw/alibaba-wan-2-7/ Canonical: https://ailoot.ai/models/zh-hant-tw/alibaba-wan-2-7/ Language: zh-hant-tw # Alibaba: Wan 2.7 [Markdown](https://ailoot.ai/models/zh-hant-tw/alibaba-wan-2-7/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/alibaba-wan-2-7/facts.json) ## [Alibaba: Wan 2.7](https://ailoot.ai/models/zh-hant-tw/alibaba-wan-2-7/) Alibaba Wan 2.7 可依文字、開場與結尾圖片，或視覺參考製作有聲影片。其圖片流程也可依要求的總時長延續來源片段。製造商列示 720p 或 1080p、30 fps 的 MP4：文字／圖片模式為 2–15 秒，參考生成最長為 10 秒。 - [**Ailoot Ultra · 影片** `POST /v1/videos` `alibaba/wan-2.7`](https://ailoot.ai/models/zh-hant-tw/alibaba-wan-2-7/#method-0) 關於模型 此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。 Alibaba Wan 2.7 是提供具名文字轉影片、圖片轉影片及參考引導規格的影片生成系列。原廠記載音訊同步場景及多鏡頭敘事，圖片流程則增加首尾影格生成與初始影片接續。實用成果是附帶聲音的短片，例如產品轉場、精簡故事，或能銜接既有鏡頭的接續片段。請依來源素材及對開頭、結尾所需的控制選擇模式。 文字轉影片需描述主體、場景、動作、攝影機、風格與聲音。分鏡可指出每鏡及時間範圍，單鏡頭簡述則應說明動作維持連續。Wan 2.7 提示詞指南讓模型從文字簡述解讀鏡頭結構，不使用 2.6 的 shot\_type 控制。目前文字 API 接受最多 5,000 個字元的中文或英文提示詞，另有 500 個字元的負面提示詞；超出文字會截斷。請在額度內清楚交代關鍵動作與約束。 首格圖片轉影片讓提供的開場圖片動起來。首尾影格生成也定義終點及連接兩端的動作。2.7 圖片指南支援在這些影格組合旁加入驅動音訊來源。請準備共享場景及預期主體的兩端圖片，並描述轉變，而非要求模型將兩張圖重新解讀成無關風格參考。輸出近似首張圖片比例；指南將解析度視為像素數量等級，並適當捨入編碼尺寸。 影片接續從來源短片開始，也可使用結尾圖片。要求片長指回傳影片總長，包括原始片段。指南範例將兩秒來源加上十秒新內容，組成十二秒結果。請準備來源最後動作，交代接下來發生什麼，讓攝影機與主體沿連貫方向接續。檢查接點的外觀、動作、光線與聲音，不要只評估新生成的結尾。 原廠目前獨立的參考規格使用圖片或影片引導角色、物件或場景。指南允許參考圖片與影片合計最多五份，使用 Image 1、Video 1 等類型專用標籤。請描述每份素材用途及預期互動。參考引導場景可讓一份參考中的角色，帶著另一份參考的物件穿越指定地點。參考構圖與首格生成不同：簡述可以建立新構圖，不必要求影片以某張提供的靜態圖片開場。 文字生成的自訂音訊格式為 WAV 與 MP3，長度二至三十秒，上限 15 MB。所選影片時長決定使用段落：較長音訊會裁到該片長，音訊短於影片時，其餘部分保持無聲。請準備確實屬於鏡頭的音訊段落，並為預期視覺動作預留空間。未提供音訊檔時，原廠描述會生成適合場景的背景音樂或音效；請連同畫面檢查實際聲音及所有要求的語音。 目前模型矩陣列出 720p 或 1080p、30 fps MP4，文字與圖片輸出為二至十五秒。獨立參考規格限於二至十秒。文字生成提供 16:9、9:16、1:1、4:3 與 3:4 構圖。受圖片約束的工作使用各自近似來源比例的規則，因此請依預期用途準備輸入裁切。參考規格的片長或比例規則，不應代替影格或接續流程的規則。 原廠文件流程採非同步處理：工作識別碼追蹤處理進度，成功結果提供影片位置。文件記載結果連結有效二十四小時，因此請保存實際短片與創意素材，供剪輯檢查。提示詞改寫、浮水印及種子選項屬於所選介面。原廠指出固定種子可改善可重現性，但不保證相同結果。請將回傳素材與簡述比較，不要假設僅靠設定就能保留所有細節。 相較 Wan 2.6，2.7 圖片指南透過多模態媒體輸入，明確增加首尾影格控制及影片接續。Wan 3.0 則引入不同的整合結構與更長生成額度。此 2.7 規格保留各工作專用控制及限制。請檢查整個場景的主體連續性、影格定位、參考身分、對話、動作與接點，並讓下一次修正針對實際發現的問題。 **Ailoot Ultra · 影片** `POST /v1/videos` `alibaba/wan-2.7` [`alibaba/wan-2.7`](https://ailoot.ai/models/zh-hant-tw/#m=alibaba%2Fwan-2.7&route=Ultra&caller=alibaba%2Fwan-2.7&fmt=videos) Alibaba /`alibaba/wan-2.7` ### 入門 Alibaba Wan 2.7 可依文字、開場與結尾圖片，或視覺參考製作有聲影片。其圖片流程也可依要求的總時長延續來源片段。製造商列示 720p 或 1080p、30 fps 的 MP4：文字／圖片模式為 2–15 秒，參考生成最長為 10 秒。 接受的輸入 文字 結果 影片 ### Ailoot 可用 · 輸入與方法 **Ailoot Ultra · 影片** `POST /v1/videos` 輸入 `text` 輸出 `video` 輸出格式 mp4 輸出數量 最多 4 輸出s | 欄位 | 類型 | 要求 | 值與限制 | 預設值 | | --- | --- | --- | --- | --- | | 欄位`model` | 類型`string` | 要求必填 | 值與限制 alibaba/wan-2.7 | 預設值— | | 欄位`prompt` | 類型`string` | 要求必填 | 值與限制 UTF-8 位元組數上限: 10,000 必須包含非空白字元: 是 | 預設值— | | 欄位`duration` | 類型`integer` | 要求必填 | 值與限制 2, 3, 4, 5, 6, 7, 8, 9, 10 | 預設值— | | 欄位`resolution` | 類型`string` | 要求必填 | 值與限制 720p | 預設值— | | 欄位`aspect_ratio` | 類型`string` | 要求必填 | 值與限制 16:9, 9:16, 1:1, 4:3, 3:4 | 預設值— | | 欄位`generate_audio` | 類型`boolean` | 要求必填 | 值與限制 false, true | 預設值— | 輸入素材組合 **文字生成影片** · 必填： prompt 方法參數與生命週期 | 參數 | 規格 | | --- | --- | | 參數`content_type` | 規格application/json | | 參數`required` | 規格model, prompt, duration, resolution, aspect\_ratio, generate\_audio | | 參數`additional_properties` | 規格false | | 參數`parameters` | 規格{"name":"model","type":"string","required":true,"enum":\["alibaba/wan-2.7"\]}, {"name":"prompt","type":"string","required":true,"non\_whitespace":true,"max\_utf8\_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":\[2,3,4,5,6,7,8,9,10\]}, {"name":"resolution","type":"string","required":true,"enum":\["720p"\]}, {"name":"aspect\_ratio","type":"string","required":true,"enum":\["16:9","9:16","1:1","4:3","3:4"\]}, {"name":"generate\_audio","type":"boolean","required":true,"enum":\[false,true\]} | | 參數`material_types` | 規格text | 方法別名： `/v1/videos/generations`, `/videos`, `/videos/generations` 生命週期： `submit_once_poll_original` `GET /v1/videos/{request_id}` `GET /v1/videos/generations/{request_id}` `GET /v1/videos/{request_id}/content` `GET /v1/videos/generations/{request_id}/content` 請保留完整回應與原始回傳的 ID。 切勿重新提交結果不明的建立請求。 ### 方案 ##### 最終費用的計算方式 顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。 費率資訊不會增加請求選項。支援的參數列於所選方法中。 快速模式 未指定 選取快速模式時 flex 模式 未指定 選取 flex 模式時 最高推理強度 未指定 最高推理強度採用 default 調整值時 #### 供比較的預估費率 #### 各設定的價格 請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。 | 設定 | 費率表 | 預估數量 | 音訊生成選項 | 解析度 | 計費單位 | 費用 | | --- | --- | --- | --- | --- | --- | --- | | 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 音訊生成選項— | 解析度— | 計費單位— | 費用 輸入 · 輸入 Token · 僅供比較的估算 **—** / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 **—** / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 **—** / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 **—** / 1K Token | | 設定Ultra | 費率表— | 預估數量指定的設定；僅為估算。 | 音訊生成選項不含音訊 · 含音訊 | 解析度720p | 計費單位每秒輸出影片 | 費用 輸出 · 預估影片秒數 · 僅供比較的估算 **$0.2** 每秒輸出影片 顯示的費率用於生成前預估費用。最終費用根據原始生成所記錄的費用計算。影片實際長度並非計費數量。 | | 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 音訊生成選項— | 解析度— | 計費單位— | 費用 輸出 · 預估生成費用 · 僅供比較的估算 **$0.4** 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 | Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/) #### 參考費率詳情 模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。 影片設定的價格參考 #### 各設定的價格 | 設定 | 計費條件 | 費用 | | --- | --- | --- | | 設定影片價格 | 計費條件此定價鍵未宣告額外條件。 | 費用 輸出 · 影片價格 **$0.2** 每秒影片 所示設定的公開價格參考。最終費用依實際計費設定計算。 | ### 請求範例 #### Ailoot Ultra · 影片 curl · 已設定的確切組態 ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "alibaba/wan-2.7", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}') Path('request.json').write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path('result.json').read_text()) print(json.dumps(r,ensure_ascii=False,indent=2)) print('Keep the complete JSON and response headers; do not resubmit an unknown creation.') PY_RESULT ``` ### 接收並儲存結果 #### Ailoot Ultra · 影片 mp4 - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/videos/generations/{request_id}/content` ##### 查看工作狀態 GET · 取得原始作業狀態 ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_STATUS_URL' import json from pathlib import Path from urllib.parse import quote r=json.loads(Path('result.json').read_text()) if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID') Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe='')) PY_STATUS_URL curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \ -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path('status.json').read_text()) print(json.dumps(r,ensure_ascii=False,indent=2)) print('Keep the complete JSON and response headers; do not resubmit an unknown creation.') PY_RESULT ``` 其他內容讀取方式 儲存所有已完成且屬於自己的輸出 ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_ASSETS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path('status.json').read_text()) if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job') if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied') urls=[] for i,u in enumerate(r.get('data',[])): if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape') urls.append((str(i),u)) for label,path in urls: u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u) if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL') target=Path('owned-'+label+'.bin') subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True) print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.') PY_ASSETS ``` ##### 保留所有已完成的結果 請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。 請保留每個已完成的 data\[\] 自有簽署 URL，以及完整狀態中繼資料。請儲存每個輸出，包括其生成的音訊。即使 generate\_audio=false，也可能包含有效的 AAC 音軌；請保留包含該音訊的完整原始 MP4。 ##### 需要檢查原始回應時 請讀取現有的原始作業；切勿重新提交傳送結果不明的請求。 輸出數量上限： 4. 回應欄位 | 欄位 | 類型 | 含義 | | --- | --- | --- | | 欄位`id` | 類型string | 含義— | | 欄位`object` | 類型string | 含義— | | 欄位`model` | 類型string | 含義— | | 欄位`status` | 類型string | 含義— | | 欄位`data[]` | 類型signed content URL | 含義— | | 欄位`charge_pending_check` | 類型boolean | 含義— | | 欄位`error.code` | 類型string | 含義— | | 欄位`error.message` | 類型string | 含義— | | 欄位`operation_id` | 類型string | 含義HTTP503 result\_pending\_check 的原始狀態／內容回應：id 使用相同的原始公開影片 ID。 | | 欄位`error.type` | 類型string | 含義HTTP503 result\_pending\_check 時的 server\_error。 | 錯誤與後續步驟 | 回應 | 條件 | 下一步 | | --- | --- | --- | | 回應400 · `invalid_request_error` | 條件在解析影片設定檔之前，讀取原始請求本文即已失敗 | 下一步請保留回傳的回應，並修正無法讀取的請求本文。 | | 回應422 · `price_unavailable` | 條件無法解析確切的影片設定檔，或完整解析後的設定檔沒有可用且完全相符的價格卡 | 下一步請保留回應，並使用完整、完全相符且獲准使用的設定檔與其公布價格卡。此分支會在傳送給供應商前執行。 | | 回應409 · `video_not_ready` | 條件原始結果內容尚無法取得 | 下一步請輪詢原始回傳的 ID，並遵守 Retry-After。 | | 回應`server_error` | 條件回傳的回應表示該作業或結果需要檢查 | 下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。 | | 回應503 · `result_pending_check` | 條件以 GET 取得原始狀態／內容：工作尚未發布、原始作業並非 failed/cancelled/expired，且符合以下其中一項：本機狀態為 unknown，或原始作業狀態為 completed。 | 下一步請保留原始 id 與 operation\_id（兩者為同一公開影片 ID）、回應與標頭；僅讀取原始狀態／內容。切勿提交新的生成請求。 | ### 別名 #### 模型別名 **Ailoot Ultra** [`alibaba/wan-2.7`](https://ailoot.ai/models/zh-hant-tw/#m=alibaba%2Fwan-2.7&route=Ultra&caller=alibaba%2Fwan-2.7&fmt=videos) #### 方法路徑別名 `/v1/videos/generations`, `/videos`, `/videos/generations` #### 相關呼叫用 ID [`alibaba/wan-2.7`](https://ailoot.ai/models/zh-hant-tw/#m=alibaba%2Fwan-2.7&route=Ultra&caller=alibaba%2Fwan-2.7&fmt=videos) FAQ · Alibaba: Wan 2.7 可以使用哪些輸入與結果？ `POST /v1/videos` · `alibaba/wan-2.7`: `text` → `video` 請求使用哪些欄位？ `POST /v1/videos` · `alibaba/wan-2.7`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio` 將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。 ## 公司及其專案組合 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 ## 優惠購買 token。 訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。 訂閱 為定期請求選擇優惠方案。 最高 50% 折扣碼 購買時輸入代碼，價格依活動重算。 歷史中的費用 每次請求保存模型、token 與金額。 [選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/) ## 將 API 加入 你銷售的產品。 依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。 商用應用程式 在付費功能加入文字、圖片、影片與聲音生成。 經銷授權 提供專案說明與存取方式，要求書面使用和轉售條件。 網站文件 串接前可閱讀正式服務條款、授權合約與資料處理政策。 [申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw) ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。