Guía Técnica de la API Nano Banana 2

Documentación técnica detallada para el Servicio de Producción Visual Nano Banana 2 que utiliza capacidades avanzadas de inteligencia artificial

Ver PreciosExplora las opciones de suscripción de Nano Banana 2

Introducción a la API de Nano Banana 2

La API de Producción Visual Nano Banana 2 permite la integración con sistemas de inteligencia artificial sofisticados para crear visuales premium a partir de descripciones textuales y gráficos de muestra. Nuestra plataforma Nano Banana 2 ofrece una arquitectura REST sencilla con amplias capacidades de coordinación de trabajos y notificaciones.

Capacidades Principales de Nano Banana 2

• Transformación de texto a visual de Nano Banana 2 utilizando sistemas de inteligencia artificial de vanguardia
• Compatibilidad de Nano Banana 2 con gráficos de muestra (máximo 4 imágenes)
• Ejecución de trabajos no bloqueante de Nano Banana 2 con monitoreo de progreso
• Integración de webhook de Nano Banana 2 para actualizaciones instantáneas de estado
• Arquitectura REST de Nano Banana 2 que entrega respuestas en formato JSON
• Sistema de verificación de credenciales Bearer de Nano Banana 2

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Guía de Implementación de Nano Banana 2

1. Registrarse para obtener credenciales de API de Nano Banana 2 a través de nuestra plataforma principal
2. Incluir tu token de acceso de Nano Banana 2 en el parámetro de Authorization
3. Enviar una solicitud POST al terminal de creación visual de Nano Banana 2
4. Usar el identificador de trabajo proporcionado de Nano Banana 2 para verificación de estado
5. Obtener tus visuales fabricados de Nano Banana 2 al completarse la tarea

Verificación de Identidad

Cada envío de API requiere autenticación a través de verificación de token Bearer. Incorpora tus credenciales de acceso dentro del parámetro Authorization para cada transmisión.

Método de Verificación

Implementa validación de token HTTP Bearer incrustando tus credenciales de acceso en el parámetro Authorization:

Authorization: Bearer <your-api-key>

Estructura de Ejemplo de Clave de Acceso

Authorization: Bearer dk-1234567890abcdef

Demostración de Envío

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Verificación Exitosa

✅ Las credenciales de acceso permanecen actuales
✅ El registro del cliente mantiene estado activo
✅ Persisten créditos de servicio adecuados

Problemas Frecuentes

❌ Credenciales de acceso ausentes
❌ Configuración incorrecta de clave de acceso
❌ Registro desactivado o suspendido

API de Producción Visual Nano Banana 2

Crea imágenes utilizando Nano Banana 2 con sistemas de inteligencia artificial sofisticados e instrucciones textuales adaptables más imágenes de muestra.

Terminal de Conexión

POST /api/image/gen

Variables de Envío

Parameter	Type	Required	Description
model	string	Yes	Model identifier (e.g., "google/gempix2")
prompt	string	Yes	Text prompt describing the image
images	array	No	Reference image URLs (max 4)
callback_url	string	No	Webhook URL for completion notifications

Ilustraciones de Implementación

Creación Visual Fundamental de Nano Banana 2

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Producción Basada en Referencia de Nano Banana 2 con Gráficos de Muestra

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Estructura de Salida

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Gestión de Problemas

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

API de Estado de Trabajo de Nano Banana 2

Investiga el progreso y los resultados de los trabajos de producción visual de Nano Banana 2 utilizando el identificador de tarea proporcionado por el terminal de creación visual de Nano Banana 2.

Terminal de Conexión

GET /api/task/query?task_id=<task_id>

Variables de Investigación

Parameter	Type	Required	Description
task_id	string	Yes	Unique task identifier returned from generation endpoint

Ejemplo de Envío

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Categorías de Estado de Trabajo de Nano Banana 2

pending - Inicialización del trabajo de Nano Banana 2 completada esperando inicio del procesamiento

submitted - Trabajo de Nano Banana 2 ingresado en la secuencia de producción

in_progress - Trabajo de Nano Banana 2 actualmente en procesamiento activo

success - Trabajo de Nano Banana 2 finalizado exitosamente con visuales fabricados

failed - Trabajo de Nano Banana 2 terminado debido a complicaciones técnicas

Respuestas de Problemas

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Estructuras de Información de Nano Banana 2

Documentación completa para todas las configuraciones y plantillas de información de Nano Banana 2 utilizadas en las comunicaciones y envíos de API.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

Field	Type	Description
image	string	Image URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}

Field	Type	Description
result	array	Array of ImageGenResult objects (null if failed)
status	string	Final task status (success/failed)
task_id	string	Unique task identifier
consumed	string	Credits consumed by the task
status_reason	object	Status details including error message if failed

Configuraciones Compatibles de Nano Banana 2

google/gempix2Nano Banana image generation model

google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Gestión de Problemas

Manual completo para manejar complicaciones e interpretar indicadores de respuesta de la API. Todas las notificaciones de problemas siguen un formato estándar que permite metodologías de resolución eficientes.

Indicadores de Respuesta HTTP

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Enfoques Recomendados para Resolución de Problemas

Verificar siempre los indicadores de respuesta HTTP antes de analizar el contenido de salida
Implementar algoritmos de retraso progresivo para mecanismos de repetición durante complicaciones 500
Documentar notificaciones de problemas con detalles completos para fines de solución de problemas
Confirmar validez de entrada antes de enviar solicitudes para prevenir complicaciones 400
Abordar problemas de verificación solicitando actualizaciones de credenciales API a los clientes
Rastrear progreso de tareas a intervalos razonables en lugar de consultas excesivas de estado
Emplear integración de webhook siempre que sea posible para eliminar monitoreo constante de finalización

Ejemplo de Gestión de Problemas (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}