Respuesta rápida
- El punto de entrada es POST /v1/images/generations; envíe la tarea de imagen con el identificador de modelo de Nano Banana 2 indicado en la documentación.
- Admite texto a imagen por prompt y generación con imágenes de referencia en reference_images, ideal para publicidad, comercio electrónico, redes sociales y creatividades por lotes.
- El flujo es asíncrono: envíe la tarea, reciba un id de tarea y consulte el resultado en el endpoint de estado de la tarea de imagen.
- El precio oficial de referencia ronda los $0.067 / $0.101 / $0.151 por imagen en 1K / 2K / 4K; ToAPIs muestra actualmente $0.030 / $0.040 / $0.060 por imagen en la página comparativa, y la facturación final depende del precio de tu cuenta.
- Con la tarifa 1K de ToAPIs de $0.030 por imagen, una recarga de $10 equivale a unas 333 imágenes 1K adicionales; con la tarifa 4K de $0.060 por imagen, a unas 166 imágenes 4K.
Parámetros clave
- model | string | obligatorio | nano_banana_2 | - | Usa el identificador de modelo de Nano Banana 2 indicado en la documentación o en la tabla de precios de ToAPIs.
- prompt | string | obligatorio | - | - | Prompt principal de generación de imágenes.
- size | string | opcional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | Relación de aspecto de salida; los valores disponibles dependen de la documentación y de la capacidad del modelo.
- resolution | string | opcional | 1K | 1K | 2K | 4K | Nivel de resolución de salida; afecta el precio por imagen y el coste de generación.
- reference_images | string[] | opcional | - | Matriz de URL | Matriz de URL de imágenes de referencia para generación guiada y control de estilo o sujeto.
- response_format | string | opcional | url | url | b64_json | Formato del resultado; se recomienda usar URL en la mayoría de flujos.
Errores comunes
- 400 invalid_request_error: disparador=Falta model/prompt, o los campos de resolución, proporción o imágenes de referencia no cumplen la documentación.; solución=Valide model, prompt, size, resolution y reference_images según la documentación de ToAPIs.; reintento=Reintente solo después de corregir los parámetros; no conviene reintentar a ciegas.
- 401 authentication_error: disparador=Falta el encabezado Authorization o la clave de API no es válida.; solución=Comprueba el formato del token Bearer y los permisos de la clave.; reintento=Reintente después de corregir la autenticación.
- 429 rate_limit_exceeded: disparador=La frecuencia de solicitudes, la concurrencia o los créditos actuales alcanzan el límite.; solución=Aplica retroceso exponencial, reduzca la concurrencia y revise los créditos de la cuenta.; reintento=Se recomienda retroceso de 1s/2s/4s con aleatoriedad; si se repite, encole las solicitudes.










