gemini-3.1-flash-lite-image API

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

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

Параметры: ratio=16:9

Промпт: A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text.

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

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9"
    }
  }
}

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

Используйте ключ 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-lite-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 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
generationConfig.imageConfig.imageSize	Нет	1K

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

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

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

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

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-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-lite-image и сохраняет пригодные для использования части изображения.

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

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

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

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

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

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

Заметка

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