Referencia de la API Nano Banana Pro para Desarrolladores

El servicio de producción visual de la API de Nano Banana Pro permite a los desarrolladores conectarse con motores de aprendizaje automático avanzados para producir imágenes de alta calidad a partir de prompts de texto y fotografías de referencia. Nuestra solución de API de Nano Banana Pro proporciona una interfaz REST sencilla con gestión de tareas integral y funciones de notificación en tiempo real.

Todas las solicitudes a la API deben incluir una autenticación válida mediante credenciales de token Bearer. Incluye tu clave de API en la cabecera Authorization de cada solicitud.

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"
  }'

Crea imágenes usando la API de Nano Banana Pro con tecnologías avanzadas de aprendizaje automático y flexibles prompts de texto junto con imágenes de referencia.

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

{
  "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"
}

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

Consulta el estado y los resultados de las tareas de generación de imágenes de la API Nano Banana Pro usando el ID de tarea devuelto por el endpoint de generación de imágenes.

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

Referencia completa de todos los formatos de datos y esquemas de la API Nano Banana Pro usados en las solicitudes y respuestas de la API.

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

{
  "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
  }
}

Guía completa para manejar errores e interpretar códigos de respuesta de la API. Todos los mensajes de error siguen un formato consistente para facilitar la resolución de problemas.

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;
  }
}