Один ключ — все модели
28 моделей для изображений, видео и аудио в одном REST API с единым балансом Gems. Чтобы сменить модель, измените путь в URL.
Главное
Mage предлагает разработчикам REST API по адресу https://api.mage.space/v1 и удалённый MCP-сервер по адресу https://mcp.mage.space/mcp. Оба работают с одними и теми же 28 моделями для изображений, видео и аудио, включая эксклюзивные для Mage Mango 3 и Cherry 2 Pro, в одном аккаунте. Каждая генерация оплачивается в Gems, без подписки.
28
Модели
3
Типы медиа
16
Инструменты MCP
$0
Абонентская плата
Как подключиться
Вызывайте из кода, из ассистента или из ComfyUI
REST API
Mage API
Отправляйте генерации из своего кода по ключу. Асинхронные запросы, идемпотентные повторы, загрузка файлов до 100 МБ и до 20 генераций одновременно.
SDK
SDK для TypeScript и Python
Официальные типизированные клиенты: отправляют запрос, ждут результат, безопасно повторяют вызовы и загружают файлы в несколько строк.
MCP-сервер
MCP-сервер Mage
Подключите Claude, ChatGPT, Claude Code, Grok или Cursor через вход в аккаунт и просите изображения, видео и аудио простыми словами.
ComfyUI
Mage для ComfyUI
Mango, Cherry, Seed Audio и все остальные модели Mage в виде нод ComfyUI. Без GPU и без загрузки моделей.
По типу медиа
API для генерации
15 моделей
API для генерации изображений нейросетью
Из текста в изображение, редактирование и стабильные персонажи в разрешении до 4K.
12 моделей
API для генерации видео нейросетью
Из текста в видео, из изображения в видео, кадры, референсы и звук.
1 модель
API для генерации аудио нейросетью
Голоса, озвучка, музыка и звуковые эффекты по промпту.
Быстрый старт
Ваша первая генерация
Создайте ключ в разделе API → API Keys, сохраните его в переменной MAGE_API_KEY и запустите один из этих примеров.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
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 дней.
MCP
Mage в вашем ИИ-ассистенте
Mage в Claude
Генерируйте изображения, видео и аудио в Claude в веб-версии, в приложении для компьютера, в мобильных приложениях и в Cowork.
Mage в ChatGPT
Генерируйте изображения, видео и аудио в ChatGPT как персональное MCP-приложение.
Mage в Claude Code
Создавайте изображения, видео и аудио в Claude Code — в терминале и в редакторе.
Mage в Grok
Создавайте изображения, видео и аудио в Grok через собственный коннектор.
Mage в Cursor
Создавайте изображения, видео и аудио в режиме Agent в Cursor.
Модели
Избранные модели
Изображения · от 40 Gems
Flux 2 API
Длинные промпты и правки по нескольким референсам
Изображения · от 9 Gems
GPT Image 2 API
Точные промпты и читаемый текст
Изображения · от 37 Gems
Guava API
Фотореализм, неотличимый от настоящего снимка
Изображения · от 135 Gems
Mango API
Наше флагманское семейство моделей для изображений
Изображения · от 68 Gems
Nano Banana 2 API
Чёткий, читаемый текст, до 4K
Видео · от 618 Gems
Cherry API
Наше флагманское семейство моделей для видео
Видео · от 245 Gems
Lemon API
Все возможности видео по более доступной цене
Видео · от 338 Gems
Plum API
Звук в каждом клипе, до 2K
Аудио · от 19 Gems
Seed Audio API
Голоса, музыка и звуковые эффекты из одного промпта
Готово к продакшену
Что получает каждый запрос к Mage API
Оплата за каждую генерацию
Без подписки и минимальных трат. Вы покупаете Gems, и за каждый запрос списывается его цена по прайс-листу. Если генерация не удалась, Gems возвращаются — кроме случаев, когда её заблокировала политика контента Mage.
Безопасные повторы
Ключи идемпотентности гарантируют, что повторная отправка вернёт исходный запрос без повторного списания.
Стабильные персонажи
Сохраните персонажа или референс один раз, а затем пишите @handle в любом промпте, чтобы использовать его в каждой модели, которая это поддерживает.
Большие входные файлы
Передавайте изображения, видео и аудио как URL или data URL либо загружайте файлы до 100 МБ через подписанную загрузку.
20 генераций одновременно
Каждый аккаунт может запускать 20 генераций одновременно, а лимит можно повысить под вашу задачу. За отклонённые запросы плата не списывается.
FAQ
Частые вопросы
Что такое Mage API?
Mage API — это REST API по адресу https://api.mage.space/v1 для создания изображений, видео и аудио с помощью 28 моделей прямо из вашего кода. Запросы асинхронные, оплата за каждую генерацию — в Gems.
Что такое MCP-сервер Mage?
Это удалённый сервер Model Context Protocol по адресу https://mcp.mage.space/mcp, который позволяет ИИ-ассистентам создавать изображения, видео и аудио в вашем аккаунте Mage. Ассистент получает 16 инструментов: выбрать модель, узнать цену, запустить генерацию, дождаться результата и использовать ваших сохранённых персонажей, референсы и историю.
Нужен ли API-ключ для работы с MCP-сервером?
Нет. Claude, ChatGPT, Grok, Cursor и Claude Code подключаются через вход в Mage по OAuth. API-ключ нужен только по желанию — для headless-сценариев, например в CI.
Сколько стоит Mage API?
Подписки и ежемесячной платы нет. Каждая генерация оплачивается в Gems по цене её модели, а 1 000 Gems в стандартном пакете стоят $1. На странице каждой модели указана цена при настройках по умолчанию, а в каждом ответе — точная сумма списания. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет. Запрос, на который не хватает баланса, отклоняется до любого списания.
Нужна ли подписка Mage, чтобы пользоваться API?
Нет. API работает только на Gems. Тарифы и безлимитная генерация в приложении на запросы к API не распространяются, поэтому им может пользоваться любой аккаунт Mage с Gems.
Можно ли использовать результаты 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, все модели. Платите только за то, что генерируете.