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": "A cat playing on the grass",
  "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

Nanobanana 2.1 Bildgenerierung

Nano Banana 2.1 (gemini-nano-banana-2.1) unterstützt Text-zu-Bild, Bild-zu-Bild, Bildbearbeitung und die Zusammenführung mehrerer Bilder mit den Ausgabeauflösungen 1K, 2K und 4K
Asynchrone Verarbeitung: Verwenden Sie die zurückgegebene Aufgaben-ID, um die Aufgabe abzufragen
Die Links zu generierten Bildern sind 24 Stunden gültig. Speichern Sie die Bilder zeitnah
Abrechnung: Ausgabebilder werden nach Auflösung, Eingabebilder pro Bild und Web- sowie Bildsuchen nach der tatsächlich ausgeführten Anzahl von Suchen abgerechnet. Prompt-Text, Textausgabe und Denkprozess werden pro Token abgerechnet. Maßgeblich sind die in der Aufgabenabfrage zurückgegebenen usage-Angaben

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": "A cat playing on the grass",
  "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"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:gemini-nano-banana-2.1

erforderlich

Name des Bildgenerierungsmodells, offizieller Kanal, bessere Stabilität und Steuerbarkeit, geeignet für kommerzielle Szenarien

Verfügbare Optionen:

gemini-nano-banana-2.1

Beispiel:

"gemini-nano-banana-2.1"

prompt

string

erforderlich

Prompt zur Beschreibung des zu generierenden Bildes oder zur Bearbeitung eines Eingabebildes, maximal 4000 Token

Beispiel:

"A cat playing in the grass"

size

enum<string>

Standard:auto

Seitenverhältnis des generierten Bildes, Standard ist auto

Verfügbare Optionen:

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>

Standard:2K

Auflösung des Ausgabebildes, standardmäßig 2K

Hinweis:

Die Preise unterscheiden sich je nach Auflösung. Ausgabebilder werden nach der ausgewählten Auflösung abgerechnet. Es wird empfohlen, diesen Parameter ausdrücklich anzugeben

Verfügbare Optionen:

1K,

2K,

4K

image_urls

string<uri>[]

Liste von Referenzbild-URLs für Bild-zu-Bild-Generierung, Bildbearbeitung und die Zusammenführung mehrerer Bilder

Hinweis:

Bis zu 14 Eingabebilder pro Anfrage
Bildgröße: höchstens 20MB
Unterstützte Dateiformate: .jpeg, .jpg, .png, .webp
Bild-URLs müssen für den Server direkt zugänglich sein oder beim Aufruf einen direkten Bilddownload auslösen (solche URLs enden üblicherweise mit einer Bilddateiendung wie .png oder .jpg)
Eingabebilder werden pro Bild abgerechnet

Maximum array length: 14

Beispiel:

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

model_params

object

Modell-Erweiterungsparameter

Show child attributes

callback_url

string<uri>

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

Nur HTTPS-Protokoll wird unterstützt
Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus

Beispiel:

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

Antwort

Bildgenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757165031

string

Aufgaben-ID

Beispiel:

"task-unified-1757165031-uyujaw3d"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"gemini-nano-banana-2.1"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

image.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Asynchrone Aufgabeninformationen

Show child attributes

type

enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"image"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Nanobanana 2.1 Bildgenerierung

Autorisierungen

Body

Antwort