模型

Alibaba: Wan 2.7

Markdown · JSON

Alibaba: Wan 2.7

Alibaba Wan 2.7 可依文字、開場與結尾圖片,或視覺參考製作有聲影片。其圖片流程也可依要求的總時長延續來源片段。製造商列示 720p 或 1080p、30 fps 的 MP4:文字/圖片模式為 2–15 秒,參考生成最長為 10 秒。

關於模型

此說明介紹模型的能力。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

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 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

參考費率詳情

模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。

影片設定的價格參考

各設定的價格

設定計費條件費用
設定影片價格計費條件此定價鍵未宣告額外條件。費用
輸出 · 影片價格 $0.2 每秒影片

所示設定的公開價格參考。最終費用依實際計費設定計算。

請求範例

Ailoot Ultra · 影片

curl · 已設定的確切組態
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 · 取得原始作業狀態
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
其他內容讀取方式
儲存所有已完成且屬於自己的輸出
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

方法路徑別名

/v1/videos/generations, /videos, /videos/generations

相關呼叫用 ID

alibaba/wan-2.7

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 與金額。

選擇訂閱 · 查看模型價格

將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人;轉售請申請經銷授權。

商用應用程式
在付費功能加入文字、圖片、影片與聲音生成。
經銷授權
提供專案說明與存取方式,要求書面使用和轉售條件。
網站文件
串接前可閱讀正式服務條款、授權合約與資料處理政策。

申請經銷授權 · 正式服務條款與授權合約