Guía completa de la documentación de desarrollo de Nano Banana 2: Comparativa de 2 soluciones entre la API oficial y la integración de APIYI

Nota del autor: Guía detallada de la documentación de desarrollo de Nano Banana 2 (gemini-3.1-flash-image-preview), comparando la API oficial de Google y la plataforma APIYI. Incluye ejemplos de código, configuración de parámetros y estrategias de ahorro.

Si eres un desarrollador que busca integrar Nano Banana 2, actualmente tienes dos documentos de referencia principales: la documentación oficial de Google (ai.google.dev/gemini-api/docs/image-generation) y la documentación de la plataforma APIYI (docs.apiyi.com/api-capabilities/nano-banana-2-image).

Ambas opciones tienen sus ventajas: la documentación oficial es la más completa en cuanto a funciones, mientras que la de APIYI ofrece la integración más sencilla y un precio reducido de hasta $0.03 por petición. En este artículo, comparamos el contenido principal de ambas para ayudarte a elegir la mejor forma de implementarlo.

Valor principal: Al terminar de leer, dominarás todos los parámetros de la API de Nano Banana 2, tendrás ejemplos de código para ambas soluciones y sabrás cuál elegir según tu caso de uso.

Referencia rápida de parámetros clave de Nano Banana 2

Primero, echemos un vistazo a la configuración de parámetros más importante. Estos parámetros son universales, independientemente de la solución que elijas:

Los 14 formatos de aspecto compatibles con Nano Banana 2

🎯 Consejo de desarrollo: Los formatos 1:4, 4:1, 1:8 y 8:1 son exclusivos de Nano Banana 2; Nano Banana Pro no los admite. Si tu aplicación requiere banners alargados o infografías, debes usar gemini-3.1-flash-image-preview.

Opción de integración A para Nano Banana 2: API oficial de Google

Invocación básica de la API oficial

La API oficial de Google utiliza el SDK de Google Gen AI, compatible con Python, JavaScript, Go, Java y REST.

from google import genai
from google.genai import types

client = genai.Client()

# Generación básica de texto a imagen
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Un gato naranja revolcándose entre hojas secas de otoño, tonos cálidos",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# Extraer la imagen generada
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# Configuración completa de parámetros: resolución 2K + relación 16:9 + modo de pensamiento High
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Portada del informe anual de una empresa tecnológica, título 'AI Vision 2026', tonos azul oscuro, estilo minimalista",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# Analizar la respuesta (incluyendo el proceso de pensamiento/Thinking)
for part in response.parts:
    if part.thought and part.text:
        print(f"[Proceso de pensamiento] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("Imagen guardada")

Generación conectada a la red con Image Search de la API oficial

Esta es una capacidad exclusiva de Nano Banana 2: realizar una búsqueda de imágenes en Google para obtener referencias visuales reales antes de generar:

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="El último modelo de Tesla Model Y de 2026, color plateado, estacionado en una calle de la ciudad",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        tools=[
            types.Tool(google_search=types.GoogleSearch(
                search_types=types.SearchTypes(
                    web_search=types.WebSearch(),
                    image_search=types.ImageSearch()
                )
            ))
        ]
    )
)

🎯 Nota: La generación conectada con Image Search tiene requisitos de visualización: se debe proporcionar un enlace clicable a la página web de la imagen de origen. Los tokens de pensamiento (Thinking tokens) se facturarán independientemente de si se devuelve el proceso de razonamiento o no.

Opción de integración B para Nano Banana 2: Plataforma APIYI

Ventajas de integración con la plataforma APIYI

Invocación en formato compatible con OpenAI de APIYI

Si ya tienes código basado en el SDK de OpenAI, solo necesitas cambiar dos líneas para integrar Nano Banana 2:

import openai

client = openai.OpenAI(
    api_key="TU_CLAVE_APIYI",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "Pintura de paisaje con tinta china, composición con espacios en blanco, montañas lejanas rodeadas de niebla"}]
)

import requests
import base64

API_KEY = "TU_CLAVE_APIYI"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "contents": [{"parts": [{"text": "Póster promocional de comercio electrónico, título grande 'Oferta de Primavera', tema rojo"}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {
                "aspectRatio": "9:16",
                "imageSize": "2K"
            }
        }
    },
    timeout=300
).json()

# Decodificar y guardar la imagen
img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img_data))
print("Imagen generada con éxito, coste aprox. $0.03")

Sugerencia: Regístrate en APIYI apiyi.com para obtener tu clave API y comenzar las invocaciones. La plataforma admite tanto el formato compatible con OpenAI como el formato nativo de Google; una sola clave permite alternar entre todos los modelos.

