Mage API · 视频模型

Lemon API

视频功能一应俱全,价格更亲民

获取 API 密钥在试玩中体验 Lemon
POST https://api.mage.space/v1/lemon/generate

一览

Lemon API 通过 Mage 运行 Lemon,接口为 POST https://api.mage.space/v1/lemon/generate。使用默认设置的一次请求费用为 245 Gems(约 $0.245),无需订阅。在提示词中通过 @handle 即可使用 Lemon 已保存的角色、参考和音频参考。

概览

Lemon API 能做什么

我们的全能视频模型。支持首帧和尾帧、最多 10 个参考或 Characters、Voices 和音频,可生成 2 到 30 秒的视频,最高 1080p。

Mage 的全能视频模型,价格更亲民:支持帧、参考、Voices、生成音频,以及 2 到 30 秒的视频。

支持的输入:first_image、last_image、image、additional_images、videos。

快速开始

调用 Lemon API

设置 MAGE_API_KEY,向 /lemon/generate 提交请求,然后轮询 status_url,直到请求完成。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/lemon/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": "lemon"
}' | 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('lemon', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'lemon',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("lemon", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "lemon",
})

print(request["result"]["url"])

模型

Lemon 的 model_id 取值

传入 model_id 即可选择变体。未指定时将使用默认变体。

model_id名称默认
lemonLemon是

选项

Lemon 参数

以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。

字段取值
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

输入

Lemon 支持的媒体输入

可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。

字段用途
first_image首帧图片。
last_image尾帧图片。
image参考图片。
additional_images额外的参考图片。
videos源视频。

规则

Lemon API 的强制限制

更多视频模型

Mage 上的其他视频生成 API

视频 · 20 Gems 起

LTX Video API

开放权重的快速视频模型,适合反复迭代

视频 · 147 Gems 起

Melon API

动起来的动漫,可选配音频

视频 · 30 Gems 起

MiniMax-H3 API

快速的开源视频模型,支持立体声

视频 · 338 Gems 起

Plum API

每段视频都带声音,最高支持 2K

视频 · 360 Gems 起

Raspberry API

从首帧让角色动起来

视频 · 起价 40 Gems

Wan Video v2.2 API

开放权重视频模型,含 Lightning 版本

常见问题

常见问题解答

Lemon API 的费用是多少?

使用默认设置(Lemon)的一次 Lemon 请求需要 245 Gems,约 $0.245。其他分辨率、时长和版本会改变价格,具体费用以返回结果为准。生成失败会退款;因违反 Mage 内容政策而被拦截的请求不予退款。

Lemon API 的端点是什么?

向 https://api.mage.space/v1/lemon/generate 发送 POST 请求,并在 Authorization: Bearer 请求头中携带你的 Mage API 密钥。返回结果包含 status_url,可用于轮询获取结果。

我可以调用哪些 Lemon 模型?

lemon。默认为 Lemon。

Lemon 支持参考图片或角色吗?

Lemon 支持 first_image、last_image、image、additional_images、videos。Lemon 可在提示词中通过 @handle 调用已保存的角色、参考和音频参考。

我可以在 Claude 或 ChatGPT 中使用 Lemon 吗?

可以。将 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接说出 Lemon 的名称即可。你的助手会通过 get_model 读取可用选项,并在生成前告知价格。

Lemon 的生成结果会保存多久?

结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。

用 Mage 开始开发

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

获取 API 密钥在试玩中体验 Lemon

相关内容