Respuesta rápida
- Admite texto a imagen por prompt con varias relaciones de aspecto.
- Admite imágenes de referencia en reference_images para reforzar la coherencia de estilo.
- Las variantes oficiales ofrecen más controles de generación para ajustar en producción.
Parámetros clave
- model | string | obligatorio | gemini-3.1-flash-lite-image-official | - | Identificador exacto del modelo de imagen proporcionado por ToAPIs.
- prompt | string | obligatorio | - | - | Texto descriptivo de la imagen.
- size | string | opcional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Relación de aspecto de salida.
- resolution | string | opcional | 1K | 1K | 2K | 4K (según la capacidad del modelo) | Resolución de salida; los valores varían según la versión del modelo.
- reference_images | file[] | opcional | - | max 14 | Matriz de imágenes de referencia para controlar estilo y composición.
- temperature | number | opcional | 0.8 | 0-2 | Temperatura de muestreo que controla la diversidad de la generación.
- topP | number | opcional | 0.95 | 0-1 | Umbral de muestreo de núcleo que controla el rango de truncamiento de probabilidad.
Errores comunes
- 400 invalid_request_error: disparador=Faltan campos en el cuerpo de la solicitud o su tipo no es válido.; solución=Valide los campos y valores model/prompt/size/resolution.; reintento=Reintente solo después de corregir los parámetros.
- 401 authentication_error: disparador=Falta la clave de API o no es válida.; solución=Comprueba el encabezado Authorization y los permisos de la clave.; reintento=Reintenta después de corregir la autenticación.
- 429 rate_limit_exceeded: disparador=La frecuencia de solicitudes, la concurrencia o la cuota actual activan el límite del proveedor.; solución=Aplica primero un retroceso exponencial y luego revise el ritmo de solicitudes, la concurrencia y el uso de la cuota.; reintento=Se recomienda 1s/2s/4s + aleatoriedad; si se repite, reduzca el ritmo de envío.







