Contenido actualizado: 2026-06-06

Generación de imágenes Gemini

POST /v1/images/generations

Crazyrouter proporciona una interfaz unificada compatible con OpenAI Images para el modelo de imágenes Gemini. No es necesario que el usuario invoque directamente el generateContent nativo de Gemini, ni tampoco pasar generationConfig.imageConfig nativo de Gemini.

Nombre de modelo público recomendado	Nombre de modelo subyacente compatible
`nano-banana`	`nano-banana`
`nano-banana-pro`	`nano-banana-pro`
`nano-banana-2`	`nano-banana-2`

La generación de imágenes Gemini corresponde a una solicitud de larga duración. Para producción, se recomienda usar prioritariamente la ruta principal https://api.crazyrouter.com/v1; el endpoint completo de generación es https://api.crazyrouter.com/v1/images/generations.

Se recomienda utilizar nano-banana, nano-banana-pro, nano-banana-2 en el código del cliente. Si tu sistema ya utiliza directamente nano-banana, nano-banana-pro, nano-banana-2, también puedes seguir llamando a través de la misma entrada de la API de Images.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`model`	string	Sí	`nano-banana`, `nano-banana-pro`, `nano-banana-2`, o el nombre canónico de Gemini correspondiente
`prompt`	string	Sí	Instrucción de generación o edición
`image_input`	string o string[]	No	URL de imagen de referencia; si no se proporciona, será generación desde texto
`resolution`	string	No	`1K`, `2K`, `4K`
`aspect_ratio`	string	No	Como `1:1`, `16:9`, `9:16`, `21:9`, `auto`
`output_format`	string	No	`png`, `jpeg` / `jpg`
`output_compression`	integer	No	`0-100`, utilizado para la calidad de compresión JPEG
`n`	integer	No	Cantidad generada, por defecto `1`

No envíes estos campos privados de origen: generationConfig, imageConfig, imageOutputOptions, image_output_options.

Ejemplo de solicitud

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A simple red square on a white background, clean vector style",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }'

La respuesta mantiene el estilo de OpenAI Images:

{
  "created": 1778990000,
  "data": [
    {
      "url": "https://media.crazyrouter.com/task-artifacts/2026/05/17/sync-image/request-id-1.png"
    }
  ]
}

Edición de imagen de referencia

curl -X POST https://api.crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "把参考图改成高级电商海报，保留主体，背景更简洁",
    "image_input": [
      "https://example.com/reference.png"
    ],
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "output_compression": 85
  }'

Si realmente necesitas el formato de API nativo de Gemini, consulta el formato nativo de Gemini. Pero para la generación y edición de imágenes, se recomienda utilizar siempre la API de Images de esta página desde el lado del cliente.

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - API de respuestas