跳至主要内容

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名称默认
magejutsuMagejutsu是
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

选项

Magejutsu 参数

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

字段取值
resolution480p, 720p, 1080p
modemotion_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

  • 视频 · 147 Gems 起

    Melon API

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

  • 视频 · 30 Gems 起

    MiniMax-H3 API

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

  • 视频 · 173 Gems 起

    Plum API

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

  • 视频 · 360 Gems 起

    Raspberry API

    从首帧让角色动起来

  • 视频 · 起价 40 Gems

    Wan Video v2.2 API

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

  • 视频 · 起价 189 Gems

    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 余额,畅用所有模型。按生成量付费,用多少付多少。