Seedream 5.5 API-Leitfaden: Preise, Parameter und Aufrufbeispiele

Was Seedream 5.5 kann

Seedream 5.5 ist ein Bildmodell auf HiAPI. Eine einzige Modell-ID (seedream-5.5) deckt zwei Anwendungsfälle gleichzeitig ab: Schreibt man nur einen Prompt, handelt es sich um Text-zu-Bild-Generierung; fügt man zusätzlich Referenzbilder hinzu, wird das Bild anhand der Referenzbilder bearbeitet oder der Bildinhalt beibehalten. Beide Anwendungsfälle nutzen dieselbe Schnittstelle und dieselben Parameter – der einzige Unterschied besteht darin, ob die Anfrage image_urls enthält.

Jeder Aufruf liefert ein Bild zurück. Im Folgenden wird die Reihenfolge „Wie wird der Preis berechnet → Wie werden die Parameter ausgefüllt → Wie wird die Anfrage gesendet → Welche Einschränkungen gibt es“ erläutert. Alle Zahlen entsprechen der Schnittstellendefinition zum Zeitpunkt der Erstellung dieses Artikels.

Preise: Abrechnung nach Pixelstufe, Referenzbilder werden pro Bild zusätzlich berechnet

Die Kosten setzen sich aus zwei Teilen zusammen: dem Grundpreis der Ausgabestufe plus den Kosten für Referenzbilder.

• 1K / 1.5K: $0.0186 / Bild
• 2K (Standardstufe): $0.0325 / Bild
• Referenzbilder: $0.0075 pro Bild, auch das erste Bild wird berechnet, maximal 10 Bilder

Einige Beispiele:

• 1K Text-zu-Bild ohne Referenzbild: $0.0186
• 2K mit 1 Referenzbild: $0.0325 + $0.0075 = $0.04
• 2K mit 10 Referenzbildern (Obergrenze): $0.0325 + $0.075 = $0.1075

Wird size nicht angegeben, wird mit 2K generiert und 2K abgerechnet. Für Skizzen oder kleine Begleitbilder spart die explizite Angabe von "size": "1K" etwa 40 %. Bei fehlgeschlagenen Aufgaben wird der volle Betrag erstattet.

Parameterübersicht

Außer model und prompt sind alle Parameter optional:

• prompt: erforderlich, 1–5000 Zeichen. Beschreibt das zu generierende Bild; bei Referenzbildern klar angeben, was geändert und was beibehalten werden soll.
• size: 1K, 1.5K, 2K, Standard 2K.
• aspect_ratio: 10 Optionen – 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2. Wird nichts angegeben, wählt das Modell automatisch anhand von Prompt und Referenzbildern.
• image_urls: 1–10 öffentlich zugängliche http(s)-Bildadressen. Ohne Angabe reine Textgenerierung.
• output_format: png oder jpeg, Standard png.
• background: auto, transparent, opaque, Standard auto. Bei transparent ist als Ausgabeformat nur png zulässig; die Kombination mit jpeg wird abgelehnt.

Eine Anfrage senden

Bildaufgaben bei HiAPI sind asynchron: Zuerst wird die Aufgabe erstellt, dann das Ergebnis abgefragt. model steht auf der obersten Ebene, alle übrigen Parameter kommen in input.

Text-zu-Bild (2K, 16:9):

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "Leuchtturm am Meer im Morgengrauen, leichter Nebel, sanftes Seitenlicht, realistischer Fotostil",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

Bearbeitung mit Referenzbild (1K, transparenter Hintergrund, PNG):

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "Flaschenkörper und Etikett beibehalten, Hintergrund entfernen, durch weiches Deckenlicht ersetzen",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

Die Kosten für diesen Auftrag betragen $0.0186 + $0.0075 = $0.0261. Nach erfolgreicher Erstellung ruft man mit der zurückgegebenen Aufgaben-ID GET https://api.hiapi.ai/v1/tasks/{taskId} zum Polling auf; sobald der Status erfolgreich ist, entnimmt man die Bildadresse aus der Ausgabe und lädt das Bild herunter.

Aktuelle Einschränkungen

• Maximal 2K, keine 4K-Stufe.
• Keine geschichtete Bildausgabe.
• Jeder Aufruf liefert nur ein Bild; für mehrere Bilder müssen mehrere Aufgaben parallel gesendet werden.
• Referenzbilder müssen über öffentlich erreichbare http(s)-Adressen verfügbar sein; lokale Dateipfade oder base64 werden nicht akzeptiert.
• Transparenter Hintergrund wird nur mit PNG unterstützt.

Wie die Stufe gewählt wird

Für Poster und Produkthauptbilder, die direkt online gehen sollen, das standardmäßige 2K verwenden; für interne Entwürfe, Stiltests im Batch und kleine Vorschaubilder 1K oder 1.5K verwenden (beide kosten gleich viel, 1.5K ist schärfer – wenn es keinen Grund für 1K gibt, direkt 1.5K nehmen). Referenzbilder werden pro Bild berechnet; nur die Bilder verwenden, die das Ergebnis wirklich beeinflussen. Bei mehreren Ansichten desselben Produkts zuerst mit 1–2 Bildern testen und erst bei unzureichendem Ergebnis weitere hinzufügen.