Перейти к содержимому
PlaygroundДокументацияПолучить API-ключ

Mage API · Модель для видео

Magejutsu API

Замена героев в любом видео с сохранением движения

Получить API-ключПопробовать Magejutsu в плейграунде
POST https://api.mage.space/v1/magejutsu/generate

Главное

Magejutsu API запускает Magejutsu и ещё 2 варианта через Mage по адресу POST https://api.mage.space/v1/magejutsu/generate. Запрос с настройками по умолчанию стоит 1 856 Gems (около $1,856), без подписки. Magejutsu принимает сохранённых персонажей и референсы по @handle в промпте.

  • ВидеоРезультат
  • 3Варианты
  • 1,856Gems за клип, по умолчанию
  • $1.856Примерно, в USD

Обзор

Что умеет 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"])

Модели

Значения model_id для Magejutsu

Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.

model_idНазваниеПо умолчанию
magejutsuMagejutsuДа
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

Параметры

Параметры Magejutsu

Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.

ПолеЗначения
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

Входные данные

Какие медиафайлы принимает Magejutsu

Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.

ПолеРоль
imageРеференсное изображение.
additional_imagesДополнительные референсные изображения.
videosИсходные видео.

Правила

Какие ограничения действуют в Magejutsu API

  • Исходное видео может длиться от 4 до 30 секунд на magejutsu и от 4 до 15 секунд на magejutsu-lite — более быстром и дешёвом варианте, а также на magejutsu-feather — самом дешёвом и быстром, который работает только с motion_transfer и рендерит в 480p и 720p. Длина и соотношение сторон результата совпадают с исходным видео.
  • Каждый запрос обрабатывается одним и тем же режиссёром на бэкенде. Выберите motion_transfer, чтобы пересоздать исполнителей и сохранить движение, или object_swap, чтобы изменить выбранные элементы, оставив остальную часть кадра как есть. Режим также определяет, как подготавливается исходник: при motion_transfer правка опирается на движения и лицо каждого заменённого исполнителя, а при object_swap исходник редактируется в том виде, в каком он был снят. Если клип не поддаётся такому анализу, например в нём нет людей, он рендерится из исходника как есть. Ручного подтверждения и черновых рендеров нет.
  • Отправляйте до 30 референсных изображений через image и additional_images. Режиссёр изучает каждое, а в монтаж попадают те, что используются в промпте: до 27 в magejutsu, 9 в magejutsu-lite и 8 в magejutsu-feather.
  • Промпт необязателен: если его нет, режиссёр сопоставляет референсы с исходником по заметности и соответствию.
  • По умолчанию восстанавливается оригинальное аудио. Чтобы сохранить сгенерированное аудио, установите для keep_original_audio значение false.
  • Изображения — это замена; упоминайте каждое в промпте по порядку («изображение 1 — человек слева»).
  • В запросе принимается только одно исходное видео; более длинный клип отклоняется, а не обрезается.

Другие видеомодели

Другие API для генерации видео в Mage

  • Видео · от 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

    Видео, которое остаётся верным вашим референсам

FAQ

Частые вопросы

Сколько стоит Magejutsu API?
Запрос Magejutsu с настройками по умолчанию (Magejutsu) стоит 1 856 Gems, около $1,856. Другие разрешения, длительность и варианты меняют цену, точную сумму списания вы увидите в ответе. Если генерация не удалась, Gems возвращаются, а если её заблокировала политика контента Mage, то нет.
Какой эндпоинт у Magejutsu API?
POST https://api.mage.space/v1/magejutsu/generate с заголовком Authorization: Bearer, содержащим ваш API-ключ Mage. В ответе есть status_url, который нужно опрашивать, чтобы получить результат.
Какие модели Magejutsu можно вызывать?
magejutsu (Magejutsu), magejutsu-lite (Magejutsu Lite), magejutsu-feather (Magejutsu Feather). По умолчанию используется Magejutsu.
Поддерживает ли Magejutsu референсы и персонажей?
Magejutsu принимает image, additional_images, videos. Также Magejutsu принимает сохранённых персонажей и референсы по @handle в промпте.
Можно ли использовать Magejutsu в Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и просите Magejutsu по названию. Ассистент прочитает его параметры через get_model и назовёт цену до генерации.
Как долго хранятся результаты Magejutsu?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.

Получить API-ключПопробовать Magejutsu в плейграунде