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-2 | 189 Gems ($0.189) |
| Blueberry | Задайте первый и последний кадр | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Наше флагманское семейство видеомоделей | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine в движении | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Видео на каждый день, без настройки | kiwi | 270 Gems ($0.27) |
| Lemon | Все возможности видео по более доступной цене | lemon | 245 Gems ($0.245) |
| LTX Video | Быстрая видеомодель с открытыми весами для итераций | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Замена героев в любом видео с сохранением движения | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Аниме в движении, со звуком по желанию | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Быстрое открытое видео со стереозвуком | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Звук в каждом клипе, до 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Персонажи оживают с первого кадра | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance со строгим фильтром | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0 со строгим фильтром | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Видеомодель с открытыми весами и версией Lightning | wan22-video, wan22-video-lightning | 40 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-ключа до готового результата за три вызова
У всех моделей одна схема аутентификации, один жизненный цикл асинхронного запроса и одинаковые названия полей.
Создайте API-ключ
Войдите в Mage, откройте API → API Keys и создайте ключ. Он начинается с mage_sk_ и показывается только один раз. В аккаунте может быть до 10 активных ключей.
Отправьте генерацию
Отправьте POST-запрос с JSON-телом на https://api.mage.space/v1/{model}/generate с заголовком Authorization: Bearer. Ответ приходит сразу и содержит request_id, status и status_url. Добавьте заголовок Idempotency-Key, чтобы повторный запрос не списывал оплату дважды.
Опрашивайте и скачивайте
Опрашивайте 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 нейросети для генерации видео лучший?
Поддерживает ли видео API генерацию из изображения?
Какой длины могут быть сгенерированные видео?
Сколько времени занимает генерация видео?
Сколько стоит Mage API?
Нужна ли подписка Mage, чтобы пользоваться API?
Можно ли использовать результаты API в коммерческих целях?
Какие есть лимиты запросов?
Может ли мой ИИ-агент использовать Mage API?
Есть ли SDK для Mage API?
Я уже пользуюсь другим API для генерации. Что нужно изменить?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.