Mage API · 视频生成
AI 视频生成 API,支持文字或图片生成
15 个模型支持文生视频、图生视频、首尾帧生视频和参考生视频,以 Mage 旗舰模型 Cherry 2 Pro 为首,许多视频还带有音频。
POST https://api.mage.space/v1/{model}/generate一览
Mage 视频生成 API 是位于 https://api.mage.space/v1 的 REST API,可运行 15 个文生视频和图生视频模型,包括 Cherry 2 Pro、Lemon、Plum、Melon、MiniMax-H3、Grok Video 和 Wan。提交提示词以及可选的帧或参考素材,轮询请求状态,然后下载 MP4。每段视频按模型、分辨率和时长用 Gems 付费。
- 15个视频模型
- $0.02默认最低价(每个片段)
- 20并发生成数
- $0月费
模型
Mage API 中的所有视频模型
价格按每次生成计算,以 Gems 计价。标准包 1,000 Gems 售价 $1,更大的套餐还会赠送额外 Gems。价格取决于模型、分辨率和时长;此处显示的是默认设置下的价格,每个响应都会在 billing.gems_charged 中给出实际扣费。生成失败会退还 Gems;因 Mage 内容政策被拦截的则不退还。
| 模型 | 最适合 | model_id 取值 | 默认价格 |
|---|---|---|---|
| Berry | 忠实还原参考素材的视频 | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | 锁定首帧和尾帧 | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | 我们的旗舰视频系列 | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | 动起来的 Grok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | 日常视频,无需任何设置 | kiwi | 270 Gems ($0.27) |
| Lemon | 功能齐全的视频,价格更亲民 | lemon | 245 Gems ($0.245) |
| LTX Video | 适合快速迭代的开放权重视频模型 | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | 重新演绎任意视频,保留原有动作 | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | 动起来的动漫,可选配音频 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | 带立体声的快速开源视频 | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | 每个片段都有声音,最高 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | 从首帧让角色动起来 | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance,内容过滤严格 | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0,内容过滤严格 | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | 提供 Lightning 版本的开放权重视频模型 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
快速开始
用 Berry 2 生成视频
设置 MAGE_API_KEY,提交请求,然后轮询直到完成。把 URL 中的 berry 换成上面任意模型即可。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])工作原理
从 API 密钥到成品,只需三次调用
所有模型共用一套认证方式、一套异步请求流程和相同的字段名称。
创建 API 密钥
登录 Mage,打开 API → API Keys 并创建密钥。密钥以 mage_sk_ 开头,只显示一次。每个账号最多可以有 10 个有效密钥。
提交生成任务
携带 Authorization: Bearer 请求头,向 https://api.mage.space/v1/{model}/generate 发送 JSON 格式的 POST 请求。接口会立即返回 request_id、status 和 status_url。请附上 Idempotency-Key 请求头,这样重试时不会重复扣费。
轮询并下载
持续轮询 status_url,直到状态变为 completed、failed 或 cancelled。请求完成后,result.url 会提供图片、视频或音频文件,文件保留 30 天。
为生产环境而生
每个 Mage API 请求都享有
一个密钥,通用所有模型
一个 REST API、一个 Gems 余额,即可使用 37 个图片、视频和音频模型。只需修改 URL 路径就能切换模型。
按生成次数付费
无需订阅,也没有最低消费。你购买 Gems,每次请求按标价扣费。生成失败会退还 Gems,但因违反 Mage 内容政策而被拦截的除外。
安全重试
借助幂等键,重试提交时会返回原始请求,不会重复扣费。
角色保持一致
只需保存一次角色或参考图,之后在任意提示词中写下 @handle,即可在所有支持的模型中使用。
支持大文件输入
可通过 URL 或 data URL 传入图片、视频和音频,也可通过签名上传方式上传最大 100 MB 的文件。
同时处理 20 个生成任务
每个账号可同时运行 20 个生成任务,并可根据你的使用场景提高上限。被拒绝的请求不会扣费。
使用场景
开发者用视频 API 构建什么
短视频与社交视频
根据提示词或产品图,制作适用于 TikTok、Reels 和 Shorts 的竖版视频。
让静态图片动起来
使用 Lemon 和 Kiwi 等图生视频模型,把首帧或首尾帧变成动态视频。
角色驱动的故事
使用支持 @handle 角色的参考生视频模型,让同一个角色贯穿多个镜头。
带声音的视频
Plum 等模型可在生成画面的同时生成语音、音效和环境音,还支持用音频参考来指定声音。
广告与产品演示
生成同一条广告的多个版本并挑出最佳方案,幂等提交确保不会重复扣费。
编辑现有视频
Berry、Plum 和 Grok Video 可编辑你发送的源视频;Lemon 和 MiniMax-H3 还支持参考视频。
常见问题
常见问题解答
最好的 AI 视频生成 API 是什么?
视频 API 支持图生视频吗?
生成的视频最长可以多长?
生成一段视频需要多长时间?
Mage API 的费用是多少?
使用 API 需要 Mage 会员吗?
API 生成的内容可以商用吗?
速率限制是多少?
我的 AI 智能体可以使用 Mage API 吗?
Mage API 有 SDK 吗?
我已经在用其他生成 API 了,需要改哪些地方?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。