Nano Banana 2.1 API

Vollständige API-Referenz für die Text-zu-Bild- und Bildbearbeitungsmodelle von Nano Banana 2.1.

Modellvarianten

Diese API unterstützt zwei Modellvarianten:

Kurzvergleich

Unterstützte Seitenverhältnisse

Beide Modelle unterstützen 14 Seitenverhältnisse:

• 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

Geben Sie das Verhältnis als separate numerische Werte für width und height an; beispielsweise wählen width: 16 und height: 9 das Verhältnis 16:9. Diese Werte beschreiben ein Verhältnis, nicht die Pixelabmessungen der Ausgabe.

Nano Banana 2.1 (Text-zu-Bild)

Endpunkt

POST /api/v1/image/task

Authentifizierung

Authorization: Bearer YOUR_API_KEY

Anfrageparameter

Erforderlich

Hinweis: Das Verhältnis width:height muss einem der folgenden Werte entsprechen: 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.

Optional

Beispielanfrage

javascriptKopieren
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 (Bildbearbeitung)

Endpunkt

POST /api/v1/image/task

Anfrageparameter

Erforderlich

Hinweis: Das Verhältnis width:height muss einem der 14 oben aufgeführten unterstützten Verhältnisse entsprechen.

Optional

Beispiel für die Bearbeitung eines einzelnen Bildes

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

Beispiel für die Komposition mehrerer Bilder

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

Abrechnungshinweis: Referenzbilder werden ab dem ersten Bild einzeln berechnet. Jede aktivierte Suchoption verursacht unabhängig von der Bildanzahl eine separate feste Gebühr pro Generierung. Die Tarife finden Sie in der aktuellen Preisübersicht.

Antwortformat

Erste Antwort

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

Antwort bei Statusabfrage

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

Erfolgreiche Antwort

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

Statuswerte

• submitted: Aufgabe angenommen
• processing: Aufgabe wird ausgeführt
• succeed: Aufgabe erfolgreich abgeschlossen
• failed: Aufgabe fehlgeschlagen

Bewährte Vorgehensweisen

Tipps zur Text-zu-Bild-Generierung

1. Bild beschreiben: Geben Sie Motiv, Beleuchtung und Komposition im Prompt an.
2. Auflösung wählen: Übergeben Sie in jeder Anfrage 1k, 2k oder 4k.
3. Seitenverhältnis auswählen: Übergeben Sie die passenden Werte für width und height für eines der 14 unterstützten Verhältnisse.
4. Suchoptionen wählen: Lassen Sie den jeweiligen Suchparameter weg, um seinen Standardwert false zu verwenden; setzen Sie ihn bei Bedarf auf true.

Tipps zur Bildbearbeitung

1. Referenzbilder bereitstellen: Geben Sie in image_url_list eine bis 14 erreichbare Bild-URLs an.
2. Änderung beschreiben: Geben Sie im Prompt an, was geändert oder beibehalten werden soll.
3. Ausgabeeinstellungen auswählen: Geben Sie die erforderlichen Werte für resolution, width und height an.
4. Suchoptionen wählen: Websuche und Bildersuche können unabhängig voneinander aktiviert werden.