Saltar al contenido

API de Mage · Modelo de imagen

API de Nano Banana 2

Texto nítido y legible, hasta 4K

POST https://api.mage.space/v1/nano_banana_v2/generate

De un vistazo

La API de Nano Banana 2 ejecuta Nano Banana 2.1 y otra variante a través de Mage en POST https://api.mage.space/v1/nano_banana_v2/generate. Una solicitud con los ajustes por defecto cuesta 51 Gems (unos 0,051 $), sin suscripción. Nano Banana 2 admite personajes guardados y referencias mediante @handle en el prompt.

  • ImagenResultado
  • 2Variantes
  • 51Gems por imagen, por defecto
  • $0.051Aprox., en USD

Resumen

Qué hace la API de Nano Banana 2

Los modelos de imagen de Google para gráficos y contenido de marketing con texto legible. Nano Banana 2.1 es el principal de la familia; ambos generan o editan a partir de hasta 14 imágenes de referencia, hasta en 4K. Se aplica el filtro de seguridad de Google.

Los modelos Nano Banana de Google, para gráficos con texto legible y ediciones a partir de hasta 14 imágenes de referencia, hasta en 4K. Nano Banana 2.1 (`nano-banana-v2.1`), el predeterminado, cuesta menos; Nano Banana 2 (`nano-banana-v2`) también renderiza a 512. Se aplica el filtro de seguridad de Google.

Acepta image y additional_images como entradas.

Inicio rápido

Llama a la API de Nano Banana 2

Define MAGE_API_KEY, envía la solicitud a /nano_banana_v2/generate y consulta status_url hasta que se complete.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/nano_banana_v2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "nano-banana-v2.1"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('nano_banana_v2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'nano-banana-v2.1',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("nano_banana_v2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "nano-banana-v2.1",
})

print(request["result"]["url"])

Modelos

Valores de model_id de Nano Banana 2

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
nano-banana-v2Nano Banana 2
nano-banana-v2.1Nano Banana 2.1Sí

Opciones

Parámetros de Nano Banana 2

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

CampoValores
aspect_ratio1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
resolution512, 1K, 2K, 4K

Entradas

Entradas multimedia que acepta Nano Banana 2

Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.

CampoRol
imageLa imagen de referencia.
additional_imagesImágenes de referencia adicionales.

Más modelos de imagen

Otras API de generación de imágenes en Mage

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Nano Banana 2?
Una solicitud de Nano Banana 2 con los ajustes por defecto (Nano Banana 2.1) cuesta 51 Gems, unos 0,051 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se te reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de Nano Banana 2?
POST https://api.mage.space/v1/nano_banana_v2/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye una status_url que puedes consultar para obtener el resultado.
¿Qué modelos de Nano Banana 2 puedo usar?
nano-banana-v2 (Nano Banana 2), nano-banana-v2.1 (Nano Banana 2.1). El predeterminado es Nano Banana 2.1.
¿Nano Banana 2 admite imágenes de referencia o personajes?
Nano Banana 2 acepta image y additional_images. También admite personajes y referencias guardados, que puedes mencionar con @handle en el prompt.
¿Puedo usar Nano Banana 2 desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Nano Banana 2 por su nombre. Tu asistente lee sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Nano Banana 2?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

CharactersComunidad