gemini-2.5-flash-image API

Utilice el ID de modelo exacto gemini-2.5-flash-image. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestragemini-2.5-flash-imagePOST /v1beta/models/gemini-2.5-flash-image:generateContent

Parámetros: size=2Kratio=16:9

Prompt: 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.

Solicitud que produjo esta muestra

{
  "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"
    }
  }
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev. El punto de entrada de la puerta de enlace es POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Generar una imagen

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"}}
  }'

Solicitar notas

Los modelos de imagen Gemini utilizan contents y generationConfig nativos; las ediciones envían la instrucción de texto y inline_data en el mismo parts[].

Solicitar parámetros

Los modelos de imagen Gemini utilizan Gemini nativo generateContent. Poner texto e imágenes de referencia en el mismo contents[].parts[]; las imágenes utilizan inline_data. No envíe estos modelos a /v1/images/generations, /v1/images/edits u OpenAI /v1/responses. La enumeración imageSize es específica del modelo y se muestra a continuación.

Campo	Requerido	Notas
contents[].parts[].text	Sí	Mensaje de texto o instrucción de edición
contents[].parts[].inline_data	No	Datos de imagen Base64 y tipo MIME
contents[].parts[].inline_data.mime_type	No	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	No	Contenido de imagen de referencia codificada en Base64
generationConfig.responseModalities	Sí	["IMAGE"] o ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	No	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	No	1K / 2K / 4K

Límites de respuesta y entrada

Gemini 2.5 Flash Image admite 1K, 2K y 4K con 1:1, 4:3, 3:4, 16:9 y 9:16. La documentación oficial no publica un límite de recuento de imágenes de referencia, por lo que la puerta de enlace no agrega ningún límite local.

Ejemplo de edición de imágenes

Coloque la instrucción de edición y la imagen de referencia en el mismo contents[].parts[]. inline_data.data es el contenido de la imagen Base64; no envíe modelos de imágenes Gemini a las imágenes OpenAI o a los puntos finales 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"}}
  }'

Forma de respuesta

Leer candidates[].content.parts[]; No asuma que cada parte es una imagen porque la respuesta puede contener partes de texto e imagen juntas.

Campo	Notas
candidates[].content.parts[].inline_data	Imagen generada tipo MIME y datos Base64
candidates[].content.parts[].text	Título de texto devuelto cuando se solicitó TEXTO
candidates[].finishReason	Razón de finalización o seguridad
usageMetadata	Uso del token de entrada/salida cuando lo devuelve el servicio

Modelflare conserva la forma de respuesta nativa de Gemini para gemini-2.5-flash-image y conserva las partes de la imagen utilizables.

Errores y tareas fallidas

Los errores de campo, los límites de tamaño/proporción y los rechazos de seguridad de la solicitud nativa de Gemini siguen siendo respuestas de error compatibles con Gemini. La puerta de enlace no las reescribe como respuestas de OpenAI Images.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación por llamada. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.