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-v1 | 20 Gems ($0.02) |
| Chroma | С открытыми весами, на базе Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Длинные промпты и правки по нескольким референсам | flux2-dev | 40 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-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine в двух вариантах | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Фотореализм, неотличимый от настоящего снимка | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Быстрая и универсальная, с негативными промптами | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Потрясающая эстетика за секунды | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Наше флагманское семейство моделей для изображений | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Нативные изображения 16 мегапикселей, открытые веса | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Длинные промпты и двуязычный текст, открытые веса | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Чёткий, читаемый текст, до 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL с исправленными лицами и руками | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream со строгим фильтром | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | Классика по доступной цене | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion, который лучше всех понимает промпты | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL, настроенная на фотореализм | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Самая быстрая модель для изображений в Mage | z-image-turbo | 10 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-ключа до готового результата за три вызова
У всех моделей одна схема аутентификации, один жизненный цикл асинхронного запроса и одинаковые названия полей.
Создайте 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 дней.
Готово к продакшену
Что получает каждый запрос к 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 нейросети для генерации изображений лучший?
Поддерживает ли API изображений редактирование и референсы?
Какие разрешения поддерживает API изображений?
Сколько стоит Mage API?
Нужна ли подписка Mage, чтобы пользоваться API?
Можно ли использовать результаты API в коммерческих целях?
Какие есть лимиты запросов?
Может ли мой ИИ-агент использовать Mage API?
Есть ли SDK для Mage API?
Я уже пользуюсь другим API для генерации. Что нужно изменить?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.