API

Seedream 5.0 Pro API

Bild

Die Seedream 5.0 Pro API unterstützt die Bilderzeugung aus Text und die Bearbeitung von Referenzbildern mit flexiblen Seitenverhältnissen und 1K- oder 2K-Ausgabe.

Autorisierungen

Bearerstringheadererforderlich

API-Schlüssel zur Autorisierung von Anfragen

Body

application/json

modelstringerforderlich

seedream-5-0-pro

input.promptstringerforderlich

Beschreiben Sie das zu erstellende Bild oder die gewünschten Änderungen an Ihren Referenzbildern. Leerzeichen am Anfang und Ende werden entfernt.

input.imagesstring[]optional

Optionale URLs für Referenzbilder. Verwenden Sie ausschließlich öffentlich zugängliche HTTPS-URLs. Für die Bildgenerierung aus Text kann das Feld weggelassen werden.

Maximal 16 Einträge.

input.aspect_ratiostringoptional

Verhältnis von Breite zu Höhe des Bildes. Standard: 1:1.

Standard: 1:1

1:116:99:163:22:33:44:321:9

input.resolutionstringoptional

Bildauflösung. Verwenden Sie die Kleinbuchstabenwerte 1k oder 2k. Standard: 1k.

Standard: 1k

1k2k

Anfragebeispiele

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "Ein cineastisches Produktfoto einer futuristischen Kamera in Bananenform",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedream-5-0-pro",
    "status": "processing",
    "credits": 50
  }
}

Fragen Sie diesen Endpunkt mit der zurückgegebenen Aufgaben-ID ab, bis die Aufgabe abgeschlossen ist oder fehlschlägt. Wir empfehlen eine Abfrage alle 5 Sekunden, um den aktuellen Status zu prüfen.

POST /api/v1/check

{
  "task_id": "task_example"
}

Antwort

Aufgabenstatus von POST /api/v1/check. Die folgenden IDs, URLs und Zeitstempel dienen als Beispiele.

idstringerforderlich

Aufgabenkennung in data.id, identisch mit task_id in der Statusabfrage.

statusstringerforderlich

completed bedeutet, dass die Generierung erfolgreich war und data.data die Ergebnisse enthält. Bei anderen Statuswerten ist data.data null.

failed_reasonstringoptional

Wird nur bei status failed zurückgegeben und erklärt die Fehlerursache. Bei completed und processing fehlt dieses Feld.

Abgeschlossen · completed

Download-URLs stehen in data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Andere Statuswerte

Bei processing oder failed ist data.data null. Dieses Beispiel zeigt failed: Nur failed enthält failed_reason. Bei processing weiter abfragen, bei failed aufhören.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Credit-Verbrauch

Verbrauchte Credits für eine Anfrage, die ein Bild erzeugt.

Verbrauchte Credits für eine Anfrage, die ein Bild erzeugt.
Auflösung	1K	2K
Ein Bild	50	100

Optionale Parameter weggelassen: 50 Credits

Geben Sie die aufgeführten input-Parameter ausdrücklich an, um den jeweiligen Tarif zu nutzen. Anfragen mit mehreren Ausgabebildern können mehr Credits verbrauchen.

Das Feld credits in der Antwort von POST /api/v1/create zeigt die für die Aufgabe abgebuchten Credits.