Nano Banana 2
nano-banana-2
El modelo de imagen rápido de Google para la generación de imágenes a escala, compatible con resoluciones desde 512 px hasta 4K nativo y múltiples relaciones de aspecto; genera combinando información en tiempo real de la búsqueda, ideal para la creación de alta frecuencia
Probar nano-banana-2
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
nano-banana-2 per image
| Especificaciones | Precio unitario |
|---|---|
| 1K | $0.036 |
| 2K | $0.057 |
| 4K | $0.086 |
Descripción general
nano-banana-2 es un modelo de generación de imágenes lanzado por Google que admite tanto la generación de imágenes a partir de texto como la edición con imágenes de referencia. Permite a los desarrolladores usar un prompt de hasta 20000 caracteres junto con un máximo de 14 imágenes de referencia para generar en una sola vez una imagen con el formato y la resolución seleccionados. Es adecuado para equipos que necesitan producir material de marketing en lote, iterar rápidamente borradores creativos o mantener la coherencia de estilo mediante imágenes de referencia, y puede invocarse a través de la interfaz unificada de HiAPI.ai.
Puntos clave
- Hasta 14 imágenes de referencia por solicitud: el flujo de imagen a imagen permite enviar hasta 14 imágenes de referencia a la vez, usando múltiples imágenes para condicionar personajes, estilos o composiciones, lo que reduce el coste de empalmar generaciones por lotes.
- Salida directa en tres niveles de resolución: se puede elegir la resolución de salida entre 1K, 2K y 4K; las imágenes de alta resolución no requieren un paso adicional de superresolución.
- 15 orientaciones de formato: desde 1:1 cuadrado hasta 8:1 ultrapanorámico y 9:16 vertical, todas se pueden especificar directamente en los parámetros, o dejarlo en auto para que se adapte automáticamente.
Descripción de capacidades
Generación a partir de texto y edición con imágenes de referencia: el prompt es la entrada principal y, opcionalmente, se pueden adjuntar imágenes de referencia para transformar o reutilizar el estilo; una misma interfaz cubre tanto la generación desde cero como la reescritura basada en material existente.
Control parametrizado de las especificaciones de salida: la resolución, la relación de aspecto y el formato de salida se declaran explícitamente en los parámetros de la solicitud, y se devuelve jpg o png, lo que facilita la integración directa en el flujo de material posterior.
Capacidad para prompts largos: el campo prompt tiene un límite de 20000 caracteres, suficiente para descripciones de imagen, restricciones de estilo e indicaciones de composición bastante completas, sin necesidad de recortes significativos por longitud.
Integración mediante interfaz unificada: los resultados de imagen se obtienen a través del método de invocación unificado de HiAPI.ai, por lo que los desarrolladores no necesitan mantener lógicas de integración independientes con proveedores para una sola capacidad de imagen.
Casos de uso
- Producción masiva de imágenes para equipos de marketing: generar en lote imágenes promocionales con prompts de texto para los tamaños de cada plataforma, produciendo en 1:1, 16:9 y 9:16, listas para redes sociales y materiales publicitarios.
- Exploración de coherencia de estilo con múltiples imágenes por parte de diseñadores: subir varias imágenes de referencia para condicionar personajes o estilos visuales y obtener series de imágenes con estilo uniforme, útiles para comparativas de borradores conceptuales e iteración de propuestas.
- Generación en 4K para material impreso y expositivo: generar imágenes con resolución 4K y formato especificado para pósters, paneles expositivos y otros materiales con requisitos claros de nitidez y relación de aspecto.
Limitaciones y recomendaciones de selección
Los límites de capacidad se rigen por los parámetros actuales: solo se genera una imagen por solicitud, no se ofrecen controles de cantidad por lote, duración de generación ni tipo vídeo, ni parámetros reproducibles como la semilla; el prompt es obligatorio y sin él no se puede generar. Las imágenes de referencia se envían mediante URL y su número máximo es 14. Si la tarea requiere edición estricta a nivel de píxel, control aleatorio reproducible o generación por lotes de varias imágenes, se recomienda validar primero el resultado con una pequeña muestra antes de decidir incorporarlo al flujo de producción.
Preguntas frecuentes
Ver todas las preguntas →-
¿Para qué tareas está pensado principalmente Nano Banana 2?
Admite imágenes de referencia opcionales, una amplia variedad de relaciones de aspecto y una resolución más alta; puede utilizarse para la generación y el retoque de imágenes.
-
¿Nano Banana 2 admite imágenes de referencia?
Admite hasta 14 imágenes de referencia opcionales; si no se sube ninguna, se puede usar como generación de imágenes puramente a partir de texto.
-
¿Qué especificaciones de salida son compatibles?
La página actual muestra 1K, 2K, 4K y 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto; las opciones finales están sujetas a los parámetros de Playground.
-
¿Cómo se factura Nano Banana 2?
Se factura según la cantidad de imágenes generadas con éxito; si hay diferencias entre distintas resoluciones o niveles de calidad, se mostrarán en el precio en tiempo real de la página.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: nano-banana-2
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para nano-banana-2 y la ruta default; consulta la tabla de parámetros a continuación.
promptstringObligatoriomaxLength 20000Texto de indicación que describe la imagen que se va a generar, y que proporciona la base de contenido para la generación de la imagen.
resolutionstringOpcionalPredeterminado: "1K"Controla la resolución de la imagen generada, en forma de cadena, por defecto 1K.
1K2K4Kimage_inputarrayOpcionalmaxItems 14Arreglo opcional de URL de imágenes de entrada, usado para transformar imágenes o como imágenes de referencia, admite hasta 14 imágenes.
Array [ string ]
aspect_ratiostringOpcionalPredeterminado: "auto"Controla la relación de aspecto de la imagen generada, en forma de cadena, por defecto auto.
1:11:41:82:33:23:44:14:3Mostrar todo (7)
4:55:48:19:1616:921:9autooutput_formatstringOpcionalPredeterminado: "png"Controla el formato de la imagen de salida, en forma de cadena, por defecto png.
jpgpngcallbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"input": {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "nano-banana-2",
input: {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "nano-banana-2",
"input": {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Ideogram V4 Ideogram $0.050 /imagen -
Nano Banana Pro Google $0.057 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
851 Labs Background Remover 851 Labs $0.002 /imagen -
FIBO 1.5 Bria $0.058 /imagen -
Qwen Image 2.0 Alibaba $0.042 /imagen -
Qwen Image 3.0 Alibaba $0.036 /imagen -
Grok Imagine Quality xAI $0.070 /imagen -
Seedream 5.0 ByteDance $0.025 /imagen -
Recraft V4.1 Recraft $0.010 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen
Mismo proveedor
-
Veo 3.1 Lite Google $0.060 /segundo -
Lyria 3 Pro Google $0.140 /canción -
Nano Banana Google $0.021 /imagen -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Google Virtual Try-On Google $0.107 /imagen -
Veo 3.1 Fast Google $0.170 /segundo -
Lyria 3.5 Google $0.090 /canción -
Nano Banana 2 Lite Google $0.033 /imagen -
Imagen 4 Google $0.030 /imagen -
Nano Banana Pro Google $0.057 /imagen -
Gemini Omni Google -- -
Veo 3.1 Google $0.290 /segundo














