Перейти к содержимому

Mage API · Генерация видео

API нейросети для генерации видео из текста или изображений

Видео из текста, из изображения, по первому и последнему кадру и по референсам на 15 моделях во главе с флагманом Mage — Cherry 2 Pro. Во многих клипах есть звук.

POST https://api.mage.space/v1/{model}/generate

Главное

API генерации видео Mage — это REST API по адресу https://api.mage.space/v1, который запускает 15 моделей для создания видео из текста и изображений, включая Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video и Wan. Отправьте промпт и, при желании, кадры или референсы, опрашивайте статус запроса и скачайте MP4. Каждый клип оплачивается в Gems в зависимости от модели, разрешения и длительности.

  • 15видеомоделей
  • $0.02Самый дешёвый вариант по умолчанию, за клип
  • 20Одновременных генераций
  • $0Абонентская плата

Модели

Все видеомодели в Mage API

Цены указаны за одну генерацию, в Gems. 1000 Gems стоят $1 в стандартном пакете, а в больших пакетах есть бонусные Gems. Цена зависит от модели, разрешения и длительности; здесь показана цена при настройках по умолчанию, а точная сумма списания указана в каждом ответе в billing.gems_charged. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет.

МодельЛучше всего подходит дляЗначения model_idЦена по умолчанию
BerryВидео, верное вашим референсамberry, berry-2189 Gems ($0.189)
BlueberryЗадайте первый и последний кадрblueberry, blueberry-v2360 Gems ($0.36)
CherryНаше флагманское семейство видеомоделейcherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine в движенииgrok-imagine-video375 Gems ($0.375)
KiwiВидео на каждый день, без настройкиkiwi270 Gems ($0.27)
LemonВсе возможности видео по более доступной ценеlemon245 Gems ($0.245)
LTX VideoБыстрая видеомодель с открытыми весами для итерацийltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MagejutsuЗамена героев в любом видео с сохранением движенияmagejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
MelonАниме в движении, со звуком по желаниюmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Быстрое открытое видео со стереозвукомminimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
PlumЗвук в каждом клипе, до 2Kplum, plum-max, plum-fast173 Gems ($0.173)
RaspberryПерсонажи оживают с первого кадраraspberry360 Gems ($0.36)
SeedanceSeedance со строгим фильтромseedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0 со строгим фильтромwan-3.0245 Gems ($0.245)
Wan Video v2.2Видеомодель с открытыми весами и версией Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Быстрый старт

Создайте видео с Berry 2

Задайте MAGE_API_KEY, отправьте запрос и опрашивайте статус, пока он не завершится. Замените berry в URL на любую модель из списка выше.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Как это работает

От API-ключа до готового результата за три вызова

У всех моделей одна схема аутентификации, один жизненный цикл асинхронного запроса и одинаковые названия полей.

  1. Создайте API-ключ

    Войдите в Mage, откройте API → API Keys и создайте ключ. Он начинается с mage_sk_ и показывается только один раз. В аккаунте может быть до 10 активных ключей.

  2. Отправьте генерацию

    Отправьте POST-запрос с JSON-телом на https://api.mage.space/v1/{model}/generate с заголовком Authorization: Bearer. Ответ приходит сразу и содержит request_id, status и status_url. Добавьте заголовок Idempotency-Key, чтобы повторный запрос не списывал оплату дважды.

  3. Опрашивайте и скачивайте

    Опрашивайте status_url, пока статус не станет completed, failed или cancelled. В завершённом запросе есть result.url со ссылкой на файл изображения, видео или аудио; он хранится 30 дней.

Готово к продакшену

Что получает каждый запрос к Mage API

  • Один ключ — все модели

    37 моделей для изображений, видео и аудио в одном REST API и с одним балансом Gems. Чтобы сменить модель, измените путь в URL.

  • Оплата за каждую генерацию

    Без подписки и минимальных трат. Вы покупаете Gems, и за каждый запрос списывается его цена по прайс-листу. Если генерация не удалась, Gems возвращаются — кроме случаев, когда её заблокировала политика контента Mage.

  • Безопасные повторы

    Ключи идемпотентности гарантируют, что повторная отправка вернёт исходный запрос без повторного списания.

  • Стабильные персонажи

    Сохраните персонажа или референс один раз, а затем пишите @handle в любом промпте, чтобы использовать его в каждой модели, которая это поддерживает.

  • Большие входные файлы

    Передавайте изображения, видео и аудио как URL или data URL либо загружайте файлы до 100 МБ через подписанную загрузку.

  • 20 генераций одновременно

    Каждый аккаунт может запускать 20 генераций одновременно, а лимит можно повысить под вашу задачу. За отклонённые запросы плата не списывается.

