SeeDream Bilder Generierung API Integrationsanleitung

Dieser Artikel beschreibt eine Integrationsanleitung für die SeeDream Bilder Generierung API, die es ermöglicht, offizielle SeeDream-Bilder durch Eingabe benutzerdefinierter Parameter zu generieren.

Antragsprozess

Um die SeeDream Bilder Generierung API zu nutzen, gehen Sie zuerst zur Ace Data Cloud Konsole, um Ihr API-Token zu erhalten und es für später aufzubewahren.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, die Sie zur Registrierung und Anmeldung einlädt. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um es kostenlos auszuprobieren; wenn das Kontingent nicht ausreicht, können Sie im Dashboard Ihr Guthaben aufladen.

📘 Vollständige Dokumentation: SeeDream Bilder Generierung API →

Grundlegende Nutzung

Zuerst sollten Sie die grundlegende Nutzung verstehen, indem Sie das Eingabewort prompt, die Generierungsaktion action und die Bildgröße size eingeben, um das bearbeitete Ergebnis zu erhalten. Zuerst müssen Sie ein einfaches action-Feld übergeben, dessen Wert generate ist. Dann müssen wir auch das Eingabewort eingeben, die genauen Inhalte sind wie folgt:

Hier sehen wir, dass wir die Request-Header festgelegt haben, einschließlich:

accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen als application/json, also im JSON-Format.
authorization: Der Schlüssel zur API, den Sie nach der Beantragung direkt auswählen können.

Zusätzlich haben wir den Request-Body festgelegt, einschließlich:

prompt: Eingabewort.
model: Generierungsmodell, standardmäßig doubao-seedream-5-0-260128 (SeeDream 5.0 Lite, die neueste Version). Unterstützt werden doubao-seedream-5-0-pro-260628, doubao-seedream-5-0-260128 (akzeptiert auch den offiziellen Alias doubao-seedream-5-0-lite-260128), doubao-seedream-4-5-251128, doubao-seedream-4-0-250828. Dabei ist doubao-seedream-5-0-pro-260628 (SeeDream 5.0 Pro) das Flaggschiff-Modell für Einzelbilder, das nur Einzelbilder generiert, unterstützt keine Gruppenbilder (sequential_image_generation), Streaming (stream) oder Online-Suche (tools). model muss die vollständige Modellbezeichnung übergeben werden (z. B. doubao-seedream-5-0-260128), die Übertragung von Abkürzungen wie doubao-seedream-5.0-lite führt zu einem 400-Fehler.
image: Eingabebildinformationen, unterstützt URL oder Base64-Codierung. doubao-seedream-5-0-pro-260628 unterstützt Einzel- oder Mehrfachbilderingaben (Mehrfachbilder 2-10 Stück, ab dem 2. Bild wird nach Stück abgerechnet), doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 unterstützen Einzel- oder Mehrfachbilderingaben.
size: Gibt die Größeninformationen des zu generierenden Bildes an, unterstützt die folgenden zwei Methoden, die nicht gemischt werden können. Methode 1 | Gibt die Auflösung des zu generierenden Bildes an und beschreibt das Seitenverhältnis in natürlicher Sprache im Prompt. Die unterstützten Voreinstellungen variieren je nach Modell: doubao-seedream-5-0-pro-260628 unterstützt 1K/1.5K/2K; doubao-seedream-5-0-260128 unterstützt 2K/3K/4K; doubao-seedream-4-5-251128 unterstützt nur 2K/4K; doubao-seedream-4-0-250828 unterstützt 1K/2K/4K. Methode 2 | Gibt die Pixelwerte für Breite und Höhe des zu generierenden Bildes an: Standardmäßig 2048x2048, der Gesamtpixel- und Seitenverhältnisbereich variiert je nach Modell (z. B. hat 5.0 Pro einen Gesamtpixelbereich von [921600, 4624220], 5.0 Lite / 4.5 hat eine Gesamtpixeluntergrenze von 3.686.400, 4.0 hat eine Untergrenze von 921.600).
sequential_image_generation: Gruppenbilder: Eine Gruppe von inhaltlich verwandten Bildern, die basierend auf Ihren Eingaben generiert werden. doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 unterstützen diesen Parameter, standardmäßig disabled.
stream: Steuert, ob der Streaming-Ausgabemodus aktiviert ist. doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 unterstützen diesen Parameter, standardmäßig ist er false.
response_format: Gibt das Rückgabeformat des generierten Bildes an. Standardmäßig ist es url, unterstützt auch b64_json.
watermark: Ob ein Wasserzeichen im generierten Bild hinzugefügt werden soll. Standardmäßig ist es true.
output_format: Gibt das Dateiformat des generierten Bildes an, unterstützt jpeg (Standard) und png. Nur doubao-seedream-5-0-pro-260628 und doubao-seedream-5-0-260128 unterstützen dies.
tools: Konfiguriert die Werkzeuge, die das Modell aufrufen soll, derzeit wird web_search (Online-Suche) unterstützt. Nur SeeDream 5.0 Lite unterstützt dies.
optimize_prompt_options: Konfiguration zur Optimierung des Eingabewortes. 5.0 Pro unterstützt standard/fast; 5.0 Lite und 4.5 unterstützen nur standard; 4.0 unterstützt standard/fast.
background: Nur 5.0 Pro Einzelbildbearbeitung unterstützt. transparent erfordert die Eingabe eines PNG mit transparentem Kanal, und output_format muss png sein; opaque ist ein normales undurchsichtiges Hintergrundbild.
layer_decomposition: Nur 5.0 Pro unterstützt. Wenn auf true gesetzt, muss ein PNG/JPEG eingegeben werden, prompt kann weggelassen werden, um automatisch zu zerlegen, oder mit natürlicher Sprache/<bbox> Elemente anzugeben; size unterstützt auto/1K/1.5K/2K. Dieser Modus kann nicht mit Gruppenbildern, Streaming, Online-Suche oder background verwendet werden.
callback_url: Die URL, an die die Ergebnisse zurückgerufen werden sollen.
async: Ob die Verarbeitung im asynchronen Modus erfolgen soll. Wenn auf true gesetzt, gibt die Schnittstelle sofort task_id zurück, ohne dass callback_url bereitgestellt werden muss, und anschließend kann das Ergebnis über /seedream/tasks abgefragt werden.

