API de Nano Banana 2.1

Referencia completa de la API para los modelos de generación de imágenes a partir de texto y edición de imágenes Nano Banana 2.1.

Variantes del modelo

Esta API admite dos variantes del modelo:

Comparación rápida

Relaciones de aspecto admitidas

Ambos modelos admiten 14 relaciones de aspecto:

• 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

Indica la relación mediante valores numéricos separados de width y height; por ejemplo, width: 16 y height: 9 seleccionan 16:9. Estos valores describen una relación, no las dimensiones de salida en píxeles.

Nano Banana 2.1 (Generación de imágenes a partir de texto)

Punto de acceso

POST /api/v1/image/task

Autenticación

Authorization: Bearer YOUR_API_KEY

Parámetros de la solicitud

Obligatorios

Nota: La relación width:height debe ser una de las siguientes: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1.

Opcionales

Ejemplo de solicitud

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'nano-banana-2.1',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k',
    enable_web_search: true,
    enable_image_search: false
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Nano Banana 2.1 Edit (Edición de imágenes)

Punto de acceso

POST /api/v1/image/task

Parámetros de la solicitud

Obligatorios

Nota: La relación width:height debe ser una de las 14 relaciones admitidas indicadas anteriormente.

Opcionales

Ejemplo de edición de una sola imagen

javascriptCopiar
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg'],
  enable_web_search: false,
  enable_image_search: true
}

Ejemplo de composición con múltiples imágenes

javascriptCopiar
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg'],
  enable_web_search: false,
  enable_image_search: false
}

Nota sobre facturación: Las imágenes de referencia se cobran por imagen desde la primera. Cada opción de búsqueda activada añade un cargo fijo independiente por generación, sin importar el número de imágenes. Consulta los precios actuales para conocer las tarifas.

Formato de respuesta

Respuesta inicial

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

Respuesta a la consulta periódica

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

Respuesta exitosa

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

Valores de estado

• submitted: Tarea aceptada
• processing: Tarea en ejecución
• succeed: Tarea completada correctamente
• failed: La tarea falló

Buenas prácticas

Consejos para la generación de imágenes a partir de texto

1. Describe la imagen: Incluye el sujeto, la iluminación y la composición en el prompt.
2. Elige una resolución: Envía 1k, 2k o 4k en cada solicitud.
3. Selecciona una relación de aspecto: Envía los valores de width y height correspondientes a una de las 14 relaciones admitidas.
4. Elige las opciones de búsqueda: Omite cualquiera de los parámetros de búsqueda para usar su valor por defecto false; establécelo en true cuando sea necesario.

Consejos para la edición de imágenes

1. Proporciona imágenes de referencia: Incluye entre una y 14 URL de imágenes accesibles en image_url_list.
2. Describe la edición: Indica en el prompt qué debe cambiar o conservarse.
3. Selecciona los ajustes de salida: Proporciona los valores obligatorios de resolution, width y height.
4. Elige las opciones de búsqueda: La búsqueda web y la búsqueda de imágenes se pueden activar de forma independiente.