Перейти к основному содержанию
RuAPI даёт доступ к двум семействам моделей генерации изображений: Gemini Image (в народе — Nano Banana) и GPT Image. Они вызываются по-разному, и это главное, что нужно понять перед началом. Оплата в USDT, без зарубежной карты.
Модели Gemini Image не работают через /v1/images/generations. Надёжнее всего вызывать их в нативном формате Google — POST https://www.ruapi.ai/v1beta/models/ID_МОДЕЛИ:generateContent: картинка приходит отдельным полем, без разбора Markdown. Через OpenAI-совместимый /v1/chat/completions стабильно рисуют только gemini-nano-banana-2.1 и gemini-3.1-flash-image.

Доступные модели

Актуальные цены — на странице цен. Модели с оплатой по токенам стоят тем дороже, чем больше и качественнее картинка; для 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-ВАШ_КЛЮЧ
Примеры на curl ниже сразу сохраняют картинку в файл в текущей папке — достаточно подставить свой ключ. Они работают в macOS, Linux и в Windows через Git Bash или WSL; в обычной командной строке Windows (cmd, PowerShell) используйте пример на Python. Если картинки в ответе нет, команда выводит ответ API целиком — там будет указана причина.

Способ 1. Gemini Image — нативный формат Google (рекомендуем)

Запросы отправляются на https://www.ruapi.ai/v1beta/models/ID_МОДЕЛИ:generateContent — в том же формате, что и в Gemini API от Google. Изображение приходит отдельным полем — в candidates[0].content.parts[].inlineData.data (base64), рядом может быть часть с текстом.

Текст → изображение

В Google GenAI SDK достаточно поменять адрес: http_options={"base_url": "https://www.ruapi.ai"}, без /v1beta — SDK добавит его сам. Ключ SDK передаёт в заголовке x-goog-api-key, RuAPI его принимает. Interactions API (client.interactions) в RuAPI нет — используйте generate_content.

Параметры картинки

Параметры задаются в 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».
Изображение приходит как Markdown-ссылка с data URI прямо внутри choices[0].message.content — отдельного поля для картинки нет. Ответ выглядит так:
Base64 нужно вытащить из текста. Примеры ниже делают это сами и сохраняют картинку в файл.

Текст → изображение

Иногда модель отвечает только текстом, без картинки. Такой вызов тоже оплачивается — по израсходованным токенам. Чтобы этого не случалось, прямо пишите в запросе «Сгенерируй изображение: …». Если картинки всё равно нет, переформулируйте запрос и повторите.
Изображений в ответе может быть несколько — поэтому в примере на Python используется findall, а не search; команда на curl сохраняет первое. Рядом с картинкой модель почти всегда пишет короткую подпись.

Изображение → изображение (редактирование)

Чтобы отредактировать существующее изображение, передайте его в том же формате, что и для vision-моделей: массив content с частями text и image_url. В url можно подставить как обычную ссылку, так и data URI. Пример ниже можно запустить как есть; для своей картинки замените ссылку в url.
Соотношение сторон исходного изображения сохраняется — результат не обрезается до квадрата.

Многошаговое редактирование

Ответ модели можно вернуть обратно в messages как сообщение assistant — Markdown data URI будет распознан и изображение уйдёт на вход следующего шага. Так строится диалог «сделай чёрно-белым» → «а теперь добавь рамку».
Каждый шаг — это отдельный платный вызов. Кроме того, история с base64-изображениями быстро раздувает запрос: не тащите в контекст больше двух-трёх последних кадров.

Способ 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.

Параметры

Ответ

Картинка приходит только в b64_json — это сам PNG-файл в base64. Ссылки на изображение в ответе нет, и мы не храним сгенерированные картинки: сохраните файл сразу, повторно его не получить.
usage.output_tokens — это токены изображения, по ним и считается стоимость. Понижение quality до low уменьшает их в разы: удобно для черновиков и тестов.

Частые вопросы

Потому что это не модели генерации изображений в терминах OpenAI, а мультимодальные модели, которые умеют отдавать картинки. Отправляйте запрос в нативном формате Google на 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, в которой указан правильный адрес.
В OpenAI-совместимом формате стабильно рисуют только 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». Для подходящих моделей прямо пишите в запросе «Сгенерируй изображение: …».
Да. Укажите ключ RuAPI и http_options={"base_url": "https://www.ruapi.ai"} (без /v1beta), остальной код менять не нужно — пример в «Способе 1». Interactions API в RuAPI нет: используйте generate_content и chats.
Ваш клиент отправляет вместе с запросом инструменты (tools) — так делают агенты и чат-клиенты с включёнными MCP или плагинами. Модели для изображений инструменты не поддерживают. Отключите инструменты и MCP в этом чате (или заведите отдельного ассистента без них) и повторите запрос. Такие неудачные запросы не оплачиваются.
Это и есть изображение. Когда ответ приходит через /v1/chat/completions, картинка вставляется в текст как ![image](data:image/png;base64,...). Примеры выше сами вытаскивают её и сохраняют в файл. В нативном формате 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-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 приходит справочно и на списание не влияет. Вызов, в котором модель ответила только текстом, тоже оплачивается — поэтому прямо просите сгенерировать изображение.
Это модерация OpenAI: она сочла запрос к gpt-image-2 нарушающим правила. Иногда она ошибается — например, на описаниях маленьких детей или известных людей. Переформулируйте запрос и повторите. Отклонённые запросы не оплачиваются.