gemini-2.5-flash-image API

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

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

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

Промпт: The paint aisle of a hardware store, fluorescent tubes and rows of colour chip cards. A woman in a chrome puffer coat has just run one hand along the rack. Every card she touched has lifted off its peg and the whole aisle is filling with them, thousands of paper chips turning in the air and sorting themselves into a single smooth gradient wall from deep violet to hot orange. Cold fluorescent ambient, one hard warm slash of light from the end of the aisle. Wide low camera down the aisle, paper edges catching the light, film grain, no text.

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

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "The paint aisle of a hardware store, fluorescent tubes and rows of colour chip cards. A woman in a chrome puffer coat has just run one hand along the rack. Every card she touched has lifted off its peg and the whole aisle is filling with them, thousands of paper chips turning in the air and sorting themselves into a single smooth gradient wall from deep violet to hot orange. Cold fluorescent ambient, one hard warm slash of light from the end of the aisle. Wide low camera down the aisle, paper edges catching the light, 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-2.5-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	Нет	1K / 2K / 4K

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

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

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

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

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

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

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

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

Заметка

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