gemini-3.1-flash-image API

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

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

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

Промпт: The cold room of a flower shop, steel shelves and buckets of cut stems. A figure in an acid-green vinyl coat has just pulled one bucket toward the door. Along that whole shelf the flowers have begun turning to blown glass, petal by petal, the transformation running outward from the bucket like frost: stems still green at the base, heads already clear and ringing, throwing hard coloured caustics across the steel. One hard pink light through the open cooler door, cold blue shade behind. Wide low camera, macro-sharp on the glass edges, real weight, film grain, no text.

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

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "The cold room of a flower shop, steel shelves and buckets of cut stems. A figure in an acid-green vinyl coat has just pulled one bucket toward the door. Along that whole shelf the flowers have begun turning to blown glass, petal by petal, the transformation running outward from the bucket like frost: stems still green at the base, heads already clear and ringing, throwing hard coloured caustics across the steel. One hard pink light through the open cooler door, cold blue shade behind. Wide low camera, macro-sharp on the glass edges, real weight, film grain, 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.1-flash-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	Нет	512 / 1K / 2K / 4K

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

Flash Image поддерживает 512, 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.1-flash-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.1-flash-image и сохраняет пригодные для использования части изображения.

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

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

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

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

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

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

Заметка

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