模型

Alibaba: Wan 3.0 Prime

Markdown · JSON

Alibaba: Wan 3.0 Prime

Alibaba Wan 3.0 Prime 是針對速度最佳化的 Wan 3.0 影片模型。原廠規格支援文字、首格、首尾影格生成及多模態參考,並整合聲音。它輸出 2–30 秒、30 fps 的 MP4,提供 480p、720p 或 1080p,以及自適應構圖與編輯流程。

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。

Alibaba Wan 3.0 Prime 是 Wan 3.0 影片系列的加速版。製造商將它命名為 wan3.0-video-prime,文件記載的整合式任務類別與標準 Wan 3.0 相同,速度是此版本特別強調的差異。文字製作簡報、起始圖片、視覺或音訊參考素材,或原始影片,都能引導產生帶有聲音的片段。實用成品包括商品場景、短篇敘事片段、動態化靜態圖片,或依明確指示修改的既有鏡頭。

從文字生成影片時,請描述主體、場景、動作、鏡頭、視覺處理方式與聲音。3.0 指南支援單一鏡頭,也支援標有鏡頭名稱與時間區間的分鏡,建議每個鏡頭約四至六秒。商品短片可以從桌上包袋的穩定廣角畫面,移至較近的材質細節,最後固定構圖並說出一句短台詞。讓整段影片有一個清楚的目的,並檢查鏡頭、節奏與商品辨識特徵是否一致。

以首幀生成時,提供的圖片決定開場,提示詞描述動作與鏡頭運動。首尾幀生成則提供兩個端點,要求產生其間的轉換。請準備屬於同一場景的端點圖片,以及符合預期輸出的畫面形狀。製造商建議圖片任務使用自適應構圖。端點模式與另外的參考模式有不同的素材組合規則:同一個請求不能將首幀或尾幀與參考圖片、參考影片或參考音訊混用。

參考模式可接受最多十張圖片、五段影片與五段音訊,多模態參考素材總數不得超過二十份。文件記載的單檔上限為參考圖片 20 MB、影片 100 MB、音訊 15 MB。參考影片合計最長十五秒;參考音訊另有合計十五秒的額度。請說明每份素材的角色,並使用各類型自己的索引,例如 Image 1、Video 1 或 Audio 1。人物、商品、鏡頭運動與聲音不應被當成可以互換的參考素材。

製造商也支援一份文件或一個公開網頁作為參考,並可與其他參考素材搭配使用。檔案與網頁連結不能同時提供,來源也必須不需登入即可存取。以文件為基礎的場景可用相關商品或故事內容提供背景,再由視覺參考決定外觀。請準備真正需要影響片段的資料,並說明哪些元素重要。將生成場景中涉及事實的視覺細節與文字對照該來源檢查,不要只因呈現好看就接受內容已改變的版本。

語音對話、環境音、音效與背景音樂會和畫面一起生成。請描述台詞、說話者身分、表達方式,以及聲音在場景中的位置與作用。指南記載音訊預設啟用,並提供無聲影片控制。對話中,為每位說話者指定獨特的視覺與聲音線索,並留足交流時間。聆聽成品,檢查實際措辭、台詞歸屬,以及音效與可見動作的關係。整合音訊是場景的一部分,因此需要和畫面一樣仔細檢查。

製造商的整合式指南也記載從參考影片進行編輯與延伸。編輯簡報應指出要加入、移除或替換的元素,以及必須保留的特徵。延伸簡報應描述既有片段之前、之後或周邊的內容。這些流程使用自適應構圖與智慧時長。提供影片輸入時,文件規定輸入與輸出影片的合計時長不得超過 30 秒。請清楚準備原始片段與預期修改;檢查轉場、保留的主體與聲音,而不是只看一個吸引人的畫格。

文件記載的輸出為 30 fps 的 MP4,可選 480p、720p 或 1080p,新生成影片時長為二至三十秒。智慧時長讓模型選擇合適長度。可使用正方形、橫式與直式構圖,自適應構圖則依提供素材調整。製造商以工作任務處理生成,並回傳完成影片的位置;指南指出該結果位置有效期為二十四小時。準備編輯或連續片段時,保留實際影片與製作簡報,並在使用前檢查完整成品。

Prime 與標準 Wan 3.0 共用文件記載的模式與準備結構。Prime 是偏重速度最佳化的選擇,並不保證固定完成時間。較早的 Wan 2.7 與 2.6 模式各有時長、參考素材及輸出規則,其限制不能用來定義此 3.0 版本。實用的檢查應涵蓋物體與角色連續性、端點構圖、要求的編輯、對話,以及依賴來源的細節。將下一次修正限定在具體問題,讓場景中成功的元素維持穩定,同時修正已確認的問題。

Ailoot Ultra · 影片 POST /v1/videos alibaba/wan-3.0-prime

