Доступные модели
Актуальные цены — на странице цен. Модели Gemini тарифицируются за вызов (одна фиксированная цена за картинку),
gpt-image-2 — по токенам (чем больше и качественнее картинка, тем дороже).
Адрес API и авторизация
- Модели Gemini Image:
POST https://www.ruapi.ai/v1/chat/completions - GPT Image:
POST https://www.ruapi.ai/v1/images/generations(генерация),POST https://www.ruapi.ai/v1/images/edits(редактирование) - Base URL:
https://www.ruapi.ai/v1. В SDK указывается только он — полные адреса выше SDK собирает сам - Авторизация: заголовок
Authorization: Bearer sk-ВАШ_КЛЮЧ(создаётся в панели, раздел «API-ключи»)
Примеры на curl ниже сразу сохраняют картинку в файл в текущей папке — достаточно подставить свой ключ. Они работают в macOS, Linux и в Windows через Git Bash или WSL; в обычной командной строке Windows (cmd, PowerShell) используйте пример на Python. Если картинки в ответе нет, команда выводит ответ API целиком — там будет указана причина.
Способ 1. Gemini Image — через /v1/chat/completions
Запросы к моделям Gemini Image отправляются на https://www.ruapi.ai/v1/chat/completions. Составляются они так же, как для текстовой модели, — разница лишь в том, что в ответе приходит изображение.
Текст → изображение
Изображение → изображение (редактирование)
Чтобы отредактировать существующее изображение, передайте его в том же формате, что и для vision-моделей: массивcontent с частями text и image_url. В url можно подставить как обычную ссылку, так и data URI. Пример ниже можно запустить как есть; для своей картинки замените ссылку в url.
Соотношение сторон исходного изображения сохраняется — результат не обрезается до квадрата.
Многошаговое редактирование
Ответ модели можно вернуть обратно вmessages как сообщение assistant — Markdown data URI будет распознан и изображение уйдёт на вход следующего шага. Так строится диалог «сделай чёрно-белым» → «а теперь добавь рамку».
Поддерживаемые форматы входных изображений
image/png, image/jpeg, image/webp, image/heic, image/heif. Всё остальное будет отклонено с ошибкой mime type is not supported by Gemini.
Нативный формат Google
Если вы уже пишете под Google GenAI SDK, тот же ключ работает и с собственным форматом Google — по адресуhttps://www.ruapi.ai/v1beta/models/ID_МОДЕЛИ:generateContent:
candidates[0].content.parts[].inlineData.data (base64), без Markdown. Если вам не нужна совместимость с OpenAI SDK, этот вариант удобнее.
Способ 2. GPT Image — через /v1/images/generations
gpt-image-2 работает в стандартном формате OpenAI для генерации изображений: запросы отправляются на https://www.ruapi.ai/v1/images/generations. Никаких messages, только prompt.
Параметры
Ответ
Частые вопросы
Почему gemini-2.5-flash-image не работает через /v1/images/generations?
Почему gemini-2.5-flash-image не работает через /v1/images/generations?
Потому что это не модель генерации изображений в терминах OpenAI, а мультимодальная чат-модель, которая умеет отдавать картинки. Отправляйте запрос на
https://www.ruapi.ai/v1/chat/completions — см. «Способ 1». Если всё же отправить его на /v1/images/generations, придёт ошибка 400, в которой указан правильный адрес.Ошибка «Function calling is not enabled for this model»
Ошибка «Function calling is not enabled for this model»
Ваш клиент отправляет вместе с запросом инструменты (
tools) — так делают агенты и чат-клиенты с включёнными MCP или плагинами. Модели для изображений инструменты не поддерживают. Отключите инструменты и MCP в этом чате (или заведите отдельного ассистента без них) и повторите запрос. Такие неудачные запросы не оплачиваются.Что за огромная строка base64 в поле content?
Что за огромная строка base64 в поле content?
Это и есть изображение. Когда ответ приходит через
/v1/chat/completions, картинка вставляется в текст как . Примеры выше сами вытаскивают её и сохраняют в файл. Можно также перейти на нативный формат Google (см. раздел «Нативный формат Google» выше), где изображение приходит отдельным полем.Какую модель выбрать для редактирования фотографий?
Какую модель выбрать для редактирования фотографий?
gemini-2.5-flash-image — лучшее соотношение цены и качества для правок. Если нужен максимум детализации, берите gemini-3-pro-image-preview. gpt-image-2 тоже умеет редактировать, но запросы для этого отправляются на отдельный адрес https://www.ruapi.ai/v1/images/edits.Сколько хранятся результаты?
Сколько хранятся результаты?
Нисколько. Мы не храним сгенерированные изображения: картинка приходит один раз — в ответе на ваш запрос. Сохраните её сразу, получить её повторно нельзя.
В ответе Gemini есть usage с токенами — за них списывают?
В ответе Gemini есть usage с токенами — за них списывают?
Нет. Модели Gemini Image тарифицируются за вызов: одна фиксированная цена за вызов. Поле
usage приходит справочно и на списание не влияет. По токенам считается только gpt-image-2. Вызов, в котором модель ответила только текстом, тоже оплачивается — поэтому прямо просите сгенерировать изображение.Ошибка «Your request was rejected by the safety system»
Ошибка «Your request was rejected by the safety system»
Это модерация OpenAI: она сочла запрос к
gpt-image-2 нарушающим правила. Иногда она ошибается — например, на описаниях маленьких детей или известных людей. Переформулируйте запрос и повторите. Отклонённые запросы не оплачиваются.