Mage API · 视频模型
Magejutsu API
重新演绎任意视频,保留原有动作
POST https://api.mage.space/v1/magejutsu/generate一览
Magejutsu API 通过 Mage 运行 Magejutsu 及另外 2 个版本,接口为 POST https://api.mage.space/v1/magejutsu/generate。使用默认设置的一次请求费用为 1,856 Gems(约 $1.856),无需订阅。Magejutsu 支持已保存的角色,也可在提示词中通过 @handle 引用参考素材。
- 视频输出
- 3变体
- 1,856每段视频消耗的 Gems(默认)
- $1.856约合美元
概览
Magejutsu API 的功能
重新演绎你已有的视频:发送片段,以及要替换成的人物或对象的照片,动作、镜头、节奏和声音都保持拍摄时的样子。源视频时长为 4 到 30 秒。
重新演绎现有视频:由导演环节根据源视频撰写编辑提示词,再通过视频编辑流程重建表演的人物和对象。发送源视频和替换用的参考素材;输出会保持源视频的时长、比例、动作和声音。
支持的输入包括 image、additional_images、videos。
快速开始
调用 Magejutsu API
设置 MAGE_API_KEY,提交到 /magejutsu/generate,然后轮询 status_url,直到请求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
"videos": [
"https://example.com/input.jpg"
],
"image": "https://example.com/input.jpg",
"model_id": "magejutsu"
}' | 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('magejutsu', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
videos: [
'https://example.com/input.jpg',
],
image: 'https://example.com/input.jpg',
model_id: 'magejutsu',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("magejutsu", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"videos": [
"https://example.com/input.jpg",
],
"image": "https://example.com/input.jpg",
"model_id": "magejutsu",
})
print(request["result"]["url"])模型
Magejutsu 的 model_id 值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| magejutsu | Magejutsu | 是 |
| magejutsu-lite | Magejutsu Lite | |
| magejutsu-feather | Magejutsu Feather |
选项
Magejutsu 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| resolution | 480p, 720p, 1080p |
| mode | motion_transfer, object_swap |
输入
Magejutsu 接受的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
| videos | 源视频。 |
规则
Magejutsu API 的限制
- 在 magejutsu 上,源视频时长为 4 到 30 秒;在 magejutsu-lite(更快、更便宜的版本)和 magejutsu-feather(最便宜、最快,仅支持 motion_transfer,输出分辨率为 480p 和 720p)上,则为 4 到 15 秒。输出结果会沿用源视频的时长和宽高比。
- 每个请求在后端都由同一个“导演”处理。选择 motion_transfer 可重建表演者并保留动作,选择 object_swap 则只更换选定元素,其余画面保持原拍效果。模式还决定了源视频的处理方式:motion_transfer 会依据每位被替换表演者的动作和面部来引导编辑,object_swap 则直接在原拍素材上编辑。如果片段无法被引导识别(例如画面中没有人物),将按原拍素材渲染。整个过程没有手动审批步骤,也没有草稿渲染。
- 通过 image 和 additional_images 最多可发送 30 张参考图片。导演会读取每一张,而编辑只会接收提示词中用到的图片:magejutsu 最多 27 张,magejutsu-lite 最多 9 张,magejutsu-feather 最多 8 张。
- 提示词为可选项:不填写时,导演会根据显著程度和契合度,将参考图片对应到源视频。
- 默认会还原原始音频;将 keep_original_audio 设为 false 即可保留生成的音频。
- 图片即为替换对象;请在提示词中按位置提及每张图片(“图 1 是左边的人”)。
- 每次请求只接受源视频这一个视频;更长的片段会被拒绝,而不是被裁剪。
更多视频模型
Mage 上的其他视频生成 API
Melon API
动起来的动漫,可选配音频
MiniMax-H3 API
快速的开源视频模型,支持立体声
Plum API
每段视频都带声音,最高支持 2K
Raspberry API
从首帧让角色动起来
Wan Video v2.2 API
开放权重视频模型,含 Lightning 版本
Berry API
忠实还原你的参考内容的视频
常见问题
常见问题解答
Magejutsu API 的价格是多少?
使用默认设置(Magejutsu)的一次 Magejutsu 请求费用为 1,856 Gems,约 $1.856。其他分辨率、时长和变体会影响价格,具体扣费以返回结果为准。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的请求不予退还。
Magejutsu API 的端点是什么?
使用 POST https://api.mage.space/v1/magejutsu/generate,并在 Authorization: Bearer 标头中携带你的 Mage API 密钥。响应中包含 status_url,用于轮询结果。
我可以调用哪些 Magejutsu 模型?
magejutsu(Magejutsu)、magejutsu-lite(Magejutsu Lite)、magejutsu-feather(Magejutsu Feather)。默认模型为 Magejutsu。
Magejutsu 支持参考图片或角色吗?
Magejutsu 接受 image、additional_images、videos。Magejutsu 支持已保存的角色和参考素材,在提示词中用 @handle 引用。
我可以在 Claude 或 ChatGPT 中使用 Magejutsu 吗?
可以。把 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接说出 Magejutsu 的名字。你的助手会用 get_model 读取它的选项,并在生成前告知价格。
Magejutsu 的结果会保存多久?
结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。