Mage API · 视频模型
Cherry API
我们的旗舰视频模型系列
POST https://api.mage.space/v1/cherry/generate一览
Cherry API 通过 Mage 运行 Cherry 2 Pro 及其他 4 个版本,接口为 POST https://api.mage.space/v1/cherry/generate。使用默认设置的一次请求费用为 618 Gems(约 $0.618),无需订阅。Cherry 支持在提示词中通过 @handle 调用已保存的角色、参考图和音频参考。
- 视频输出
- 5变体
- 618每段视频消耗的 Gems(默认)
- $0.618约合美元
概览
Cherry API 能做什么
带音频的电影级视频:从用于草稿的 Cherry Mini,到我们最强大的模型 Cherry 2 Pro,支持最长 30 秒的视频、多张参考图或 Characters,以及基于源视频的编辑。
Mage 的旗舰视频系列,具备电影级动态效果和音频:Cherry Mini、Cherry、Cherry Pro、Cherry 2 和最强大的 Cherry 2 Pro。Cherry 2 系列模型可生成最长 30 秒的视频。
支持的输入包括 image、additional_images、videos。
快速开始
调用 Cherry API
设置 MAGE_API_KEY,向 /cherry/generate 提交请求,然后轮询 status_url,直到请求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
"model_id": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])模型
Cherry 的 model_id 取值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | 是 |
选项
Cherry 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
输入
Cherry 支持的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
| videos | 源视频。 |
规则
Cherry API 的限制
- 视频编辑必须且只能提供一个源视频:`cherry-2` 和 `cherry-2-pro` 支持 4 到 30 秒,其他模型支持 2 到 15 秒。
- 在 `cherry-2` 和 `cherry-2-pro` 上,编辑会保留源视频的时长和宽高比:`duration` 和 `aspect_ratio` 会被忽略,价格按视频时长计算。
更多视频模型
Mage 上的其他视频生成 API
Grok Video API
动起来的 Grok Imagine
Kiwi API
日常视频,无需任何设置
Lemon API
视频功能一应俱全,价格更亲民
LTX Video API
开放权重的快速视频模型,适合反复迭代
Magejutsu API
重新演绎任意视频,保留原有动作
Melon API
动起来的动漫,可选配音频
常见问题
常见问题解答
Cherry API 的费用是多少?
Cherry API 的接口地址是什么?
可以调用哪些 Cherry 模型?
Cherry 支持参考图或角色吗?
可以在 Claude 或 ChatGPT 中使用 Cherry 吗?
Cherry 的生成结果会保存多久?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。