Seedream 5 Bild-API

API-Dokumentation

Mit diesen Endpunkten erzeugen Sie Seedream 5 Bilder asynchron. Der Credit-Verbrauch hängt von Qualität und Modus ab.

Authentifizierung

Alle Anfragen müssen Ihren API-Schlüssel im Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Fehlende oder ungültige Schlüssel geben 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

Generierungsaufgabe erstellen

Reicht einen neuen Seedream 5 Job ein. Der Aufruf gibt sofort eine task_id zurück, während das Rendern **asynchron** abgeschlossen wird.

Parameter	Typ	Erforderlich	Beschreibung
prompt	string (max 1500 chars)	Ja	Primäre Textbeschreibung (maximal 1500 Zeichen). Für jede Anfrage erforderlich.
aspectRatio	string	Ja	Unterstützte Formate: 1:1 · 3:4 · 4:3 · 9:16 · 16:9.
quality	string (basic \| high)	Ja	basic (schnell, 2K) oder high (detailreicher, 4K).
imageUrls	string[]	Nein	Optionale Referenzbilder. Im Bearbeitungsmodus erforderlich.

Kreditverbrauch

Kredite werden bei der Erstellung der Aufgabe abgezogen. Fehlgeschlagene Jobs werden automatisch **erstattet**.

Voreinstellung	Abgezogene Kredite
Text zu Bild · Basic	12
Text zu Bild · High	18
Bearbeitung mit Referenz · Basic	18
Bearbeitung mit Referenz · High	24
4-Bilder-Serie (ein Aufruf)	48

Beispielanfrage

POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
  "aspectRatio": "4:3",
  "quality": "high",
  "imageUrls": []
}

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71"
  }
}

GET / POST

https://seedream45ai.org/api/status

Aufgabenstatus überprüfen

Verwenden Sie diesen Endpunkt, um den neuesten Datensatz abzufragen. Wenn sich die Aufgabe noch im Status IN_PROGRESS befindet, fragen wir den Anbieter einmal zusätzlich ab, bevor wir antworten.

Parameter	Typ	Erforderlich	Beschreibung
task_id	string	Ja	Von /generate zurückgegebene ID. Für /status als Query (?task_id=) senden.

Feld	Beschreibung
task_id	Von /generate zurückgegebene ID.
status	SUCCESS (ERFOLG)
request	Bereinigte Kopie der eingereichten Payload.
response	Array von Medien-URLs, wenn der Status SUCCESS ist.
consumed_credits	Für die Aufgabe berechnete Kredite (0 bei Rückerstattung).
error_message	Anbieterfehler, wenn der Status FAILED ist.
created_at	UTC-Zeitstempel, wann der Job gespeichert wurde.

Beispielanfrage

GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>

Beispielantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71",
    "status": "SUCCESS",
    "request": {
      "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
      "aspectRatio": "4:3",
      "quality": "high"
    },
    "response": [
      "https://watch_001.png"
    ],
    "consumed_credits": 12,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Fehlerbehandlung

401 Unauthorized - Fehlender oder ungültiger API-Schlüssel.
402 Payment Required - Das Kreditguthaben konnte die Abbuchung nicht decken.
429 Too Many Requests - Reduzieren Sie die Abfragefrequenz oder die Anfragerate.
500 - Vorübergehendes Problem; versuchen Sie es mit exponentiellem Backoff erneut.