Mage API · Модели

28 моделей генерации, один API

Все модели изображений, видео и аудио в Mage API: для чего каждая лучше всего подходит, значения model_id и цена при настройках по умолчанию.

Получить API-ключОткрыть песочницу
POST https://api.mage.space/v1/{model}/generate

Главное

Mage API запускает 15 моделей изображений, 12 моделей видео и 1 аудиомодель по адресу https://api.mage.space/v1/{model}/generate. Все модели используют один ключ, один жизненный цикл запроса и одинаковые имена полей, а оплата идёт за каждую генерацию в Gems.

Модели изображений

Модели для генерации изображений

Цены указаны за одну генерацию, в 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-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine в трёх уровнях качестваgrok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.075 Gems ($0.075)
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-turbo135 Gems ($0.135)
Nano Banana 2Чёткий, читаемый текст, до 4Knano-banana-v268 Gems ($0.068)
SDXL PlusSDXL с исправленными лицами и руками6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
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)

Модели видео

Модели для генерации видео

МодельЛучше всего подходит дляЗначения model_idЦена по умолчанию
BerryВидео, верное вашим референсамberry, berry-2189 Gems ($0.189)
BlueberryЗадайте первый и последний кадрblueberry, blueberry-v2360 Gems ($0.36)
CherryНаше флагманское семейство видеомоделейcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine в движенииgrok-imagine-video375 Gems ($0.375)
KiwiВидео на каждый день, без настройкиkiwi270 Gems ($0.27)
LemonВсе возможности видео по более доступной ценеlemon245 Gems ($0.245)
LTX VideoБыстрая видеомодель с открытыми весами для итерацийltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonАниме в движении, со звуком по желаниюmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Быстрое открытое видео со стереозвукомminimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumЗвук в каждом клипе, до 2Kplum, plum-max338 Gems ($0.338)
RaspberryПерсонажи оживают с первого кадраraspberry360 Gems ($0.36)
Wan Video v2.2Видеомодель с открытыми весами и версией Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Аудиомодели

Модели для генерации аудио

МодельЛучше всего подходит дляЗначения model_idЦена по умолчанию
Seed AudioГолоса, музыка и звуковые эффекты по одному промптуseed-audio-1.019 Gems ($0.019)

FAQ

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

Сколько стоит 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, все модели. Платите только за то, что генерируете.

Получить API-ключОткрыть песочницу

Похожие материалы