Skip to main content
Dieser Artikel beschreibt eine Integrationsanleitung für die SeeDream Images Generation API, die es ermöglicht, offizielle SeeDream-Bilder durch Eingabe benutzerdefinierter Parameter zu generieren.

​
Antragsprozess

Um die SeeDream Images Generation 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 alle Dienste der Plattform zu nutzen, 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 Images Generation 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 verarbeitete Ergebnis zu erhalten. Zuerst müssen wir 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 zum Aufrufen der API, nach der Beantragung können Sie ihn direkt aus der Dropdown-Liste auswählen.
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, 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) und 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/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, die Gesamtpixelanzahl und das Seitenverhältnis variieren je nach Modell (z. B. hat 5.0 Pro einen Gesamtpixelbereich von [921600, 4194304], 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 doubao-seedream-5-0-260128 unterstützt dies.
  • 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 die Ergebnisse können anschließend über /seedream/tasks abgefragt werden.
Nach der Auswahl können Sie sehen, 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:
Die Rückgabeergebnisse umfassen 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.
    • prompt, das Eingabewort.
    • size: Die Pixel des generierten Bildes.
Wir können sehen, dass wir zufriedenstellende Bildinformationen erhalten haben. Wir müssen nur die Bild-URL aus den data-Ergebnissen abrufen, um das generierte SeeDream-Bild zu erhalten. Wenn Sie außerdem den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren, zum Beispiel sieht der CURL-Code wie folgt aus:

​
Bildbearbeitungsaufgabe

Wenn Sie ein Bild bearbeiten möchten, muss zunächst der Parameter image den Link zum zu bearbeitenden Bild enthalten.
  • model: Das für die Bildbearbeitungsaufgabe verwendete Modell, 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: Hochladen des zu bearbeitenden Bildes, ein oder mehrere
Beispielausfüllung:

Entsprechender Code:
Wenn Sie auf Ausführen klicken, erhalten Sie sofort ein Ergebnis, wie folgt:
Sie können sehen, dass der generierte Effekt eine Bearbeitung des Originalbildes ist, das Ergebnis ist ähnlich wie oben.

​
Asynchrone Rückrufe

Da die von der SeeDream Images Generation API benötigte Zeit relativ lang ist, etwa 1-2 Minuten, bleibt die HTTP-Anfrage bei langer Nichtreaktion verbunden, was zu einem zusätzlichen Verbrauch von Systemressourcen 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 Feld callback_url an. Nachdem der Client die API-Anfrage gestellt hat, gibt die API sofort ein Ergebnis zurück, das ein Feld task_id 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, wobei auch das Feld task_id enthalten ist, sodass das Aufgabenergebnis über die ID verknüpft werden kann. Wenn Sie keine öffentliche Adresse für Rückrufe haben, können Sie auch callback_url nicht angeben, sondern das Feld async in der Anfrage auf true setzen. In diesem Fall gibt die Schnittstelle ebenfalls sofort 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 anhand eines Beispiels verstehen, wie dies konkret funktioniert. Wenn Sie auf Ausführen klicken, erhalten Sie sofort ein Ergebnis, wie folgt:
Inhalt wie folgt:
Sie können sehen, dass das Ergebnis ein Feld task_id enthält, die anderen Felder sind ähnlich wie oben, und über dieses Feld kann die Aufgabe verknüpft werden.

​
Fehlerbehandlung

Beim Aufruf der API, 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 Kontingent überschritten.
  • 500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

​
Beispiel für eine Fehlerantwort

​
Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die SeeDream Images Generation API verwenden können, um Bilder durch Eingabe von Aufforderungen 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.