gemini-3-pro-image API

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

Salida de muestragemini-3-pro-imagePOST /v1beta/models/gemini-3-pro-image:generateContent

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

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

Solicitud que produjo esta muestra

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

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

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

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

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-3-pro-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 basada en tokens. 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.