Nach der Auswahl können Sie feststellen, dass auf der rechten Seite auch der entsprechende Code generiert wurde, wie im Bild gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen. Wie im obigen Bild gezeigt, haben wir folgendes Ergebnis erhalten:

{
  "success": true,
  "task_id": "81246f86-05ff-4d7d-9553-1013e0c1cd32",
  "trace_id": "ab50a78d-ab1f-457f-a46b-c2259cd5d35b",
  "data": [
    {
      "prompt": "Ein fotorealistisches Studio-Produktfoto einer parfümflasche aus frosted-glas auf nassem schwarzem Schiefer, einzelnes Softbox-Hauptlicht, Wassertropfen, dunkler stimmungsvolles Hintergrund, 85mm Makro.",
      "size": "2048x2048",
      "image_url": "https://platform2.cdn.acedata.cloud/seedream/901c6af6-e83a-4849-b233-295f6c20bacb.jpg"
    }
  ]
}

Die Rückgabe enthält mehrere Felder, die wie folgt beschrieben werden:

success, der Status des Videoerzeugungsauftrags zu diesem Zeitpunkt.
task_id, die ID des Videoerzeugungsauftrags zu diesem Zeitpunkt.
trace_id, die Verfolgungs-ID des Videoerzeugungsauftrags zu diesem Zeitpunkt.
data, die Ergebnisliste des Bildgenerierungsauftrags zu diesem Zeitpunkt.
- image_url, der Link zum Bildgenerierungsauftrag zu diesem Zeitpunkt.
- prompt, der Hinweistext.
- size: die Pixelgröße des generierten Bildes.

Wir können sehen, dass wir zufriedenstellende Bildinformationen erhalten haben, und wir müssen nur den Link zur data-Bildadresse abrufen, um das generierte SeeDream-Bild zu erhalten. Wenn Sie den entsprechenden Code zur Integration generieren möchten, können Sie ihn direkt kopieren, zum Beispiel der CURL-Code wie folgt:

