Image API≈ 4 мин чтения

API генерации изображений: цены в рублях

Как устроен API генерации изображений NeuroAPI: эндпоинты, асинхронный режим, доступные модели и подход к стоимости.

Короткий ответ

Краткий ответ

Генерация и редактирование изображений через единый API NeuroAPI: GPT Image, Gemini Image, Qwen Image, Wan. Синхронные и асинхронные задачи, цены в рублях.

11

моделей с изображениями

Публичный каталог /price на 18.10.2026: GPT Image, Gemini Image, Qwen Image, Wan и Z-Image; ставки в рублях.

Sync

генерация и редактирование

POST /v1/images/generations и POST /v1/images/edits (multipart/form-data) для OpenAI-совместимых клиентов.

Async

durable-задачи

POST /v1/images/generations/async: оплаченная генерация доводится до конца, даже если клиент отключился.

Gemini

нативный generateContent

POST /v1beta/models/{model}:generateContent с aspectRatio и imageSize в generationConfig.

Один ключ

Генерация и редактирование изображений доступны через тот же API-ключ, что и текстовые модели.

Async без потери задач

Асинхронная генерация доводит оплаченную задачу до конца даже при отключении клиента; результат забирается опросом.

Нативный Gemini

Для Gemini Image доступен нативный вызов generateContent с aspectRatio и imageSize.

Цена — в каталоге

Стоимость зависит от модели, размера и качества. Актуальные ставки — в карточке модели на /price.

От запроса до изображения за 4 шага

  1. 1

    Выберите модель и режим

    Model ID и параметры берите в карточке модели на /price: там указаны поддерживаемые размеры, качество и возможность редактирования.

  2. 2

    Отправьте запрос

    Короткая генерация — POST /v1/images/generations; редактирование загруженного изображения — POST /v1/images/edits с multipart/form-data.

  3. 3

    Для длинных генераций включите async

    POST /v1/images/generations/async создаёт задачу: сервер доводит оплаченную генерацию до конца независимо от сетевого отключения клиента.

  4. 4

    Заберите результат и сверьте списание

    Статус и изображение возвращает GET /v1/images/generations/async/{task_id}; ставку за запрос сверяйте в карточке модели, а расход — в кабинете.

Один и тот же ключ работает и для изображений, и для текстовых моделей; тариф выбирается при создании ключа и влияет на маршрут.

Эндпоинты генерации изображений

Для изображений NeuroAPI поддерживает OpenAI-совместимый путь: синхронную генерацию POST /v1/images/generations и редактирование POST /v1/images/edits (multipart/form-data). Эти маршруты подходят существующим клиентам и SDK, если модель поддерживает нужный режим.

Для длинных генераций используйте durable-режим: POST /v1/images/generations/async создаёт задачу, а GET /v1/images/generations/async/{task_id} возвращает статус и результат. Тело запроса, авторизация и цены совпадают с синхронным вызовом.

Для моделей Gemini доступен нативный вызов POST /v1beta/models/{model}:generateContent с полями aspectRatio и imageSize в generationConfig. Какой путь выбрать — зависит от клиента и модели.

  • POST /v1/images/generations — синхронная генерация.
  • POST /v1/images/edits — редактирование изображения (multipart).
  • POST /v1/images/generations/async + GET .../{task_id} — durable async.
  • POST /v1beta/models/{model}:generateContent — нативный Gemini Image.

Какие модели доступны

Публичный каталог на 18 октября 2026 включает 11 моделей с генерацией изображений: gpt-image-2.5-flare, gpt-image-2, gpt-image-2.5-sunburst, gemini-3-pro-image, gemini-3.1-flash-image, gemini-3.1-flash-lite-image, qwen-image-2.0, qwen-image-2.0-pro, wan2.7-image, wan2.7-image-pro и z-image-turbo.

Список и цены меняются вместе с публикацией каталога: перед интеграцией откройте /price и карточку конкретной модели. Названия моделей в запросе должны точно совпадать с Model ID из каталога.

  • Генерация с нуля: text-to-image модели.
  • Редактирование: зависит от модели и поддерживаемых полей.
  • Gemini Image: нативный generateContent и OpenAI-совместимый путь.
  • Наличие модели зависит от тарифа API-ключа.

Как считается стоимость

Тарификация изображений зависит от модели, размера, качества и числа изображений в запросе. Единой цены «за картинку» нет: ставки хранятся в карточке модели и обновляются вместе с каталогом.

Перед запуском массовой генерации оцените стоимость одного запроса в карточке модели и заложите запас на повторы. Неуспешный запрос не должен списывать квоту — правила возврата описаны в документации.

  • Стоимость зависит от модели и параметров запроса.
  • Актуальные рублёвые ставки — только в карточке модели.
  • Для массовых задач используйте async и бюджеты на ключах.

Сценарии и ограничения

Типичные сценарии: иллюстрации для контента, обложки, баннеры, генерация вариантов дизайна, обработка загруженных изображений. Для продуктовых каталогов и юридически значимых материалов проверяйте права и требования к изображениям.

Ограничения зависят от модели: поддерживаемые размеры, форматы, наличие редактирования и число изображений за запрос различаются. Перед интеграцией проверьте карточку модели и документацию по изображениям.

  • Контент и маркетинг: обложки, иллюстрации, баннеры.
  • Дизайн: варианты и итерации по промпту.
  • Обработка: редактирование и улучшение загруженных изображений.
  • Проверяйте права и ограничения выбранной модели.

Асинхронные пайплайны и лимиты

Для массовой генерации используйте асинхронный режим: сервер доводит оплаченную задачу до конца, даже если клиент отключился, а результат забирается опросом. Это удобно для пакетной обработки каталога, обложек и вариантов дизайна.

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

  • Async подходит для пакетной обработки.
  • Результат забирается опросом по task_id.
  • Ограничивайте параллельные задачи и следите за лимитами.
  • Не повторяйте неоднозначный платный запрос слепо.

Синхронная генерация

bash
curl https://neuroapi.host/v1/images/generations \
  -H "Authorization: Bearer $NEUROAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<IMAGE_MODEL_ID>","prompt":"минималистичная обложка для статьи об API","size":"1024x1024"}'

Асинхронная задача

bash
curl https://neuroapi.host/v1/images/generations/async \
  -H "Authorization: Bearer $NEUROAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<IMAGE_MODEL_ID>","prompt":"постер с градиентом"}'

# затем
curl https://neuroapi.host/v1/images/generations/async/<TASK_ID> \
  -H "Authorization: Bearer $NEUROAPI_API_KEY"

Проверьте генерацию изображений на своём промпте

11 моделей с ценами в рублях, синхронный и асинхронный режимы, нативный Gemini-вызов — на одном ключе с текстовыми моделями. Начните с одной недорогой генерации, чтобы сверить результат и списание.

Создать ключДокументация по изображениям

Состав каталога — на 18.10.2026; наличие модели и её возможности проверяйте в карточке на /price.