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.0 | Wan 3.0 | 是 |
选项
Wan 3.0 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 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 |
输入
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
Wan Video v2.2 API
开放权重视频模型,含 Lightning 版本
Berry API
忠实还原你的参考内容的视频
Blueberry API
锁定首帧和尾帧
Cherry API
我们的旗舰视频系列
Grok Video API
动起来的 Grok Imagine
Kiwi API
日常视频,无需任何设置
常见问题
常见问题解答
Wan 3.0 API 费用是多少?
Wan 3.0 API 的端点是什么?
可以调用哪些 Wan 3.0 模型?
Wan 3.0 支持参考图片或角色吗?
可以在 Claude 或 ChatGPT 中使用 Wan 3.0 吗?
Wan 3.0 的生成结果会保存多久?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。