curl -X POST 'https://api.acedata.cloud/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "doubao-seedream-5-0-260128",
  "prompt": "Ein fotorealistisches Studio-Produktfoto einer parfümflasche aus frosted-glas auf nassem schwarzem Schiefer, einzelnes Softbox-Hauptlicht, Wassertropfen, dunkler stimmungsvolles Hintergrund, 85mm Makro."
}'

Bildbearbeitungsauftrag

Wenn Sie ein Bild bearbeiten möchten, muss zunächst der Parameter image die zu bearbeitende Bildadresse übergeben werden.

model: das Modell, das für diesen Bildbearbeitungsauftrag verwendet wird, doubao-seedream-5-0-pro-260628, doubao-seedream-5-0-260128, doubao-seedream-4-5-251128, doubao-seedream-4-0-250828 unterstützen alle die Eingabe von Bildern.
image: das hochzuladende Bild, ein oder mehrere.

Ein Beispiel für die Eingabe sieht wie folgt aus:

Der entsprechende Code:

import requests

url = "https://api.acedata.cloud/seedream/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedream-4-0-250828",
  "prompt": "Behalten Sie die Pose des Modells und die fließende Form des flüssigen Kleidungsstücks unverändert. Ändern Sie das Kleidungsmaterial von silbernem Metall zu vollständig transparentem Wasser (oder Glas). Durch den Flüssigkeitsfluss sind die Details der Modellhaut sichtbar. Der Licht- und Schatteneffekt wechselt von Reflexion zu Brechung.",
  "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"],
  "size": "2K",
  "watermark": False
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Wenn Sie auf Ausführen klicken, können Sie sofort ein Ergebnis erhalten, wie folgt:

{
  "success": true,
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
  "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
  "data": [
    {
      "prompt": "Behalten Sie die Pose des Modells und die fließende Form des flüssigen Kleidungsstücks unverändert. Ändern Sie das Kleidungsmaterial von silbernem Metall zu vollständig transparentem Wasser (oder Glas). Durch den Flüssigkeitsfluss sind die Details der Modellhaut sichtbar. Der Licht- und Schatteneffekt wechselt von Reflexion zu Brechung.",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
    }
  ]
}

Es ist zu sehen, dass der generierte Effekt eine Bearbeitung des Originalbildes ist, das Ergebnis ist ähnlich wie oben.

Schichtenzerlegung (Seedream 5.0 Pro)

Die Schichtenzerlegung wird ein Eingabebild in 1 Hintergrundbild und bis zu 16 unabhängig bearbeitbare transparente PNG-Schichten zerlegen. Die folgende Anfrage lässt das Modell die Hauptelemente automatisch erkennen; wenn Sie Elemente angeben möchten, können Sie prompt hinzufügen oder die normalisierten <bbox>-Koordinaten im Hinweistext verwenden.

curl -X POST 'https://api.acedata.cloud/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "model": "doubao-seedream-5-0-pro-260628",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K",
  "watermark": false
}'

Die zurückgegebene data ist nach z_index von unten nach oben angeordnet. Das Hintergrundbild hat einen z_index von 0; die Schichten enthalten auch name, description und bounding_box.absolute/normalized. Bei der Verwendung absoluter Koordinaten zur Rekonstruktion werden die Schichten auf [right-left, bottom-top] skaliert, an [left, top] platziert und dann in aufsteigender Reihenfolge nach z_index übereinander gestapelt. Wenn eine Schicht nicht erfolgreich generiert wird, schlägt die gesamte Zerlegung fehl.

Stream-Ausgabe

Lite/4.x setzt stream: true, dann verwenden Sie im Anfrageheader accept: application/x-ndjson. Die Schnittstelle gibt zeilenweise image_generation.partial_succeeded oder image_generation.partial_failed zurück, und schließlich wird ein einzigartiges image_generation.completed-Ereignis und die endgültige usage zurückgegeben; nur das Abschlussereignis löst eine Abrechnung aus. Der Streaming-Modus kann nicht mit async oder callback_url verwendet werden.

