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

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

  • 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 для генерации

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

Ваша первая генерация

Создайте ключ в разделе 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-ключа до готового результата за три вызова

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

  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 дней.

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

    Фотореализм, неотличимый от настоящего снимка

  • Изображение · от 42 Gems

    Mango API

    Наше флагманское семейство моделей для изображений

  • Изображение · от 51 Gems

    Nano Banana 2 API

    Чёткий, читаемый текст, до 4K

  • Видео · от 618 Gems

    Cherry API

    Наше флагманское семейство моделей для видео

  • Видео · от 245 Gems

    Lemon API

    Все возможности видео по более доступной цене

  • Видео · от 173 Gems

    Plum API

    Звук в каждом клипе, до 2K

  • Аудио · от 19 Gems

    Seed Audio API

    Голоса, музыка и звуковые эффекты из одного промпта

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FAQ

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

Что такое Mage API?
Mage API — это REST API по адресу https://api.mage.space/v1 для генерации изображений, видео и аудио в вашем коде с помощью 37 моделей. Запросы асинхронные, оплата за каждую генерацию в 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 не распространяются. Сначала на аккаунте должен пройти один успешный платёж: подойдёт любой пакет 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Сообщество