---
title: "Usa Nano Banana en OpenClaw con RunAPI — Guía de API de imagen"
url: "https://runapi.ai/pt-BR/openclaw-nano-banana.md"
canonical: "https://runapi.ai/pt-BR/openclaw-nano-banana"
locale: "pt-BR"
model: "nano-banana"
---

# Usa Nano Banana en OpenClaw.

Nano Banana es el modelo de generación de imágenes nativo de Gemini de Google con renderizado de texto líder en la industria en imágenes generadas. Pro produce salida de hasta 4K de resolución, Nano Banana 2 optimiza la velocidad con relaciones de aspecto extendidas, y Edit modifica imágenes existentes. Los agentes OpenClaw llaman a las tres variantes a través de una sola clave RunAPI y endpoint.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A minimalist product card for a coffee brand, the text DARK ROAST in bold sans-serif across the top, a steaming cup below, warm studio lighting",
    "aspect_ratio": "4:3",
    "output_resolution": "4k",
    "output_format": "png"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "nano-banana-pro"
}

```

## How it works

1. **Configura RunAPI** — Establece la variable de entorno RUNAPI_API_KEY. Si ya configuraste RunAPI como proveedor de OpenClaw para chat, la misma clave funciona para la generación de imágenes con Nano Banana.
2. **Llama a Nano Banana** — Envía un POST al endpoint text_to_image con model establecido en nano-banana-pro para la máxima calidad, nano-banana-2 para velocidad o nano-banana para la variante base. Establece output_resolution en 4k en Pro o 2 para máximo detalle. Para edición, envía un POST a edit_image con nano-banana-edit e incluye una image_url.
3. **Obtén el resultado** — La respuesta incluye un task_id. Consulta el endpoint de estado de la tarea hasta que el estado cambie a completed. La respuesta completada contiene la URL de la imagen generada. Los SDK y la CLI de RunAPI gestionan el polling automáticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obligatorio. nano-banana-pro (máxima calidad, 4K), nano-banana-2 (rápido, ratios extendidos), nano-banana (base) o nano-banana-edit (edición). |
| `prompt` | `string` | Descripción textual de la imagen deseada. Incluye cualquier texto que desees renderizar en la imagen — Nano Banana gestiona la tipografía de forma nativa. |
| `image_url` | `string` | URL de la imagen fuente. Obligatorio para nano-banana-edit, ignorado para las variantes text_to_image. |
| `aspect_ratio` | `string` | Opcional. Relación de aspecto de la salida. Pro acepta: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto. Nano Banana 2 añade 1:4, 1:8, 4:1, 8:1. |
| `output_resolution` | `string` | Opcional. Solo Pro y 2. Valores aceptados: 1k, 2k, 4k. Por defecto 1k. |
| `output_format` | `string` | Opcional. Formato del archivo de salida. Valores aceptados: png, jpeg, jpg. |
| `callback_url` | `string` | Opcional. URL de webhook que recibe un POST cuando la tarea se completa. |

## FAQ

### ¿Cuál es la diferencia entre Nano Banana Pro, 2 y la variante base?

Nano Banana Pro ofrece la mayor calidad de imagen con resolución de salida de hasta 4K. Nano Banana 2 está optimizado para velocidad y admite relaciones de aspecto adicionales como 1:4 y 8:1 para formatos de banner y verticales. La variante base nano-banana es la opción más económica a resolución estándar. Las tres comparten el mismo endpoint text_to_image.

### ¿Nano Banana puede renderizar texto legible dentro de las imágenes generadas?

Sí. Nano Banana está diseñado específicamente para el renderizado preciso de texto en imágenes. Incluye las palabras exactas que deseas en el prompt — el modelo gestiona la colocación de fuentes y la legibilidad de forma nativa, a diferencia de la mayoría de los modelos de difusión que distorsionan las formas de las letras.

### ¿Cómo funciona el precio de la salida 4K de Nano Banana?

El precio de Nano Banana Pro varía según output_resolution: 1k y 2k tienen la misma tarifa, mientras que 4k cuesta más por imagen. Nano Banana 2 sigue una estructura de niveles similar. Consulta la página de precios de RunAPI para las tarifas exactas por imagen. No hay gasto mínimo mensual.

### ¿Puedo editar imágenes existentes con Nano Banana en OpenClaw?

Sí. Usa el modelo nano-banana-edit con el endpoint edit_image. Pasa la imagen fuente mediante image_url y describe los cambios deseados en el prompt. La variante de edición admite modificaciones con reconocimiento de texto, para que puedas añadir o cambiar superposiciones de texto en imágenes existentes.

### ¿Nano Banana es asíncrono o síncrono?

Asíncrono. El endpoint de creación devuelve un task_id inmediatamente. Consulta el endpoint de estado de la tarea o proporciona un callback_url para recibir un webhook cuando la imagen esté lista. Los SDK y la CLI de RunAPI gestionan el polling automáticamente.


## Links

- [Guía de configuración de OpenClaw →](https://runapi.ai/pt-BR/openclaw)
- [Modelos de Nano Banana →](https://runapi.ai/pt-BR/models/nano-banana)
- [Model catalog](https://runapi.ai/pt-BR/models)
- [API docs](https://runapi.ai/pt-BR/docs)