Asynchrone Rückrufe

Da die von der SeeDream Images Generation API erzeugte Zeit relativ lang ist, etwa 1-2 Minuten, bleibt die HTTP-Anfrage bei längerer Nichtreaktion der API verbunden, was zu einem zusätzlichen Systemressourcenverbrauch führt. Daher bietet diese API auch Unterstützung für asynchrone Rückrufe. Der gesamte Prozess ist: Wenn der Client die Anfrage stellt, gibt er zusätzlich ein callback_url-Feld an. Nachdem der Client die API-Anfrage gestellt hat, gibt die API sofort ein Ergebnis zurück, das ein task_id-Feld enthält, das die aktuelle Aufgaben-ID darstellt. Wenn die Aufgabe abgeschlossen ist, wird das Ergebnis des generierten Bildes in Form von POST JSON an die vom Client angegebene callback_url gesendet, das auch das task_id-Feld enthält, sodass die Aufgabenergebnisse über die ID verknüpft werden können. Wenn Sie keine öffentliche Adresse für Rückrufe haben, können Sie auch callback_url nicht angeben, sondern das async-Feld in der Anfrage auf true setzen. In diesem Fall gibt die Schnittstelle ebenfalls sofort die task_id zurück, aber es werden keine Ergebnisse gepusht. Sie müssen die task_id verwenden, um den Status der Aufgabe über die /seedream/tasks-Schnittstelle abzufragen, um das endgültige Ergebnis zu erhalten. Lassen Sie uns durch ein Beispiel verstehen, wie dies konkret funktioniert. Wenn Sie auf Ausführen klicken, können Sie sofort ein Ergebnis erhalten, wie folgt:

{
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde"
}

Der Inhalt lautet wie folgt:

```json
{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Behalten Sie die Pose des Modells und die fließende Form des flüssigen Kleidungsstücks unverändert. Ändern Sie das Kleidungsmaterial von silbernem Metall zu vollständig transparentem Wasser (oder Glas). Durch den Flüssigkeitsfluss sind die Details der Haut des Modells sichtbar. Der Licht- und Schatteneffekt wechselt von Reflexion zu Brechung.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

Es ist zu erkennen, dass im Ergebnis ein task_id-Feld vorhanden ist, während die anderen Felder ähnlich wie im vorherigen Text sind. Über dieses Feld kann die Zuordnung der Aufgaben erfolgen.

Fehlerbehandlung

Bei der API-Nutzung, wenn ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Informationen zurück. Zum Beispiel:

400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
401 invalid_token: Unbefugt, ungültiger oder fehlender Autorisierungstoken.
429 too_many_requests: Zu viele Anfragen, Sie haben das Rate-Limit überschritten.
500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

Fehlerantwort Beispiel

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "Abruf fehlgeschlagen"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die SeeDream Images Generation API verwenden können, um Bilder durch Eingabe von Aufforderungswörtern zu generieren. Wir hoffen, dass dieses Dokument Ihnen hilft, die API besser zu integrieren und zu nutzen. Bei Fragen wenden Sie sich bitte jederzeit an unser technisches Support-Team.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Proxy

Erweitert

Coding

SeeDream Bilder Generierung API Integrationsanleitung

Antragsprozess

Grundlegende Nutzung

Bildbearbeitungsauftrag

Schichtenzerlegung (Seedream 5.0 Pro)

Stream-Ausgabe

Asynchrone Rückrufe

Fehlerbehandlung

Fehlerantwort Beispiel

Fazit

​Antragsprozess

​Grundlegende Nutzung

​Bildbearbeitungsauftrag

​Schichtenzerlegung (Seedream 5.0 Pro)

​Stream-Ausgabe

​Asynchrone Rückrufe

​Fehlerbehandlung

​Fehlerantwort Beispiel

​Fazit

Antragsprozess

Grundlegende Nutzung

Bildbearbeitungsauftrag

Schichtenzerlegung (Seedream 5.0 Pro)

Stream-Ausgabe

Asynchrone Rückrufe

Fehlerbehandlung

Fehlerantwort Beispiel

Fazit