Nano Banana 2 · Generar

POST/v1/images/generations

Parámetros de solicitud

Authorization

Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.

Authorization: Bearer ****************

Parámetros de header

Content-TypestringOpcional

application/json

AcceptstringOpcional

application/json

Parámetros de bodyapplication/jsonobligatorio

modelstringObligatorio

ID del modelo, fijo en `gemini-3.1-flash-image`

promptstringObligatorio

Descripción de la imagen

nintegerOpcional

Número de imágenes, por defecto `1`

sizestringOpcional

Resolución, p. ej. `1024x1024`

qualitystringOpcional

Nivel de calidad (cuando el modelo lo admite)

response_formatstringOpcional

Formato de retorno. `url` solo aplica a modelos que lo admiten (p. ej. DALL-E); OpenAI gpt-image siempre devuelve `b64_json` e ignora este campo.

output_formatstringOpcional

Formato de codificación de la imagen (png / jpeg / webp); aplica a modelos OpenAI gpt-image.

output_compressionintegerOpcional

Nivel de compresión 0–100; solo afecta a jpeg / webp.

backgroundstringOpcional

Tipo de fondo (transparent / opaque / auto); transparent requiere png o webp.

moderationstringOpcional

Rigor de moderación (auto / low); el upstream sigue moderando.

userstringOpcional

Identificador opcional de usuario final reenviado al upstream para detección de abuso.

Ejemplo

{
  "model": "gemini-3.1-flash-image",
  "prompt": "Un golden retriever corriendo en la nieve",
  "n": 1,
  "size": "1024x1024",
  "response_format": "b64_json"
}

{  "model": "gemini-3.1-flash-image",  "prompt": "Un golden retriever corriendo en la nieve",  "n": 1,  "size": "1024x1024",  "response_format": "b64_json"}

Código de ejemplo

curl https://api.hotrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "Un golden retriever corriendo en la nieve",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

curl https://api.hotrouter.ai/v1/images/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-3.1-flash-image",    "prompt": "Un golden retriever corriendo en la nieve",    "n": 1,    "size": "1024x1024",    "response_format": "b64_json"  }'

Respuesta

200 · Éxito

createdintegerOpcional

Marca de tiempo de creación (segundos)

dataarray[object]Obligatorio

Imágenes generadas

Ejemplo

{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}

{  "created": 1730000000,  "data": [    {      "b64_json": "<base64>"    }  ]}

Nano Banana 2 · Generar

Parámetros de solicitud

Código de ejemplo

Respuesta

On this page