от 3 кредитов за вызов
API генерации изображений с ИИ
Генерируйте изображения по текстовому промпту одним JSON-запросом. До четырёх образцов за вызов, три модели для баланса скорости и качества и полные коммерческие права на результат.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/generate-image
Что такое API генерации изображений с ИИ?
API генерации изображений ImgGen AI — это REST-эндпоинт, который превращает текстовый промпт в изображения. Вы отправляете JSON-тело с промптом, нужным числом образцов, соотношением сторон и выбранной моделью; эндпоинт возвращает сгенерированные изображения в массиве в кодировке base64. Это единственный эндпоинт, который принимает JSON, а не файл.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте AI Image Generator.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/generate-image с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| prompt | string | ОБЯЗАТЕЛЬНЫЙ | — | Текстовое описание изображения, которое нужно сгенерировать. |
| samples | number | необязательный | 1 | Сколько изображений сгенерировать, от 1 до 4. |
| aspect_ratio | string | необязательный | square | Форма вывода. Принимает square, portrait или landscape. |
| model | string | необязательный | imggen-base | Модель генерации. Принимает imggen-base, imggen-base-fast или imggen-xl. |
Как встроить API генерации изображений с ИИ?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на cURL, Node.js и Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/generate-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base"
}'import fs from 'node:fs';
const res = await fetch('https://app.imggen.ai/v1/generate-image', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'close up photo of a rabbit in a wildflower meadow',
samples: 1,
aspect_ratio: 'square',
model: 'imggen-base',
}),
});
const data = await res.json();
data.images.forEach((img, i) =>
fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);import base64, os, requests
res = requests.post(
"https://app.imggen.ai/v1/generate-image",
headers={
"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
"Content-Type": "application/json",
},
json={
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base",
},
)
for i, img in enumerate(res.json()["images"]):
with open(f"image-{i}.png", "wb") as out:
out.write(base64.b64decode(img))Ответ
Успешный вызов возвращает JSON. Результат приходит в кодировке base64 — декодируйте его перед записью на диск или в объектное хранилище. Каждый успешный ответ также содержит заголовок X-Credit-Remaining с вашим балансом после вызова.
{
"success": true,
"message": "Images generated successfully",
"images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}Ограничения и поведение, о которых стоит знать
Эндпоинт принимает JPEG (JPG), PNG и WebP с максимальным размером файла 25 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Возвращает массив images
В отличие от эндпоинтов редактирования, которые возвращают одно поле image, генерация возвращает images — массив с одной записью на каждый запрошенный образец.
Три модели
imggen-base — баланс по умолчанию, imggen-base-fast меняет детализацию на скорость, а imggen-xl нацелена на максимальное качество. Выбор делается на каждый запрос, а не на аккаунт.
JSON, а не multipart
Это единственный эндпоинт, принимающий JSON-тело. Отправляйте Content-Type: application/json вместо multipart-формы.
Для чего используют API генерации изображений с ИИ?
Где команды используют этот эндпоинт в продакшене, чтобы обрабатывать изображения программно и в больших объёмах.
Редакционные и блоговые изображения
Генерируйте для каждой статьи собственную заглавную картинку по заголовку, вместо того чтобы брать её из стокового банка, которым пользуются все остальные.
Проработка продукта и кампаний
Получайте четыре варианта визуальной идеи за один вызов, чтобы команда выбрала направление до заказа настоящей работы.
Творческие функции в приложении
Дайте пользователям генерировать изображения внутри вашего продукта, не поднимая GPU-инфраструктуру.
Заглушки и демо-контент
Наполняйте демо, прототипы и тестовые окружения правдоподобными изображениями, созданными по требованию.
Сколько стоит API генерации изображений с ИИ?
Каждый успешный вызов стоит от 3 кредитов, поэтому фактическая стоимость изображения зависит от вашего тарифа. Кредиты берутся из вашего тарифа и общие для всех эндпоинтов и веб-редактора, так что отдельную квоту на каждый инструмент покупать не нужно. Неудачный вызов возвращается автоматически. Все подробности — на странице тарифов.
| Тариф | Цена | Кредиты | API |
|---|---|---|---|
| Free | $0 | 50 бесплатных кредитов единоразово | Без доступа к API |
| Starter | $9.99 / month | 400 кредитов / месяц | Доступ к API включён |
| Pro | $29.99 / month | 1 400 кредитов / месяц | Доступ к API + приоритетная поддержка |
| Enterprise | Custom | Индивидуальный объём | Выделенная инфраструктура |
Стоимость в кредитах и лимиты последний раз проверены 2026-08-27.
Связанные эндпоинты и инструменты
Команды, которые используют API генерации изображений с ИИ, обычно следом берут эти.
Также доступны: Удаление водяных знаков, Удаление текста, Реставрация фотографий, Колоризация фотографий.
Вопросы об API генерации изображений с ИИ
- Это HTTP-эндпоинт, который превращает письменное описание в изображение. Вы отправляете промпт в JSON, а сервис возвращает сгенерированные изображения в ответе — это позволяет продукту предлагать «текст в изображение», не запуская собственную инфраструктуру моделей.
- От одного до четырёх, задаётся параметром samples. Все запрошенные изображения приходят в одном массиве images того же ответа.
- Три: imggen-base — модель по умолчанию, балансирует качество и скорость; imggen-base-fast отдаёт результат быстрее с меньшей детализацией; imggen-xl нацелена на максимальное качество. Выбор делается на каждый запрос параметром model.
- square, portrait и landscape, задаются параметром aspect_ratio. Если его не указать, по умолчанию используется square.
- Генерация оплачивается по модели, а не по фиксированной ставке, потому что модели заметно различаются по вычислениям. Она начинается с 3 кредитов за изображение на модели по умолчанию и растёт для более качественных. Остаток баланса приходит в заголовке X-Credit-Remaining каждого успешного вызова, а актуальная стоимость каждой модели показана в вашем аккаунте ImgGen.
- Вам. ImgGen не заявляет прав собственности ни на что из того, что возвращает API, и каждый тариф даёт полные коммерческие права без водяного знака. Учтите, что авторское право на изображения, созданные ИИ, в разных юрисдикциях трактуется по-разному, поэтому если вопрос собственности для вас юридически принципиален, проверьте местные нормы.
- Да. Все тарифы, включая бесплатный, дают полные коммерческие права на использование, и ни один результат не содержит водяного знака. Всё, что возвращает API, вы можете продавать, печатать или публиковать.
- Сгенерированные изображения возвращаются в ответе и не сохраняются. Как и на любом эндпоинте ImgGen, остаётся только запись в журнале использования о том, что вызов состоялся и сколько он стоил. Ваш контент не используется для обучения моделей.
Начать
Начните вызывать API генерации изображений с ИИ
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API