# Seedream 5.0 Pro (https://wanapi.app/de/docs/seedream-5-0-pro)
Seedream 5.0 Pro generiert ein Bild aus einem Prompt, bearbeitet oder kombiniert bis zu 10 Referenzbilder und zerlegt ein Bild in ein Basisbild mit bis zu 16 transparenten Ebenen. Die Ausgabe erfolgt in 1K, 1.5K, 2K oder exakten Pixelmaßen. [Modelldetails und Playground](/de/models/seedream-5-0-pro).
## Verbindung zu Wan API herstellen [#verbindung-zu-wan-api-herstellen]
Verwende `https://api.wanapi.app` als API-Basis-URL. Erstelle in den [API-Schlüsseleinstellungen](/de/settings/apikeys) einen Schlüssel mit der Modellfamilie **Wan** und sende ihn als `Authorization: Bearer YOUR_API_KEY`. Bewahre Schlüssel auf deinem Server auf. Der Playground nutzt deine Website-Sitzung und belastet dasselbe Kontoguthaben.
`GET /v1/models` listet die für deinen Schlüssel verfügbaren Modelle auf. Seedream 5.0 Pro nutzt die OpenAI Images API: `POST /v1/images/generations` mit JSON oder `POST /v1/images/edits` mit JSON oder Multipart-Uploads. Die Anfrage liefert ihre Antwort, sobald das Bild fertig ist; es gibt keine Aufgabe, deren Status du abfragen musst.
| Einstellung | Seedream 5.0 Pro |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Modell-ID | `bytedance/seedream-5.0-pro` |
| `size` | `1K`, `1.5K`, `2K` (Standard) oder `WIDTHxHEIGHT` mit 921.600–4.624.220 Pixeln und einem Seitenverhältnis von 1:16 bis 16:1. |
| `image` | Bis zu 10 Referenzbilder. |
| Ausgabe | Ein Bild pro Anfrage oder ein Basisbild mit bis zu 16 Ebenen bei `layer_decomposition`. |
## Ein Bild generieren [#ein-bild-generieren]
Setze `WAN_API_KEY` auf deinem Server auf deinen Schlüssel. Sende die Anfrage einmal; die Generierung ist normalerweise innerhalb einer Minute abgeschlossen. Setze daher das Zeitlimit des Clients auf mindestens vier Minuten.
```bash
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'
```
Die Antwort folgt dem OpenAI Images-Format. Die Beispielwerte dienen der Veranschaulichung:
```json
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}
```
Bild-URLs bleiben 30 Tage lang verfügbar. Speichere die Dateien selbst, wenn du sie länger benötigst. Sende `"response_format": "b64_json"`, um jedes Bild zusätzlich als Base64 in `b64_json` zu erhalten.
## Seedream 5.0 Pro: Preise [#seedream-50-pro-preise]
Jedes generierte Bild wird nach seiner Pixelgröße pro Bild abgerechnet, zu einem Preis von 30 % unter dem offiziellen Tarif: Bis zu 2,61 Millionen Pixel (1K und 1.5K) gilt der niedrigere Tarif, für größere Bilder der höhere. Das erste Referenzbild ist kostenlos; für jedes weitere Referenzbild kommt der Referenztarif hinzu. Eine Anfrage, die vor der Generierung eines Bildes abgelehnt wird, wird nicht berechnet.
Bei der Ebenenzerlegung werden das Basisbild und jede zurückgegebene Ebene berechnet. Hat jedes zurückgegebene Bild höchstens 2,61 Millionen Pixel, kostet jedes 30 % weniger als zum offiziellen Ebenentarif. Ist eines der zurückgegebenen Bilder größer, was bei `2K` immer der Fall ist, wird jedes Bild zum offiziellen Ebenentarif für seine jeweilige Größe abgerechnet. Dein Guthaben muss das Maximum von 17 Bildern abdecken; du zahlst nur für die zurückgegebenen Bilder.
## Anfragefelder [#anfragefelder]
Sende ein JSON-Objekt. `model` ist erforderlich; `prompt` ist erforderlich, außer wenn `layer_decomposition` auf `true` gesetzt ist. Unbekannte Felder werden abgelehnt.
| Feld | Typ | Vorgaben |
| ------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `model` | string | Erforderlich: `bytedance/seedream-5.0-pro`. |
| `prompt` | string | Was generiert werden soll oder welche Elemente bei der Ebenenzerlegung getrennt werden sollen. Unterstützt Englisch, Chinesisch und weitere Sprachen; die besten Ergebnisse erzielst du mit weniger als etwa 600 englischen Wörtern. |
| `image` | string oder string\[] | Bis zu 10 Referenzbilder als HTTP(S)-URLs oder `data:image/;base64,...` mit kleingeschriebener Formatangabe. Formate: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF; jeweils bis zu 30 MB; Seitenverhältnis 1:16 bis 16:1. |
| `size` | string | Bildgenerierung: `1K`, `1.5K`, `2K` (Standard) oder `WIDTHxHEIGHT`. Ebenenzerlegung: `1K`, `1.5K`, `2K` oder `auto` (Standard). |
| `layer_decomposition` | boolean | Standard `false`. `true` zerlegt genau ein PNG- oder JPEG-Bild in ein Basisbild und bis zu 16 Ebenen. |
| `optimize_prompt_options` | object | `{"mode": "standard"}` (Standard) oder `{"mode": "fast"}`. Der schnelle Modus verkürzt die Generierungszeit bei etwas geringerer Qualität. |
| `output_format` | string | `jpeg` (Standard) oder `png`. Bei der Ebenenzerlegung legt es das Format des Basisbildes fest; Ebenen sind immer PNG. |
| `background` | string | `opaque` (Standard) oder `transparent`. Transparent benötigt genau ein Eingabebild mit Alphakanal und eine PNG-Ausgabe; es kann nicht mit Ebenenzerlegung kombiniert werden. |
| `watermark` | boolean | Standard `true`: Fügt eine kleine Kennzeichnung als KI-generiert hinzu. Sende `false`, um sie zu entfernen. |
| `nsfw_checker` | boolean | Standard `true` lässt die Inhaltsprüfung aktiviert. `false` sendet die Anfrage ohne diese Prüfung; der Preis bleibt gleich. |
| `response_format` | string | `url` (Standard) oder `b64_json`. |
| `n` | integer | Optional; muss `1` sein. |
`stream`, `sequential_image_generation`, `tools`, `seed`, `guidance_scale` und `mask` werden von diesem Modell nicht unterstützt und abgelehnt.
## Referenzbilder bearbeiten und kombinieren [#referenzbilder-bearbeiten-und-kombinieren]
Übergib ein Bild mit einer Bearbeitungsanweisung oder mehrere Bilder zum Kombinieren:
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}
```
`POST /v1/images/edits` akzeptiert dieselben Felder. Lade bei Multipart Dateien in den Feldern `image` oder `image[]` hoch und sende `optimize_prompt_options` als JSON-String.
## Ebenenzerlegung [#ebenenzerlegung]
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "2K"
}
```
Die Antwort führt das Basisbild zuerst auf. Jede Ebene ergänzt ihre Stapelreihenfolge, Position und Beschreibung:
```json
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}
```
Schlägt eine Ebene fehl, schlägt die gesamte Anfrage fehl. Fordert der Prompt mehr Ebenen als das Limit an, können einzelne Ebeneninhalte entfallen.
## Fehler [#fehler]
Fehler verwenden das OpenAI-Fehlerformat `{"error": {"message", "type", "code"}}`.
| HTTP | `code` | Bedeutung |
| ---- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| 400 | `invalid_request` oder eine Validierungsmeldung | Ein Feld oder eine Kombination wird nicht unterstützt. Korrigiere die Anfrage; es wurde nichts berechnet. |
| 400 | `content_policy_violation` | Der Prompt, ein Eingabebild oder die Ausgabe wurde aufgrund der Inhaltsrichtlinie abgelehnt. Es wurde nichts berechnet. |
| 402 | insufficient quota | Lade vor dem erneuten Senden Guthaben auf. |
| 429 | `rate_limited` | Zu viele Anfragen. Versuche es später erneut. |
| 502 | `submission_unknown` | Das Ergebnis wurde nicht empfangen und die Anfrage wurde nicht berechnet. Prüfe deine Nutzungsprotokolle, bevor du sie erneut sendest. |
| 503 | `upstream_unavailable` | Die Bildgenerierung ist vorübergehend nicht verfügbar; die Anfrage wurde nicht berechnet. |
Wiederhole eine Anfrage nach einer Zeitüberschreitung niemals automatisch, ohne zuerst deine Nutzungsprotokolle zu prüfen.