Comparativa de precios de las dos opciones de Nano Banana 2

Comparativa de costos mensuales de Nano Banana 2 (1000 imágenes/día)

El precio de $0.03 por solicitud de APIYI no solo es un 55% más económico que el precio estándar oficial, sino que incluso es inferior al precio Batch oficial a mitad de precio ($0.034). Además, ofrece respuesta en tiempo real, sin necesidad de esperar 24 horas para el procesamiento asíncrono.

🎯 Plan de ahorro: Invoque Nano Banana 2 a través de APIYI (apiyi.com); generar 1000 imágenes al día cuesta solo $30, con un costo mensual de $900. Regístrese ahora para obtener crédito de prueba gratuito. Una sola clave API admite Nano Banana 2, Pro y otros modelos principales simultáneamente.

Guía de desarrollo de funciones avanzadas de Nano Banana 2

Edición de imágenes en conversaciones de varios turnos

Nano Banana 2 permite modificar continuamente la misma imagen dentro de una conversación:

# Edición de varios turnos en formato APIYI + OpenAI
messages = [
    {"role": "user", "content": "Genera un logo de marca de estilo minimalista, en tonos azules"},
    # Continuar editando después de la respuesta del primer turno
    {"role": "assistant", "content": "[Resultado de la primera generación]"},
    {"role": "user", "content": "Cambia el color a un degradado púrpura y añade el nombre de la empresa 'TechFlow'"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

Generación con imágenes de referencia en Nano Banana 2

Selección del modo Thinking en Nano Banana 2

🎯 Consejo de desarrollo: Los tokens de Thinking generan costos independientemente de si se establece includeThoughts=true. Si no necesita revisar el proceso de razonamiento, manténgalo en false por defecto; esto no afectará la calidad de la generación, simplemente no devolverá el texto de razonamiento intermedio.

Referencia de velocidad de generación de Nano Banana 2

Sugerencia: Al realizar una invocación del modelo Nano Banana 2, se recomienda configurar timeout=300 (300 segundos) para evitar fallos por tiempo de espera debido a fluctuaciones en la red o en la capacidad de cómputo de Google. Obtén una conexión más estable realizando la llamada a través de APIYI (apiyi.com).

Preguntas frecuentes

Resumen

Puntos clave de la documentación de desarrollo de Nano Banana 2:

1. Dos soluciones con ventajas propias: La API oficial de Google ofrece todas las funciones (Image Search, Thinking, 14 imágenes de referencia), mientras que APIYI ofrece el precio más bajo ($0.03/invocación) y la integración más sencilla.
2. APIYI $0.03 = 45% del precio oficial: Respuesta en tiempo real, incluso más barato que el precio a mitad de coste de la API oficial en modo Batch ($0.034), y sin tener que esperar 24 horas.
3. Parámetros principales universales: Las 4 opciones de resolución, 14 relaciones de aspecto y el modo Thinking se pueden utilizar en ambas soluciones.

Para la mayoría de los desarrolladores, recomendamos acceder rápidamente a Nano Banana 2 a través de APIYI (apiyi.com): precio de $0.03/invocación, formato compatible con OpenAI, créditos gratuitos al registrarse y podrás generar tu primera imagen en menos de 5 minutos.

📚 Referencias

1. Documentación oficial de generación de imágenes de Google Gemini: Referencia completa de la API de Nano Banana 2.

   • Enlace: ai.google.dev/gemini-api/docs/image-generation
   • Descripción: Documentación oficial de todos los parámetros, funciones y características avanzadas.

2. Documentación de Nano Banana 2 en APIYI: Guía de acceso rápido y ejemplos de código.

   • Enlace: docs.apiyi.com/api-capabilities/nano-banana-2-image
   • Descripción: Guía de integración en la plataforma APIYI, incluyendo precios y ejemplos de invocación del modelo.

3. Precios oficiales de la API de Gemini: Precios exactos por resolución.

   • Enlace: ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • Descripción: Precios estándar y precios Batch para 0.5K/1K/2K/4K.

4. Límites de velocidad de la API de Gemini: Restricciones de invocación para modelos Preview.

   • Enlace: ai.google.dev/gemini-api/docs/rate-limits
   • Descripción: Información sobre las cuotas y límites de los modelos Preview.

Autor: Equipo técnico de APIYI
Intercambio técnico: Te invitamos a compartir tu experiencia de desarrollo con Nano Banana 2 en la sección de comentarios. Para más información sobre modelos de IA, visita el centro de documentación de APIYI en docs.apiyi.com.