Gemini 3.1 Flash Image Preview

• Modelo: gemini-3.1-flash-image-preview (fijo)
• Características: texto a imagen, imagen a imagen (hasta 14 referencias), hasta 4K, relaciones de aspecto extremas, búsqueda opcional de Google con grounding.

No llames a este modelo a través de /v1/chat/completions — obtendrás un 400 con una sugerencia de usar la API de Imágenes.

Endpoints

Modo	Endpoint	Cuándo usarlo
Síncrono (recomendado)	POST https://apimaster.ai/v1/images/generations	Un único viaje de ida y vuelta HTTP; la plataforma hace polling río arriba y devuelve { "data": [{ "url" }] }
Asíncrono	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Trabajos largos, colas personalizadas

Inicio rápido (síncrono)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Ciudad cyberpunk de noche, luces de neón",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Respuesta correcta

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

Establece el tiempo de espera de lectura HTTP a ≥ 180s para 2K/4K. Descarga o refleja las URLs rápidamente — caducan.

Flujo asíncrono

Enviar

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "un astronauta corgi en la luna",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Respuesta de envío

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}

Consultar

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

En caso de éxito, lee data.result.images[0].url. Estados típicos de polling: in_progress → succeeded / completed.

Espera 10–20s antes de la primera consulta, luego cada 3–5s.

Autenticación

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parámetros del cuerpo

Campo	Tipo	Obligatorio	Notas
model	string	sí	gemini-3.1-flash-image-preview
prompt	string	sí	Descripción de la escena
size	string	no	Relación de aspecto; ver más abajo
resolution	string	no	0.5K / 1K / 2K / 4K, por defecto 1K; no distingue mayúsculas
n	integer	no	Solo se admite 1 (numérico, no cadena)
image_urls	array	no	Imágenes de referencia (URL o data URI)
google_search	boolean	no	Búsqueda de texto de Google con grounding
google_image_search	boolean	no	Requiere google_search: true

Niveles de resolución y facturación

Valor	~píxeles	Precio respecto a base 1K
0.5K	~512	igual que 1K
1K	~1024	base
2K	~2048	× 4/3
4K	~4096	× 2

El cargo real = precio del canal × multiplicador de resolución × ratio del grupo. Consulta el marketplace o los registros de la consola.

Errores

HTTP	Significado
400	Parámetros incorrectos, o endpoint equivocado (chat)
401	Clave API no válida
402	Saldo insuficiente
408	Tiempo de espera de polling síncrono — reintenta de forma asíncrona o reduce la resolución
500 / 502	Error del río arriba o de la plataforma

Las relaciones de aspecto no válidas pueden aparecer como 500 cuando solo hay un canal configurado.

Notas

• Los registros de uso incluyen result_url para la vista previa de la imagen y request_data.effective_resolution.
• Los precios varían según el canal y la resolución — consulta el marketplace.