alibaba/wan-3.0-prime

Alibaba /alibaba/wan-3.0-prime

入門

Alibaba Wan 3.0 Prime 是針對速度最佳化的 Wan 3.0 影片模型。原廠規格支援文字、首格、首尾影格生成及多模態參考,並整合聲音。它輸出 2–30 秒、30 fps 的 MP4,提供 480p、720p 或 1080p,以及自適應構圖與編輯流程。

接受的輸入
文字 · 圖片
結果
影片

Ailoot 可用 · 輸入與方法

Ailoot Ultra · 影片 POST /v1/videos
輸入
text, image
輸出
video
輸出格式
原始 MP4 位元組;不進行正規化或轉碼
欄位類型要求值與限制預設值
欄位model類型string要求必填值與限制
alibaba/wan-3.0-prime
預設值—
欄位prompt類型string要求必填值與限制預設值—
欄位duration類型integer要求必填值與限制
2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
最小值: 1
最大值: 600
預設值—
欄位resolution類型string要求選填值與限制
480p, 720p, 1080p
預設值—
欄位aspect_ratio類型string要求選填值與限制
16:9, 4:3, 1:1, 3:4, 9:16
預設值—
欄位generate_audio類型boolean要求選填值與限制
false, true
預設值—
欄位frame_images類型array要求選填值與限制
項目數下限: 1
項目數上限: 1
輸入內容: 影格物件陣列。每個物件包含 type=image_url、內含 url 的 image_url,以及 frame_type。請使用 HTTPS 圖片 URL,並將 frame_type 設為 first_frame。每種影格角色最多只能出現一次。
確切鍵名: type, image_url, frame_type
條件: 這些鍵描述每個影格物件;image_url 僅包含 url。僅含文字的請求請省略 frame_images。
預設值—
欄位input_references類型array要求選填值與限制預設值—
欄位seed類型integer要求選填值與限制
最小值: -9,223,372,036,854,775,808
最大值: 9,223,372,036,854,775,807
預設值—
欄位callback_url類型string要求選填值與限制
模式: ^https://
預設值—
欄位session_id類型string要求選填值與限制預設值—
欄位trace類型object要求選填值與限制預設值—
欄位user類型string要求選填值與限制預設值—
輸入素材組合

文字生成影片 · 文字提示詞。 · 必填: model, prompt, duration

請以文字提供 prompt,並以整數秒提供 duration。請選擇支援的解析度;如有需要,也請指定長寬比。

model: 類型: string · alibaba/wan-3.0-prime

prompt: 類型: string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是

圖片生成影片 · 文字提示詞與首格圖片。 · 必填: model, prompt, duration, frame_images

frame_images 是陣列。每個影格物件包含 type、image_url 與 frame_type;image_url 內含 url。請將 type 設為 image_url,並使用 first_frame。每種影格角色最多只能出現一次。請為每個影格提供公開的 HTTPS 圖片 URL,並選擇支援的解析度;如有需要,也請指定長寬比。

確切鍵名: type, image_url, frame_type

model: 類型: string · alibaba/wan-3.0-prime

prompt: 類型: string · UTF-8 位元組數上限: 10,000 · 必須包含非空白字元: 是

方法參數與生命週期
參數規格
參數content_type規格application/json
參數required規格model, prompt, duration
參數material_types規格text, image
參數additional_properties規格false
參數optional_controls規格resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

生命週期: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

方案

最終費用的計算方式

顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。

費率資訊不會增加請求選項。支援的參數列於所選方法中。

快速模式
未指定 選取快速模式時
flex 模式
未指定 選取 flex 模式時
最高推理強度
未指定 最高推理強度採用 default 調整值時

供比較的預估費率

各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

設定費率表預估數量計費單位計費條件費用
設定基礎 token 費率費率表基本費率預估數量—計費單位—計費條件—費用
輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token
輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token
輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token
輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token
輸入 · 寫入快取,1 小時 · 僅供比較的估算 — / 1K Token
設定影片價格費率表—預估數量—計費單位每秒影片計費條件resolution: 1080p費用
輸出 · 影片價格 · 僅供比較的估算 $0.56 每秒影片
設定影片價格費率表—預估數量—計費單位每秒影片計費條件resolution: 480p費用
輸出 · 影片價格 · 僅供比較的估算 $0.136 每秒影片
設定影片價格費率表—預估數量—計費單位每秒影片計費條件resolution: 720p費用
輸出 · 影片價格 · 僅供比較的估算 $0.28 每秒影片
設定預估生成費用費率表—預估數量單次生成估算值計費單位—計費條件—費用
輸出 · 預估生成費用 · 僅供比較的估算 $0.272 生成前估算

此估算並非額外費用,也不是本次生成完成後的固定費率。

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

