curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-nano-banana-2.1",
  "prompt": "Un gato jugando en la hierba",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-uyujaw3d",
  "model": "gemini-nano-banana-2.1",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 3.0845,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gemini-nano-banana-2.1",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Nanobanana 2.1

Generación de imágenes Nanobanana 2.1

Nano Banana 2.1 (gemini-nano-banana-2.1) admite generación de imágenes a partir de texto o imágenes, edición y composición de varias imágenes, con resoluciones de salida 1K, 2K y 4K
Procesamiento asíncrono: usa el ID de tarea devuelto para consultar la tarea
Los enlaces de las imágenes generadas son válidos durante 24 horas. Guarda las imágenes lo antes posible
Facturación: las imágenes de salida se facturan según su resolución, las imágenes de entrada por imagen y las búsquedas web y de imágenes según el número de búsquedas realizadas. El texto del prompt, la salida de texto y el razonamiento se facturan por token. Los cargos reales se determinan a partir de los datos usage devueltos al consultar la tarea

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-nano-banana-2.1",
  "prompt": "Un gato jugando en la hierba",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-uyujaw3d",
  "model": "gemini-nano-banana-2.1",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 3.0845,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gemini-nano-banana-2.1",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:gemini-nano-banana-2.1

requerido

Nombre del modelo de generación de imágenes, canal oficial, mejor estabilidad y controlabilidad, adecuado para escenarios comerciales

Opciones disponibles:

gemini-nano-banana-2.1

Ejemplo:

"gemini-nano-banana-2.1"

prompt

string

requerido

Prompt que describe la imagen que se desea generar o cómo editar una imagen de entrada, hasta 4000 tokens

Ejemplo:

"Un gato jugando en la hierba"

size

enum<string>

predeterminado:auto

Relación de aspecto de la imagen generada, por defecto es auto

Opciones disponibles:

auto,

1:1,

1:4,

4:1,

1:8,

8:1,

2:3,

3:2,

3:4,

4:3,

4:5,

5:4,

9:16,

16:9,

21:9

quality

enum<string>

predeterminado:2K

Resolución de la imagen generada, 2K por defecto

Nota:

Los precios varían según la resolución. Las imágenes de salida se facturan según la resolución seleccionada. Se recomienda especificar este parámetro de forma explícita

Opciones disponibles:

1K,

2K,

4K

image_urls

string<uri>[]

Lista de URL de imágenes de referencia para la generación a partir de imágenes, la edición y la composición de varias imágenes

Nota:

Hasta 14 imágenes de entrada por solicitud
Tamaño de la imagen: no más de 20MB
Formatos admitidos: .jpeg, .jpg, .png, .webp
El servidor debe poder acceder directamente a las URL o estas deben iniciar una descarga directa de la imagen (estas URL suelen terminar con una extensión de imagen como .png o .jpg)
Las imágenes de entrada se facturan por imagen

Maximum array length: 14

Ejemplo:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

model_params

object

Parámetros de extensión del modelo

Show child attributes

callback_url

string<uri>

Dirección de callback HTTPS después de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa, falla o se cancela
Se envía después de completar la confirmación de facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
El callback a direcciones IP internas está prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos en caso de fallo (reintentos después de 1 segundo/2 segundos/4 segundos)
El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos

Ejemplo:

"https://your-domain.com/webhooks/image-task-completed"

Respuesta

Tarea de generación de imagen creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757165031

string

ID de tarea

Ejemplo:

"task-unified-1757165031-uyujaw3d"

model

string

Nombre del modelo real utilizado

Ejemplo:

"gemini-nano-banana-2.1"

object

enum<string>

Tipo de tarea específico

Opciones disponibles:

image.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información de tarea asíncrona

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"image"

usage

object

Información de uso y facturación

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Generación de imágenes Nanobanana 2.1

Autorizaciones

Cuerpo

Respuesta