Сценарии использования

Что разработчики создают с видео API

  • Короткие видео и контент для соцсетей

    Создавайте вертикальные клипы для TikTok, Reels и Shorts по промпту или изображению товара.

  • Оживление статичных изображений

    Превращайте первый кадр или первый и последний кадры в движение с помощью моделей image-to-video, таких как Lemon и Kiwi.

  • Истории с персонажами

    Сохраняйте одного и того же персонажа в разных сценах с помощью моделей reference-to-video, которые принимают персонажей по @handle.

  • Видео со звуком

    Plum и другие модели создают речь, звуковые эффекты и атмосферу вместе с картинкой и принимают аудиореференсы для голосов.

  • Реклама и демо продуктов

    Создавайте множество вариантов ролика и выбирайте лучший — идемпотентные отправки никогда не списывают оплату дважды.

  • Редактирование готовых клипов

    Berry, Plum и Grok Video редактируют отправленное вами исходное видео; Lemon и MiniMax-H3 также принимают референсные видео.

FAQ

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

Какой API нейросети для генерации видео лучший?
В Mage для видео по умолчанию используется Cherry 2 Pro: он поддерживает персонажей, множество референсных изображений, аудиореференсы, разрешение от 480p до 4K и клипы длительностью до 30 секунд. Lemon подойдёт, если нужен контроль над первым и последним кадром, Plum — для клипов со сгенерированным звуком до 2K, а Cherry Mini или Wan — для более дешёвых черновиков.
Поддерживает ли видео API генерацию из изображения?
Да. Модели image-to-video принимают первый кадр, а некоторые ещё и последний кадр или референсы-изображения — в виде URL, data URL или загрузок. На странице каждой модели указано, какие входные данные она принимает и обязательно ли изображение.
Какой длины могут быть сгенерированные видео?
Зависит от модели и разрешения. Многие модели генерируют от 4 до 15 секунд, а Cherry 2 Pro и Cherry 2 — 20, 25 и 30 секунд. Длительность указана на странице каждой модели.
Сколько времени занимает генерация видео?
Зависит от модели, разрешения и длительности. API асинхронный: отправьте запрос, затем опрашивайте status_url с увеличивающимися паузами или позвольте вашему MCP-клиенту дождаться результата через get_request.
Сколько стоит Mage API?
Подписки и ежемесячной платы нет. Каждая генерация оплачивается в Gems по цене её модели, а 1 000 Gems в стандартном пакете стоят $1. На странице каждой модели указана цена при настройках по умолчанию, а в каждом ответе — точная сумма списания. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет. Запрос, на который не хватает баланса, отклоняется до любого списания.
Нужна ли подписка Mage, чтобы пользоваться API?
Нет. API работает только на Gems. Тарифные планы и безлимитная генерация в приложении на запросы через API не распространяются. Сначала на аккаунте должен пройти один успешный платёж: подойдёт любой пакет Gems или любой план. Бонусные Gems, полученные при регистрации, действуют только в приложении Mage.
Можно ли использовать результаты API в коммерческих целях?
Да. Контент, созданный в Mage, в том числе через API и MCP-сервер, можно использовать в коммерческих целях. Указывать авторство приятно, но необязательно.
Какие есть лимиты запросов?
В одном аккаунте одновременно может быть до 20 генераций в очереди или в работе. Запрос сверх этого лимита отклоняется с кодом 429 и ничего не стоит. Напишите на [email protected], чтобы увеличить лимит под вашу задачу.
Может ли мой ИИ-агент использовать Mage API?
Да. Агенты могут вызывать REST API по ключу или подключаться к MCP-серверу Mage, который даёт Claude, ChatGPT, Claude Code, Grok и Cursor шестнадцать готовых инструментов: выбрать модель, узнать цену, запустить генерацию и получить результат. Подробности: MCP-сервер.
Есть ли SDK для Mage API?
Да. Официальные пакеты @mage-space/sdk в npm и mage-space в PyPI имеют открытый исходный код и типизацию для каждой модели. Они сами отправляют запрос, дожидаются результата, безопасно повторяют попытки и загружают файлы. Пользователи ComfyUI могут установить набор нод comfyui-mage. Подробности: SDK Mage.
Я уже пользуюсь другим API для генерации. Что нужно изменить?
Направьте клиент на https://api.mage.space/v1, передавайте ключ Mage как Bearer-токен и сопоставьте свои поля с полями на странице модели: prompt, aspect_ratio, resolution, duration и model_id работают одинаково во всех моделях Mage. Запросы асинхронные: отправьте запрос, а затем опрашивайте status_url.

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

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

CharactersСообщество