Seedream 5.5 AI

Dokumentation für Entwickler

Seedream 5 Pro API-Dokumentation

Erstellen Sie Bilder mit Seedream 5 Pro über die asynchrone API dieser Website. Seedream 5.5 bleibt eine Vorschauversion und kann hier noch nicht aufgerufen werden.

Schnellstart

  1. Erstellen Sie einen Schlüssel im Bereich für API-Schlüssel des Arbeitsbereichs.
  2. Senden Sie model=seedream-5-pro und einen Prompt an POST /api/v1/images/generate.
  3. Fragen Sie GET /api/v1/images/status?task_id=TASK_ID mit dem erhaltenen data.task_id und demselben API-Schlüssel ab.

Authentifizierung

Senden Sie Authorization: Bearer YOUR_API_KEY von Ihrem Server. Eine Browsersitzung oder ein Cookie ist nicht erforderlich. Halten Sie Ihren API-Schlüssel geheim.

Authorization: Bearer YOUR_API_KEY

Endpunkte und Anfragefelder

POST /api/v1/images/generate

Senden Sie einen JSON-Body mit model, prompt, aspect_ratio und resolution (1k oder 2k). Das optionale Feld image_urls akzeptiert bis zu 10 Referenzbild-URLs; public ist ein optionaler boolescher Wert. Die Antwort enthält code, message und data mit task_id und status.

GET /api/v1/images/status?task_id=TASK_ID

Die Abfrage mit task_id liefert code, message und data mit task_id, status, consumed_credits und image_urls (ein Array von Bild-URLs). Bei einem Fehler kann error_message enthalten sein.

Das einzige aufrufbare Modell ist seedream-5-pro

Fragen Sie den Status während der Verarbeitung weiter ab. Lesen Sie nach Abschluss image_urls oder bei einem Fehler error_message.

cURL-Beispiel

Kopieren Sie die Befehle in Ihr Terminal, ersetzen Sie YOUR_API_KEY durch Ihren privaten API-Schlüssel und TASK_ID durch data.task_id aus der ersten Antwort.

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"Ein Café-Poster mit klarer und gut lesbarer Schrift","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'