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

Mage API · Генерация изображений

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

Генерация по тексту, редактирование изображений и стабильные персонажи в 18 моделях, включая флагманскую Mango 4 от Mage, — с одним ключом и одним балансом.

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

Главное

API генерации изображений Mage — это REST API по адресу https://api.mage.space/v1, который запускает 18 моделей для генерации по тексту и редактирования изображений, включая Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 и Krea 2. Вы отправляете промпт запросом POST на /{model}/generate, опрашиваете статус запроса и скачиваете изображение. Каждое изображение оплачивается в Gems, без подписки.

  • 18моделей для изображений
  • $0.009Минимальная цена по умолчанию за изображение
  • 20Одновременных генераций
  • $0Абонентская плата

Модели

Все модели для изображений в Mage API

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

МодельЛучше всего подходит дляЗначения model_idЦена по умолчанию
AnimaСоздана специально для анимеanima-v120 Gems ($0.02)
ChromaС открытыми весами, на базе Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Длинные промпты и правки по нескольким референсамflux2-dev40 Gems ($0.04)
GPT Image 2Точные промпты и читаемый текстgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine в двух вариантахgrok-imagine-image, grok-imagine-image-2.090 Gems ($0.09)
GuavaФотореализм, неотличимый от настоящего снимкаguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamБыстрая и универсальная, с негативными промптамиhidream-fast20 Gems ($0.02)
Krea 2Потрясающая эстетика за секундыkrea-2-turbo20 Gems ($0.02)
MangoНаше флагманское семейство моделей для изображенийmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v442 Gems ($0.042)
MiniMax H3 ImageНативные изображения 16 мегапикселей, открытые весаminimax-h3-image15 Gems ($0.015)
MOSS-ImageДлинные промпты и двуязычный текст, открытые весаmoss-image25 Gems ($0.025)
Nano Banana 2Чёткий, читаемый текст, до 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL с исправленными лицами и руками6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
SeedreamSeedream со строгим фильтромseedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.542 Gems ($0.042)
Stable Diffusion v1.5Классика по доступной цене15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeStable Diffusion, который лучше всех понимает промптыsd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL, настроенная на фотореализм6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageСамая быстрая модель для изображений в Magez-image-turbo10 Gems ($0.01)

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

Генерация изображения с Anima v1

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

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 изображений

  • Изображения для товаров и маркетинга

    Создавайте снимки товаров, варианты рекламы и посты для соцсетей по запросу — с читаемым текстом от GPT Image 2.6 или Nano Banana 2.

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

    Сохраните персонажа один раз и сохраняйте одно и то же лицо во всей серии с Mango 4, Guava 2 Pro и другими моделями, которые понимают упоминания @handle.

  • Пайплайны редактирования изображений

    Отправьте исходное изображение с инструкцией — изменится именно то, что вы просите, а всё остальное останется на месте.

  • Приложения и игры

    Создавайте аватары, стикеры, карточки и сцены прямо в своём продукте — без единого собственного GPU.

  • Фотореалистичные портреты

    Guava 2 Pro создаёт портреты, fashion- и lifestyle-кадры с реалистичной кожей, тканью и светом.

  • Быстрые черновики в больших объёмах

    Z-Image Turbo и Krea 2 сохраняют низкие цены для превью в большом количестве и первых набросков.

FAQ

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

Какой API нейросети для генерации изображений лучший?
Зависит от задачи. В Mage Mango 4 — модель по умолчанию для большинства изображений: она точно следует инструкциям, сохраняет персонажей одинаковыми и редактирует, не затрагивая остальную часть изображения. Guava 2 Pro лучше всего подходит для фотореализма, GPT Image 2.6 и Nano Banana 2 — для текста на изображениях, а Z-Image Turbo или Krea 2 — для быстрых и недорогих черновиков. Все они работают через один и тот же API.
Поддерживает ли API изображений редактирование и референсы?
Да. Модели, которые принимают изображения, получают их в полях image и additional_images в виде URL, data URL или загрузок. На странице каждой модели указано, какие входные данные она принимает и сколько референсов поддерживает.
Какие разрешения поддерживает API изображений?
Зависит от модели: 1K и 2K у большинства моделей, 3K у Mango 3S и до 4K у Mango 2 и Nano Banana 2. На странице каждой модели указаны доступные разрешения и соотношения сторон.
Сколько стоит 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Сообщество