跳至主要内容

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 调用已保存的角色、参考素材和音频参考。

  • 视频输出
  • 1版本
  • 245每段视频消耗的 Gems(默认)
  • $0.245约合美元

概览

Wan 3.0 API 能做什么

阿里巴巴的全能模型 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 链接、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 支持参考图片或角色吗?
Wan 3.0 接受 first_image、last_image、image、additional_images、videos。Wan 3.0 支持在提示词中通过 @handle 调用已保存的角色、参考素材和音频参考。
可以在 Claude 或 ChatGPT 中使用 Wan 3.0 吗?
可以。把 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接说出 Wan 3.0 的名称即可。你的助手会通过 get_model 读取它的选项,并在生成前告知价格。
Wan 3.0 的生成结果会保存多久?
结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。

用 Mage 开始开发

一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。