Доступные модели
gemini-nano-banana-2.1 и gemini-3-pro-image на странице цен показано, сколько примерно стоит одна картинка 1K, 2K и 4K. Модели с оплатой за вызов стоят одну фиксированную цену за вызов.
Адрес API и авторизация
- Модели Gemini Image (рекомендуем):
POST https://www.ruapi.ai/v1beta/models/ID_МОДЕЛИ:generateContent— нативный формат Google - Модели Gemini Image через OpenAI-совместимый формат:
POST https://www.ruapi.ai/v1/chat/completions— толькоgemini-nano-banana-2.1иgemini-3.1-flash-image - GPT Image:
POST https://www.ruapi.ai/v1/images/generations(генерация),POST https://www.ruapi.ai/v1/images/edits(редактирование) - Base URL для OpenAI SDK:
https://www.ruapi.ai/v1(для Google GenAI SDK —https://www.ruapi.ai, см. ниже). Полные адреса SDK собирает сам - Авторизация: ключ RuAPI
sk-...(создаётся в панели, раздел «API-ключи»). В нативном формате Google его можно передать в заголовкеx-goog-api-key: sk-ВАШ_КЛЮЧ(так делает Google GenAI SDK) илиAuthorization: Bearer sk-ВАШ_КЛЮЧ; в остальных —Authorization: Bearer sk-ВАШ_КЛЮЧ
Способ 1. Gemini Image — нативный формат Google (рекомендуем)
Запросы отправляются наhttps://www.ruapi.ai/v1beta/models/ID_МОДЕЛИ:generateContent — в том же формате, что и в Gemini API от Google. Изображение приходит отдельным полем — в candidates[0].content.parts[].inlineData.data (base64), рядом может быть часть с текстом.
Текст → изображение
Параметры картинки
Параметры задаются вgenerationConfig.imageConfig (в Python SDK — types.ImageConfig):
Изображение → изображение (редактирование)
Исходную картинку передайте частьюinlineData (base64) рядом с текстом задания. Пример ниже можно запустить как есть: он скачивает тестовую картинку в photo.png; для своей картинки подставьте свой файл.
Многошаговое редактирование
В SDK удобно вести диалог черезclient.chats: SDK сам возвращает модели предыдущие ответы вместе с картинками.
Поддерживаемые форматы входных изображений
image/png, image/jpeg, image/webp, image/heic, image/heif. Всё остальное будет отклонено с ошибкой mime type is not supported by Gemini.
Способ 2. Gemini Image — через OpenAI-совместимый /v1/chat/completions
Модели gemini-nano-banana-2.1 и gemini-3.1-flash-image можно вызывать и через https://www.ruapi.ai/v1/chat/completions — например, если ваш код или клиент умеет только формат OpenAI. Запросы составляются так же, как для текстовой модели, — разница лишь в том, что в ответе приходит изображение. Остальные модели Gemini Image в этом формате часто отвечают только текстом: для них используйте «Способ 1».
Текст → изображение
Изображение → изображение (редактирование)
Чтобы отредактировать существующее изображение, передайте его в том же формате, что и для vision-моделей: массивcontent с частями text и image_url. В url можно подставить как обычную ссылку, так и data URI. Пример ниже можно запустить как есть; для своей картинки замените ссылку в url.
Многошаговое редактирование
Ответ модели можно вернуть обратно вmessages как сообщение assistant — Markdown data URI будет распознан и изображение уйдёт на вход следующего шага. Так строится диалог «сделай чёрно-белым» → «а теперь добавь рамку».
Способ 3. GPT Image — через /v1/images/generations
gpt-image-2 работает в стандартном формате OpenAI для генерации изображений: запросы отправляются на https://www.ruapi.ai/v1/images/generations. Никаких messages, только prompt. Модели gpt-image-2.6-flare, gpt-image-2.6-sunburst, gpt-image-2.5-flare и gpt-image-2.5-sunburst вызываются так же — достаточно поменять model. Новые параметры GPT Image 2.6 и цена картинки — в обзоре GPT Image 2.6.
Параметры
Ответ
Частые вопросы
Почему модели Gemini Image не работают через /v1/images/generations?
Почему модели Gemini Image не работают через /v1/images/generations?
https://www.ruapi.ai/v1beta/models/ID_МОДЕЛИ:generateContent (см. «Способ 1»), а для gemini-nano-banana-2.1 и gemini-3.1-flash-image можно и на https://www.ruapi.ai/v1/chat/completions (см. «Способ 2»). Если всё же отправить запрос на /v1/images/generations, придёт ошибка 400, в которой указан правильный адрес.Модель через /v1/chat/completions отвечает текстом без картинки
Модель через /v1/chat/completions отвечает текстом без картинки
gemini-nano-banana-2.1 и gemini-3.1-flash-image. gemini-3-pro-image (nano-banana-pro), gemini-3.1-flash-lite-image и другие модели Gemini Image вызывайте в нативном формате Google — см. «Способ 1». Для подходящих моделей прямо пишите в запросе «Сгенерируй изображение: …».Работает ли Google GenAI SDK?
Работает ли Google GenAI SDK?
http_options={"base_url": "https://www.ruapi.ai"} (без /v1beta), остальной код менять не нужно — пример в «Способе 1». Interactions API в RuAPI нет: используйте generate_content и chats.Ошибка «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 (см. «Способ 1») изображение приходит отдельным полем.Какую модель выбрать для редактирования фотографий?
Какую модель выбрать для редактирования фотографий?
gemini-nano-banana-2.1 или gemini-3.1-flash-image — хорошее соотношение цены и качества для правок. Если нужен максимум детализации, берите gemini-3-pro-image в нативном формате Google. gemini-2.5-flash-image Google отключит 15 марта 2027 года — для новых проектов её лучше не брать. gpt-image-2 тоже умеет редактировать, но запросы для этого отправляются на отдельный адрес https://www.ruapi.ai/v1/images/edits.Сколько хранятся результаты?
Сколько хранятся результаты?
В ответе Gemini есть usage с токенами — за них списывают?
В ответе Gemini есть usage с токенами — за них списывают?
gemini-nano-banana-2.1, gemini-3-pro-image, gemini-3.1-flash-image и gemini-3.1-flash-lite-image тарифицируются по токенам — списание идёт по usage (в нативном формате — usageMetadata). Модели с оплатой за вызов (gemini-3-pro-image-preview, gemini-3.1-flash-image-preview, gemini-2.5-flash-image) стоят одну фиксированную цену за вызов, а usage приходит справочно и на списание не влияет. Вызов, в котором модель ответила только текстом, тоже оплачивается — поэтому прямо просите сгенерировать изображение.Ошибка «Your request was rejected by the safety system»
Ошибка «Your request was rejected by the safety system»
gpt-image-2 нарушающим правила. Иногда она ошибается — например, на описаниях маленьких детей или известных людей. Переформулируйте запрос и повторите. Отклонённые запросы не оплачиваются.