Mage API · 视频模型
Berry API
忠实还原参考素材的视频
POST https://api.mage.space/v1/berry/generate一览
Berry API 通过 Mage 运行 Berry 2 及另外 1 个版本,接口为 POST https://api.mage.space/v1/berry/generate。使用默认设置的一次请求消耗 189 Gems(约 $0.189),无需订阅。Berry 支持在提示词中通过 @handle 引用已保存的 Characters 和 References。
- 视频输出
- 2变体
- 189每段视频消耗的 Gems(默认)
- $0.189约合美元
概览
Berry API 能做什么
忠实还原你提供的每一个参考素材。可使用起始帧、最多 9 个参考图或 Characters,也可以用源视频进行编辑;时长 3 至 15 秒,最高 1080p。
Mage 的参考驱动视频模型,忠实还原你提供的图片;Berry 2 是当前版本。可使用首帧或参考图片,也可以用源视频进行编辑。
支持的输入包括 first_image、image、additional_images、video。
快速开始
调用 Berry API
设置 MAGE_API_KEY,向 /berry/generate 提交请求,然后轮询 status_url,直到请求完成。
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"])模型
Berry 的 model_id 取值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | 是 |
选项
Berry 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
输入
Berry 支持的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| first_image | 首帧图片。 |
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
| video | 源视频。 |
规则
Berry API 的限制规则
- 首帧不能与参考图片同时使用。
- 视频编辑仅支持 `berry`,不支持 `berry-2`:请发送 `model_id: "berry"`,并提供时长 3 到 60 秒的源视频。
更多视频模型
Mage 上的其他视频生成 API
Blueberry API
锁定首帧和尾帧
Cherry API
我们的旗舰视频系列
Grok Video API
动起来的 Grok Imagine
Kiwi API
日常视频,无需任何设置
Lemon API
视频功能一应俱全,价格更亲民
LTX Video API
开放权重的快速视频模型,适合反复迭代
常见问题
常见问题解答
Berry API 的价格是多少?
使用默认设置(Berry 2)的一次 Berry 请求需要 189 Gems,约 0.189 美元。分辨率、时长和变体不同,价格也会变化,具体扣费以返回结果为准。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的请求不予退还。
Berry API 的端点是什么?
向 https://api.mage.space/v1/berry/generate 发送 POST 请求,并在 Authorization: Bearer 请求头中携带你的 Mage API 密钥。响应中包含 status_url,用于轮询获取结果。
可以调用哪些 Berry 模型?
berry(Berry)、berry-2(Berry 2)。默认使用 Berry 2。
Berry 支持参考图片或角色吗?
Berry 支持 first_image、image、additional_images、video。Berry 可在提示词中通过 @handle 调用已保存的角色和参考。
可以在 Claude 或 ChatGPT 中使用 Berry 吗?
可以。将 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接指名要用 Berry。你的助手会通过 get_model 读取可用选项,并在生成前告知价格。
Berry 的生成结果会保存多久?
结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。