Modelos
El modelo se elige con model_id. La lista de modelos activos y sus capacidades se obtiene con GET /v1/models: consúltala en lugar de fijar la lista en tu código, porque cambia con frecuencia.
Modelo por defecto: gemini-2.5-flash-image.
Familias de modelos
Sección titulada «Familias de modelos»| Familia | Ejemplos de model_id |
|---|---|
| Gemini (Nano Banana) | gemini-2.5-flash-image, gemini-3-pro-image-preview, gemini-3.1-flash-image-preview |
| OpenAI GPT Image | gpt-image-1, gpt-image-1-mini, gpt-image-1.5, gpt-image-2 |
| Google Imagen 4 | imagen-4-standard, imagen-4-fast, imagen-4-ultra |
| Flux | black-forest-labs/flux-2-pro-preview, black-forest-labs/flux-2-max, black-forest-labs/flux-2-flex, @cf/black-forest-labs/flux-1-schnell |
| Recraft | recraft/recraftv4, recraft/recraftv4-pro |
| Grok | grok-imagine-1, grok-imagine-2 |
La disponibilidad real de cada modelo la indica is_active en GET /v1/models.
Resolución
Sección titulada «Resolución»resolution acepta 1K, 2K o 4K (sin distinguir mayúsculas). Si el modelo no admite la resolución pedida, se usa la máxima que soporte (max_resolution):
| Resolución máxima | Modelos |
|---|---|
| 4K | Gemini 3 (no lite), gpt-image-2, gpt-image-1-mini, Flux 2 |
| 2K | Grok |
| 1K | El resto |
Relación de aspecto
Sección titulada «Relación de aspecto»aspectRatio acepta 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9 y 21:9-vertical. Cada modelo admite un subconjunto (supported_aspect_ratios en GET /v1/models); si pides uno no soportado, se usa el más cercano.
También se aceptan tamaños de papel (a4-vertical, a3-horizontal…) que se generan y recortan a proporción A a 300 ppp.
Tamaño exacto
Sección titulada «Tamaño exacto»Los modelos con custom_size (por ejemplo gpt-image-2) aceptan target_width y target_height en píxeles:
- Cada lado se redondea al múltiplo de 16 superior.
- Lado máximo 3840 px, proporción máxima 3:1, entre 0,655 y 8,29 megapíxeles.
- Fuera de rango:
422 INVALID_SIZE.
Imágenes de referencia
Sección titulada «Imágenes de referencia»Los modelos con supports_reference_images aceptan imágenes de referencia (reference_images). Límites por modelo: max_reference_images (por defecto 4) y max_reference_mb (por defecto 10 MB).