# Seedream 5.5 API (https://wanapi.app/de/docs/seedream-5-5)





Seedream 5.5 generiert ein Bild aus Text oder bis zu 10 Referenzbildern. Die Ebenenzerlegung nimmt ein Bild entgegen und liefert ein Basisbild plus transparente Ebenen sowie optional ein Ergebnis der Drucktexterkennung.

[Playground testen](/de/models/seedream-5-5#playground) · [OpenAPI JSON](/models/seedream-5-5/openapi.json) · [Integrationsanleitung](/de/blog/seedream-5-5-api-guide)

## Authentifizierung und Endpunkte [#authentifizierung-und-endpunkte]

Verwende deinen Wan API-Schlüssel als Bearer-Token. Ein Schlüssel greift auf alle verfügbaren Modelle und Gruppen zu; am Schlüssel wählst du keine Gruppe aus.

| Methode | URL                                                       | Zweck                   |
| ------- | --------------------------------------------------------- | ----------------------- |
| POST    | `https://api.wanapi.app/seedream55/v1/images/generations` | Eine Bildaufgabe senden |
| GET     | `https://api.wanapi.app/seedream55/v1/tasks/{id}`         | Diese Aufgabe abfragen  |

Die Modell-ID lautet &#x2A;*`seedream-5-5`**. Diese Endpunkte sind asynchron. Sende einmal, speichere die Aufgaben-ID und frage sie bis `completed` oder `failed` ab. Eine ungewisse Netzwerkantwort ist keine Erlaubnis zum erneuten Senden.

## Ein Bild generieren [#ein-bild-generieren]

```bash
curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'
```

Eine akzeptierte Anfrage liefert eine Aufgabe statt Bilddaten:

```json
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
```

```bash
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"
```

Frage dieselbe ID alle paar Sekunden ab. Bewahre sie auf, wenn deine Anwendung nicht weiter wartet, damit sie später fortfahren kann. Aufgaben-IDs und Zeitstempel dieser Anleitung dienen der Veranschaulichung.

## Parameter [#parameter]

| Parameter                                      | Typ                | Standard                     | Regeln                                                                                                        |
| ---------------------------------------------- | ------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `model`                                        | string             | erforderlich                 | `seedream-5-5`                                                                                                |
| `prompt`                                       | string             | für Generierung erforderlich | Für Ebenenzerlegung optional.                                                                                 |
| `image`                                        | URL oder URL-Array | keiner                       | Bis zu 10 Referenzen; genau eine für Ebenen. Jede Referenz wird berechnet.                                    |
| `size`                                         | string             | `2K` oder `auto` für Ebenen  | Siehe Größenregeln unten.                                                                                     |
| `output_format`                                | string             | `png`                        | `png` oder `jpeg`. Steuert bei Ebenen nur das Basisbild.                                                      |
| `background`                                   | string             | `auto`                       | `auto`, `opaque`, `transparent`. Transparent erfordert PNG. Lasse dieses Feld im Ebenenmodus vollständig weg. |
| `layer_decomposition`                          | boolean            | `false`                      | Eine Referenz in ein Basisbild und transparente PNG-Ebenen zerlegen.                                          |
| `layer_decomposition_options.max_images`       | integer            | `30`                         | Gesamtbildobergrenze, 2–100, einschließlich Basisbild. Nur im Ebenenmodus.                                    |
| `layer_decomposition_options.text_recognition` | boolean            | `false`                      | Drucktextmetadaten in Ebenen anfordern. Nur im Ebenenmodus.                                                   |
| `optimize_prompt_options.mode`                 | string             | `standard`                   | Nur `standard` wird unterstützt.                                                                              |
| `watermark`                                    | boolean            | `false`                      | Ein Wasserzeichen für KI-generierte Inhalte anfordern.                                                        |
| `content_filter`                               | boolean            | `true`                       | Die Kunden-API akzeptiert false. Im Playground dürfen nur Administratoren die Prüfung deaktivieren.           |

Die Parameter `n`, `seed`, `stream`, `resolution`, `aspect_ratio`, `image_urls` und `response_format` werden nicht unterstützt. Undokumentierte Felder werden verworfen und aktivieren diese Funktionen nicht. Multipart-Uploads, Base64 und data-URIs werden abgelehnt.

## Ausgabegröße [#ausgabegröße]

Die Generierung akzeptiert `1K`, `1.5K`, `2K` oder genaue `WIDTHxHEIGHT`-Pixelangaben. Genaue Größen müssen insgesamt **921.600–4.624.220 Pixel** und ein Seitenverhältnis von **1:16 bis 16:1** haben. Beispielsweise ist `2048x1152` gültig. Ein Verhältnis wie `16:9` ist kein Größenwert.

Die Ebenenzerlegung akzeptiert `auto`, `1K`, `1.5K` oder `2K`; genaue Pixelangaben werden in diesem Modus nicht unterstützt. `auto` richtet sich nach der Eingabe und reserviert den höheren Ausgabetarif. Das Modell hat keine 3K- oder 4K-Vorgabe.

<span id="reference-images-and-editing" />

## Referenzbilder und Bearbeitung [#referenzbilder-und-bearbeitung]

Gib von dir gehostete öffentliche HTTP(S)-URLs ohne eingebettete Zugangsdaten an. Unterstützt werden JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF, bis zu 30 MB pro Bild und höchstens 36.000.000 Pixel insgesamt. AVIF und JP2 werden nicht unterstützt. Eine URL muss direkt ein Bild ohne Anmeldung oder Browserprüfung bereitstellen.

```json
{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}
```

Übergib für mehrere Referenzen ein URL-Array und erkläre die Rolle jedes Bildes im Prompt. Das Ergebnis bleibt ein Bild. Referenz-URLs in Beispielen sind Platzhalter: Ersetze sie durch deine eigenen erreichbaren Dateien.

## Ebenenzerlegung und Texterkennung [#ebenenzerlegung-und-texterkennung]

```json
{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}
```

Die Obergrenze umfasst das Basisbild; `4` bedeutet höchstens vier zurückgegebene Bilder, nicht vier Ebenen plus Basisbild. Das Modell kann weniger liefern. Lasse `prompt` für eine automatische Zerlegung weg oder benenne die zu trennenden Elemente. Ein Prompt kann Text unterdrücken, den er ausschließt.

Ebenen sind PNG-Dateien mit Transparenz. Baue das Bild in aufsteigender `z_index`-Reihenfolge auf, mit dem Basisbild bei 0. Falls ein Begrenzungsrahmen angegeben ist, skaliere die Ebene vor der Platzierung auf diesen Rahmen: Die Pixelabmessungen der Ebenendatei können von ihren Platzierungsabmessungen abweichen.

Das optionale `text_recognition` enthält den vollständigen `text` und `lines`. Jede Zeile kann eine `bounding_box` und formatierte `runs` enthalten. Der `style` eines Runs kann `similar_font_family`, `foreground_color` (`#RRGGBB`), `bold`, `italic`, `underline`, `strikethrough`, `shadow` und `translucent` umfassen. Dies sind Modellschätzungen. Künstlerische oder handschriftliche Schrift kann ohne Textergebnis bleiben; behandle das Feld als optional.

## Abgeschlossene Antwort [#abgeschlossene-antwort]

```json
{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}
```

Jedes Bild hat eine `url` und `size`. Weitere mögliche Felder sind `output_format`, `background`, `z_index`, `name`, `description`, `bounding_box` und `text_recognition`. `bounding_box.absolute` ist `[left, top, right, bottom]` in Pixeln des Basisbildes. `bounding_box.normalized` verwendet dieselben Koordinaten, skaliert auf 0–1000. Gehe nicht davon aus, dass optionale Metadaten bei jedem Bild vorhanden sind.

Behandle Bild-URLs als private Downloadlinks und speichere benötigte Dateien. Eine URL mit einem `access`-Token kann geöffnet werden, ohne deinen Konto-API-Schlüssel offenzulegen.

## Preise [#preise]

<Seedream55ModelPricing />

Die Ausgabegrenze liegt bei **2.610.000 Pixeln**. Berechne die Kosten so:

```text
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate
```

Jede Referenz wird berechnet, einschließlich der ersten und des Ausgangsbildes für Ebenen. Für Generierung und Ebenen gelten dieselben Ausgabetarife. Beim Senden wird eine Ausgabe beziehungsweise die Ebenenobergrenze `max_images` plus Referenzen reserviert. Beim Abschluss zählen die eigenen Pixelabmessungen jedes zurückgegebenen Bildes; die ungenutzte Reservierung wird freigegeben. Die akzeptierte Aufgabe behält ihren Preisschnappschuss, auch wenn sich die Tarife während der Ausführung ändern. Fehlgeschlagene Aufgaben werden erstattet.

## Fehler und Wiederholungsverhalten [#fehler-und-wiederholungsverhalten]

Ungültige Parameter werden vor dem Senden abgelehnt. Unzureichendes Guthaben oder Schlüsselkontingent verhindert die Generierung. Authentifizierung und Eigentumsprüfung gelten sowohl beim Senden als auch beim Abfragen. Eine fehlgeschlagene Aufgabe liefert `status: "failed"` mit einem `error`-Objekt.

Wiederhole eine fehlgeschlagene Statusabfrage mit derselben Aufgaben-ID. **Wiederhole einen Generierungs-POST nicht automatisch**, auch nicht nach einem Timeout: Er könnte bereits akzeptiert worden sein. Solange der vorgelagerte Dienst normalen Fortschritt meldet, bleibt die Aufgabe ausstehend. Eine Aufgabe ohne normalen vorgelagerten Status oder erfolgreiche Auslieferung während drei aufeinanderfolgenden Stunden schlägt fehl und wird erstattet.

Die [Seedream 5.5 Anleitung](/de/blog/seedream-5-5-api-guide) zeigt eine Anwendungsschleife, die die Aufgaben-ID speichert und wieder aufnimmt.