參考費率詳情

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

影片設定的價格參考

各設定的價格

請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。

設定計費條件費用
設定影片價格計費條件resolution: 480p費用
輸出 · 影片價格 $0.136 每秒影片

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

設定影片價格計費條件resolution: 720p費用
輸出 · 影片價格 $0.28 每秒影片

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

設定影片價格計費條件resolution: 1080p費用
輸出 · 影片價格 $0.56 每秒影片

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

請求範例

Ailoot Ultra · 影片

curl · 建立影片
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"alibaba/wan-3.0-prime","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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 · 影片

自有內容的簽署 URL

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_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 取得素材。

請保留每個實際的自有輸出,以及回傳的實測中繼資料。

需要檢查原始回應時

503 result_pending_check + 原始 id + X-Should-Retry:false;切勿重送原始請求

回應欄位
欄位類型含義
欄位index類型integer含義此影片在輸出清單中的位置,索引從零開始。
欄位content_url類型string含義此已完成影片的簽署 HTTPS 下載 URL。
欄位sha256類型string | null含義原始影片位元組的 SHA-256 摘要;無法取得時為 null。
欄位size_bytes類型integer | null含義原始影片檔案大小,以位元組為單位;無法取得時為 null。
欄位duration_ms類型integer | null含義實測的影片長度,以毫秒為單位;無法取得時為 null。
欄位width類型integer | null含義影片寬度,以像素為單位;無法取得時為 null。
欄位height類型integer | null含義影片高度,以像素為單位;無法取得時為 null。
欄位video_codec類型string | null含義影片編碼識別碼;未記錄時為 null。
欄位has_audio類型boolean | null含義影片是否包含音軌;未測量時為 null。
欄位audio_codec類型string | null含義音訊編碼識別碼;未記錄識別碼時為 null。
錯誤與後續步驟
回應條件下一步
回應404 · not_found_error條件無法存取影片,或找不到此影片 ID。下一步請確認影片存取權限。若影片已存在,請使用其原始公開 ID 與相同的 API 金鑰。
回應401 · authentication_error條件API 金鑰與已驗證的帳號不符。下一步提交前,請先確認 API 金鑰與帳號存取權限。
回應400 · invalid_request_error條件無法讀取請求,或下載索引無效。下一步請修正請求本文。若要下載,請選擇原始工作回傳的輸出索引。
回應422 · price_unavailable條件所選影片設定無法定價。下一步請選擇支援的影片設定,填妥其必要選項,再提交修正後的請求。
回應422 · invalid_request_error條件影片輸入或原始延續工作無效。下一步請使用有效的 HTTPS 輸入。若要延續影片,請使用已完成原始影片的公開影片 ID,以及相同的 API 金鑰。
回應402 · billing_error條件可用餘額或限制不允許預留額度。下一步傳送新的請求前,請先確認可用餘額與限制。
回應503 · server_error條件影片驗證、儲存系統或服務存取暫時無法使用。下一步請等待服務恢復可用。若已有影片 ID,請查詢該原始工作,切勿另行建立生成工作。
回應503 · result_pending_check條件原始影片結果與費用需要查核。下一步請保留回傳的影片 ID,並查詢該工作。查詢期間切勿傳送替代的生成請求。
回應503 · owned_result_unavailable條件現有影片暫時無法下載。下一步請稍後查詢同一影片工作,並下載其現有輸出。新的生成請求會建立獨立操作。
回應409 · video_not_ready條件影片內容尚未發布。下一步請查詢原始工作狀態。回報 completed 後再下載;若回報 failed,請依其費用查核通知處理。

別名

模型別名

Ailoot Ultra alibaba/wan-3.0-prime

方法路徑別名

請使用上方列出的 API 方法路徑。

相關呼叫用 ID

alibaba/wan-3.0-prime

FAQ · Alibaba: Wan 3.0 Prime
可以使用哪些輸入與結果?

POST /v1/videos · alibaba/wan-3.0-prime: text, image → video

請求使用哪些欄位?

POST /v1/videos · alibaba/wan-3.0-prime: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

適用哪些限制?

POST /v1/videos · alibaba/wan-3.0-prime: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 1; frame_images.min_items: 1; seed.minimum: -9223372036854775808; seed.maximum: 9223372036854775807

更多詳情

將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。

公司及其專案組合

公司及其專案組合:數百萬客戶,每月銷售額達數十億。

優惠購買 token。

訂閱優惠適合持續工作,折扣碼購買 token 最高可折 50%。

訂閱
為定期請求選擇優惠方案。
最高 50% 折扣碼
購買時輸入代碼,價格依活動重算。
歷史中的費用
每次請求保存模型、token 與金額。

選擇訂閱 · 查看模型價格

將 API 加入 你銷售的產品。

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

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

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