跳至主要內容

Mage API · 影片模型

Wan 3.0 API

Wan 3.0,內容過濾嚴格

POST https://api.mage.space/v1/wan_3/generate

重點速覽

Wan 3.0 API 透過 Mage 在 POST https://api.mage.space/v1/wan_3/generate 執行 Wan 3.0。以預設設定送出一次請求需要 245 Gems(約 $0.245),無需訂閱。Wan 3.0 可在提示詞中用 @handle 引用已儲存的 Characters、參考素材與音訊參考。

  • 影片輸出
  • 1版本
  • 245預設每段影片所需 Gems
  • $0.245約合美元

總覽

Wan 3.0 API 能做什麼

Alibaba 推出的全能型 Wan 3.0。支援起始與結束影格、最多 10 個參考素材或 Characters、Voices 和音訊,可生成 2 到 30 秒、最高 1080p 的影片。嚴格過濾:適用供應商的內容過濾機制。

阿里巴巴的 Wan 3.0,一個影片模型即可支援文字、影格、參考圖片、參考影片和 Voices,可生成 2 到 30 秒並附帶生成音訊的影片。嚴格過濾:供應商的內容過濾機制會檢查提示詞、輸入的媒體和完成的影片;若請求遭拒,會以 `content_blocked` 及原因回報失敗,並退還費用。

接受 first_image、last_image、image、additional_images、videos 作為輸入。

快速開始

呼叫 Wan 3.0 API

設定 MAGE_API_KEY,送出請求到 /wan_3/generate,然後輪詢 status_url,直到請求完成。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/wan_3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "wan-3.0"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('wan_3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'wan-3.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("wan_3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "wan-3.0",
})

print(request["result"]["url"])

模型

Wan 3.0 的 model_id 值

傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。

model_id名稱預設
wan-3.0Wan 3.0是

選項

Wan 3.0 參數

以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。

欄位可用值
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 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

輸入

Wan 3.0 支援的媒體輸入

每個輸入可使用 https URL、data URL,或上傳最大 100 MB 的檔案。

欄位用途
first_image第一格畫面的圖片。
last_image尾幀圖片。
image參考圖片。
additional_images其他參考圖片。
videos來源影片。

規則

Wan 3.0 API 的限制

  • 首幀和尾幀不能與參考圖片或參考影片同時使用:只能擇一傳送。
  • 最多 10 張參考圖片和 5 部參考影片。
  • 每部參考影片長度為 1 到 15 秒,總長度最多 15 秒,且總長度加上 `duration` 最多 30 秒。參考影片的秒數與輸出秒數按相同方式計費。

更多影片模型

Mage 上的其他影片生成 API

  • 影片 · 40 Gems 起

    Wan Video v2.2 API

    開放權重影片模型,提供 Lightning 版本

  • 影片 · 189 Gems 起

    Berry API

    忠實呈現你的參考素材的影片

  • 影片 · 360 Gems 起

    Blueberry API

    鎖定首幀與尾幀

  • 影片 · 每次 618 Gems 起

    Cherry API

    我們的旗艦影片系列

  • 影片 · 375 Gems 起

    Grok Video API

    讓 Grok Imagine 動起來

  • 影片 · 270 Gems 起

    Kiwi API

    日常影片,免設定

常見問題

常見問題

Wan 3.0 API 的費用是多少?
以預設設定(Wan 3.0)送出一次 Wan 3.0 請求需要 245 Gems,約 $0.245。其他解析度、長度和版本會影響價格,實際扣款金額會顯示在回應中。生成失敗會退款;若因違反 Mage 內容政策而被封鎖,則不予退款。
Wan 3.0 API 的端點是什麼?
使用 POST https://api.mage.space/v1/wan_3/generate,並在 Authorization: Bearer 標頭中帶入你的 Mage API 金鑰。回應會包含 status_url,可用來輪詢結果。
我可以呼叫哪些 Wan 3.0 模型?
wan-3.0(Wan 3.0)。預設為 Wan 3.0。
Wan 3.0 支援參考圖片或 Characters 嗎?
Wan 3.0 接受 first_image、last_image、image、additional_images、videos。Wan 3.0 可在提示詞中用 @handle 引用已儲存的 Characters、參考素材與音訊參考。
我可以在 Claude 或 ChatGPT 中使用 Wan 3.0 嗎?
可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,直接指定使用 Wan 3.0 即可。你的助理會用 get_model 讀取可用選項,並在生成前告知價格。
Wan 3.0 的生成結果會保留多久?
結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。

開始使用 Mage 打造你的作品

一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。