gemini-3-pro-image API

Используйте точный идентификатор модели gemini-3-pro-image. Поле модели должно точно соответствовать этой странице.

Пример выводаgemini-3-pro-imagePOST /v1beta/models/gemini-3-pro-image:generateContent

Параметры: size=2Kratio=16:9

Промпт: Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text.

Запрос, по которому был создан этот образец

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

Аутентификация и конечная точка

Используйте ключ API Modelflare с https://modelflare.dev. Точка входа шлюза — POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать изображение

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

Запросить примечания

Модели изображений Gemini используют собственные contents и generationConfig; редактирование отправляет текстовую инструкцию и inline_data в тот же parts[].

Запрос параметров

Модели изображений Gemini используют собственный Gemini generateContent. Поместите текст и эталонные изображения в один и тот же contents[].parts[]; изображения используют inline_data. Не отправляйте эти модели в /v1/images/generations, /v1/images/edits или OpenAI /v1/responses. Перечисление imageSize зависит от модели и показано ниже.

Поле	Обязательно	Примечания
contents[].parts[].text	Да	Текстовая подсказка или инструкция по редактированию
contents[].parts[].inline_data	Нет	Данные изображения Base64 и тип MIME
contents[].parts[].inline_data.mime_type	Нет	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	Нет	Содержимое эталонного изображения в кодировке Base64
generationConfig.responseModalities	Да	["IMAGE"] или ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	Нет	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	Нет	1K / 2K / 4K

Пределы отклика и ввода

Pro поддерживает 1K, 2K и 4K с 1:1, 4:3, 3:4, 16:9 и 9:16. В официальной документации не публикуется ограничение количества эталонных изображений, поэтому шлюз не устанавливает локального ограничения.

Пример редактирования изображения

Поместите инструкцию редактирования и эталонное изображение в один и тот же contents[].parts[]. inline_data.data — содержимое изображения Base64; не отправляйте модели изображений Gemini в конечные точки изображений OpenAI или Responses.

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

Форма ответа

Прочитать candidates[].content.parts[]; не предполагайте, что каждая часть является изображением, поскольку ответ может содержать вместе части текста и изображения.

Поле	Примечания
candidates[].content.parts[].inline_data	Тип MIME сгенерированного изображения и данные Base64
candidates[].content.parts[].text	Текстовая подпись возвращается при запросе ТЕКСТА
candidates[].finishReason	Завершение или причина безопасности
usageMetadata	Использование токена ввода/вывода, возвращаемого службой

Modelflare сохраняет исходную форму ответа Gemini для gemini-3-pro-image и сохраняет пригодные для использования части изображения.

Ошибки и невыполненные задачи

Ошибки полей, ограничения размера/соотношения и отказы безопасности от собственного запроса Gemini остаются совместимыми с Gemini ответами на ошибки. Шлюз не перезаписывает их как ответы изображений OpenAI.

Поддерживаемая область применения

На этой странице описаны вызовы создания и редактирования модели Modelflare. Поиск или расширение карты, голосовое управление и управление библиотекой элементов — это API-интерфейсы ресурсов, находящиеся за пределами этой общедоступной поверхности вызова модели, и они не являются обязательными полями запроса.

Цены и выставление счетов

В этой модели используется биллинг на основе токенов. Текущую цену для клиентов, цену по справочному прейскуранту и полную спецификацию см. на странице цен модели .

Заметка

На этой странице документирован публичный интерфейс Modelflare; показанные здесь поля и ограничения соответствуют текущему контракту.