Zum Hauptinhalt springen

Einführung

Seedream ist ein von Ace Data Cloud bereitgestellter KI-Bilddienst, basierend auf dem Seedream-Bildgenerierungsmodell von ByteDance. Über die einheitliche API von Ace Data Cloud können Sie Seedream schnell mit cURL aufrufen, um Funktionen wie Text-zu-Bild, Bildbearbeitung, verschiedene Auflösungen und Wasserzeichensteuerung zu nutzen.

Voraussetzungen

  • Ein Ace Data Cloud Konto und ein API-Token
  • Ein Terminal mit installiertem cURL

Grundlegende Verwendung

Der Hauptendpunkt für den Aufruf der Seedream API ist:
POST https://api.acedata.cloud/seedream/images
In diesem Beispiel wird das Modell doubao-seedream-4-0-250828 verwendet. Verfügbare Modelle sind: doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628. Vollständiges cURL-Beispiel:
curl -X POST https://api.acedata.cloud/seedream/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "一只白色的暹罗猫坐在窗台上", "model": "doubao-seedream-4-0-250828", "size": "1K"}'
Ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

Beispielantwort

Bei erfolgreichem Aufruf wird eine JSON-Antwort zurückgegeben, z. B.:
{
  "status": "success",
  "data": {
    ...
  }
}

Verarbeitung der Antwort mit jq

Es wird empfohlen, das Tool jq zur Formatierung der Ausgabe zu verwenden:
curl -s -X POST https://api.acedata.cloud/seedream/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "一只白色的暹罗猫坐在窗台上", "model": "doubao-seedream-4-0-250828", "size": "1K"}' | jq .

Fehlerbehandlung

Häufige Fehlercodes:
StatuscodeBeschreibung
401Authentifizierung fehlgeschlagen, bitte API-Token prüfen
403Unzureichendes Guthaben oder kein Zugriff
429Anfragerate überschritten
500Interner Serverfehler

Nächste Schritte