Mage API · Создан для вашей следующей идеи
Один API. Безграничные возможности.
Добавьте лучшее из Mage в свой продукт и в ИИ-ассистента. Генерируйте изображения, видео и аудио с одним API-ключом или одним MCP-подключением.
https://api.mage.space/v1Главное
Mage предлагает разработчикам REST API по адресу https://api.mage.space/v1 и удалённый MCP-сервер по адресу https://mcp.mage.space/mcp. Оба используют одни и те же 37 моделей для изображений, видео и аудио, включая эксклюзивные для Mage Mango 4 и Cherry 2 Pro, на одном аккаунте. Каждая генерация оплачивается в Gems, без подписки.
- 37Модели
- 3Типы медиа
- 16Инструменты MCP
- $0Абонентская плата
Как подключиться
Вызывайте из кода, из ассистента или из ComfyUI
Mage API
Отправляйте генерации из своего кода по ключу. Асинхронные запросы, идемпотентные повторы, загрузка файлов до 100 МБ и до 20 генераций одновременно.
SDK для TypeScript и Python
Официальные типизированные клиенты: отправляют запрос, ждут результат, безопасно повторяют вызовы и загружают файлы в несколько строк.
MCP-сервер Mage
Подключите Claude, ChatGPT, Claude Code, Grok или Cursor через вход в аккаунт и просите изображения, видео и аудио простыми словами.
Mage для ComfyUI
Mango, Cherry, Seed Audio и все остальные модели Mage в виде нод ComfyUI. Без GPU и без загрузки моделей.
По типу медиа
API для генерации
API для генерации изображений нейросетью
Из текста в изображение, редактирование и стабильные персонажи в разрешении до 4K.
API для генерации видео нейросетью
Из текста в видео, из изображения в видео, кадры, референсы и звук.
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-v4"
}' | 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-v4',
});
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-v4",
})
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.
Модели
Избранные модели
Flux 2 API
Длинные промпты и правки по нескольким референсам
GPT Image 2 API
Точные промпты и читаемый текст
Guava API
Фотореализм, неотличимый от настоящего снимка
Mango API
Наше флагманское семейство моделей для изображений
Nano Banana 2 API
Чёткий, читаемый текст, до 4K
Cherry API
Наше флагманское семейство моделей для видео
Lemon API
Все возможности видео по более доступной цене
Plum API
Звук в каждом клипе, до 2K
Seed Audio API
Голоса, музыка и звуковые эффекты из одного промпта
Готово к продакшену
Что получает каждый запрос к Mage API
Один ключ — все модели
37 моделей для изображений, видео и аудио в одном REST API и с одним балансом Gems. Чтобы сменить модель, измените путь в URL.
Оплата за каждую генерацию
Без подписки и минимальных трат. Вы покупаете Gems, и за каждый запрос списывается его цена по прайс-листу. Если генерация не удалась, Gems возвращаются — кроме случаев, когда её заблокировала политика контента Mage.
Безопасные повторы
Ключи идемпотентности гарантируют, что повторная отправка вернёт исходный запрос без повторного списания.
Стабильные персонажи
Сохраните персонажа или референс один раз, а затем пишите @handle в любом промпте, чтобы использовать его в каждой модели, которая это поддерживает.
Большие входные файлы
Передавайте изображения, видео и аудио как URL или data URL либо загружайте файлы до 100 МБ через подписанную загрузку.
20 генераций одновременно
Каждый аккаунт может запускать 20 генераций одновременно, а лимит можно повысить под вашу задачу. За отклонённые запросы плата не списывается.
FAQ
Частые вопросы
Что такое Mage API?
Что такое MCP-сервер Mage?
Нужен ли API-ключ для работы с MCP-сервером?
Сколько стоит Mage API?
Нужна ли подписка Mage, чтобы пользоваться API?
Можно ли использовать результаты API в коммерческих целях?
Какие есть лимиты запросов?
Может ли мой ИИ-агент использовать Mage API?
Есть ли SDK для Mage API?
Я уже пользуюсь другим API для генерации. Что нужно изменить?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.