> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Seedream 5.5 Ebenenzerlegung > > 🚧 **Dieses Modell ist noch nicht verfügbar, bleiben Sie gespannt** - Seedream 5.5 Ebenenzerlegung (doubao-seedream-5.5-layerize) zerlegt ein Bild in ein Basisbild und mehrere unabhängige Ebenen - Geben Sie `1` Eingabebild an. `prompt` ist optional; ohne Prompt erkennt und trennt das Modell automatisch die wesentlichen Bildelemente - Mit `n` legen Sie die maximale Ausgabeanzahl fest; `model_params.text_recognition` aktiviert die Texterkennung - Asynchrone Verarbeitung: Mit der zurückgegebenen Aufgaben-ID können Sie den [Aufgabenstatus abfragen](/de/api-manual/task-management/get-task-detail) - Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend ### Ausgabe - `output_format` bestimmt das Format des Basisbilds. Unabhängige Ebenen werden immer als PNG mit Alphakanal ausgegeben - Jedes Bild in `result_data` enthält `z_index` (Stapelreihenfolge: Basisbild `0`, Ebenen aufsteigend ab `1`) und `background` (Basisbild `opaque`, Ebenen `transparent`). Ebenen enthalten außerdem `bounding_box` (`absolute` verwendet Pixelkoordinaten im Koordinatensystem des Basisbilds, `normalized` Werte von `0` bis `1000`), `name` und `description` - Schlägt eine Ebene fehl, schlägt die gesamte Aufgabe fehl und der Betrag wird vollständig erstattet. Teilergebnisse werden nicht zurückgegeben ### Abrechnung - Das Basisbild und jede Ebene werden einzeln berechnet. Das Eingabebild wird separat berechnet - Beim Erstellen der Aufgabe werden Credits für `1` Eingabebild und bis zu `n` Ausgabebilder reserviert. Nach Abschluss wird anhand der tatsächlichen Ausgabeanzahl abgerechnet; ungenutzte Credits werden automatisch zurückgegeben ## OpenAPI ````yaml de/api-manual/image-series/seedream-5.5/seedream-5.5-layerize-image-generate.json POST /v1/images/generations openapi: 3.1.0 info: title: doubao-seedream-5.5-layerize Schnittstelle description: >- Mit dem Seedream 5.5 Ebenen-Modell ein Bild in ein Basisbild und mehrere bearbeitbare Ebenen zerlegen license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Bildgenerierung description: APIs zur KI-Bildgenerierung paths: /v1/images/generations: post: tags: - Bildgenerierung summary: doubao-seedream-5.5-layerize Schnittstelle description: >- > 🚧 **Dieses Modell ist noch nicht verfügbar, bleiben Sie gespannt** - Seedream 5.5 Ebenenzerlegung (doubao-seedream-5.5-layerize) zerlegt ein Bild in ein Basisbild und mehrere unabhängige Ebenen - Geben Sie `1` Eingabebild an. `prompt` ist optional; ohne Prompt erkennt und trennt das Modell automatisch die wesentlichen Bildelemente - Mit `n` legen Sie die maximale Ausgabeanzahl fest; `model_params.text_recognition` aktiviert die Texterkennung - Asynchrone Verarbeitung: Mit der zurückgegebenen Aufgaben-ID können Sie den [Aufgabenstatus abfragen](/de/api-manual/task-management/get-task-detail) - Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend ### Ausgabe - `output_format` bestimmt das Format des Basisbilds. Unabhängige Ebenen werden immer als PNG mit Alphakanal ausgegeben - Jedes Bild in `result_data` enthält `z_index` (Stapelreihenfolge: Basisbild `0`, Ebenen aufsteigend ab `1`) und `background` (Basisbild `opaque`, Ebenen `transparent`). Ebenen enthalten außerdem `bounding_box` (`absolute` verwendet Pixelkoordinaten im Koordinatensystem des Basisbilds, `normalized` Werte von `0` bis `1000`), `name` und `description` - Schlägt eine Ebene fehl, schlägt die gesamte Aufgabe fehl und der Betrag wird vollständig erstattet. Teilergebnisse werden nicht zurückgegeben ### Abrechnung - Das Basisbild und jede Ebene werden einzeln berechnet. Das Eingabebild wird separat berechnet - Beim Erstellen der Aufgabe werden Credits für `1` Eingabebild und bis zu `n` Ausgabebilder reserviert. Nach Abschluss wird anhand der tatsächlichen Ausgabeanzahl abgerechnet; ungenutzte Credits werden automatisch zurückgegeben operationId: createSeedreamLayerizeImageGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: auto_layerize: summary: Automatische Zerlegung (ohne prompt) mit Texterkennung value: model: doubao-seedream-5.5-layerize image_urls: - https://example.com/poster.png quality: auto output_format: png 'n': 30 model_params: text_recognition: true prompt_layerize: summary: Elemente in natürlicher Sprache angeben value: model: doubao-seedream-5.5-layerize prompt: Den Papagei und den Titeltext herauslösen image_urls: - https://example.com/poster.png quality: 2K bbox_layerize: summary: Mit bbox-Koordinaten angeben value: model: doubao-seedream-5.5-layerize prompt: >- Titeltext179 58 809 197, 1 Papagei330 274 641 991 image_urls: - https://example.com/poster.png quality: 1.5K responses: '200': description: Bildgenerierungsaufgabe erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Nicht autorisiert, ungültiges oder abgelaufenes Token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Kontingent, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Zugriff verweigert content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: doubao-seedream-5.5-layerize type: invalid_request_error '429': description: Ratenlimit überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: ImageGenerationRequest: type: object required: - model - image_urls properties: model: type: string description: Modellname für Bildgenerierung enum: - doubao-seedream-5.5-layerize default: doubao-seedream-5.5-layerize example: doubao-seedream-5.5-layerize image_urls: type: array description: >- URL des zu zerlegenden Bildes (erforderlich) **Hinweis:** - **Es wird genau `1` Bild benötigt**; fehlt es oder werden `2` oder mehr übergeben, wird ein Fehler zurückgegeben - Unterstützte Formate: `.png`, `.jpeg`, `.jpg` (strenger als bei einfacher Generierung – webp und andere werden abgelehnt) - Bildgröße: nicht mehr als `30MB` - Gesamtpixel: `[262144, 6000×6000]`, also mindestens `512×512` (höhere Untergrenze als bei einfacher Generierung) - Seitenverhältnis (Breite/Höhe): `[1/16, 16]` - Die Bild-URL muss vom Server direkt aufrufbar sein oder beim Zugriff einen direkten Download auslösen (solche URLs enden in der Regel auf eine Bilddateiendung wie `.png` oder `.jpg`) - Das Eingabebild wird separat berechnet items: type: string format: uri minItems: 1 maxItems: 1 example: - https://example.com/poster.png prompt: type: string description: >- Welche Elemente herausgelöst werden sollen (optional) **Drei Verwendungsarten:** - **Weglassen**: Das Modell erkennt alle wesentlichen Elemente im Bild und zerlegt sie einzeln - **Natürliche Sprache**: z. B. `Den Papagei und den Titeltext herauslösen` – die Elemente werden semantisch erkannt und in Ebenen aufgeteilt - **Exakte Koordinaten**: mit ``-Tags die Position angeben, z. B. `Titeltext179 58 809 197`; normalisierte Koordinaten (`0`~`1000`) werden empfohlen example: Den Papagei und den Titeltext herauslösen 'n': type: integer description: >- Maximale Anzahl der Ausgabebilder einschließlich Basisbild. Standardwert ist `30`. **Hinweise:** - Wertebereich: `2` bis `100`. Werte außerhalb dieses Bereichs führen zu `400` ohne Berechnung - Bei Erreichen der Grenze endet die Zerlegung; weitere Elemente können zusammengeführt oder ausgelassen werden. Ein höherer Wert ermöglicht eine feinere Trennung - Ein höheres `n` reserviert mehr Credits. Nach Abschluss wird anhand der tatsächlichen Ausgabeanzahl abgerechnet; ungenutzte Credits werden automatisch zurückgegeben minimum: 2 maximum: 100 default: 30 example: 30 quality: type: string description: >- Ausgabeauflösung. Standardwert ist `auto`. **Optionen:** `auto`, `1K`, `1.5K`, `2K` **Hinweise:** - Es werden nur die oben genannten Auflösungsoptionen unterstützt. Ein Seitenverhältnis (z. B. `16:9`) oder Pixelmaße (z. B. `2048x2048`) führen zu einem Fehler - `auto` richtet die Ausgabe nach dem Eingabebild: Liegt die Originalgröße im Bereich `[921600, 4624220]` Pixel, wird sie beibehalten; unter 1K wird mit 1K, über 2K mit 2K ausgegeben - Jede Ebene behält ihr eigenes Seitenverhältnis aus dem Originalbild, das Basisbild behält das Seitenverhältnis des Eingabebilds enum: - auto - 1K - 1.5K - 2K default: auto example: auto prompt_priority: type: string description: >- Modus zur Prompt-Optimierung. Unterstützt wird ausschließlich `standard` als Standardwert. Die Übergabe von `fast` führt zu `400` ohne Berechnung. enum: - standard default: standard example: standard output_format: type: string description: >- Ausgabebildformat **Optionen:** - `png`: PNG-Format (Standard) - `jpeg`: JPEG-Format **Hinweis:** Dieser Parameter **steuert nur das Basisbild**. Die Ebenen sind immer PNG mit Alphakanal und davon nicht betroffen. enum: - png - jpeg default: png example: png model_params: type: object description: >- Zusätzliche Optionen für die Ebenenzerlegung. Nur `text_recognition` ist zulässig; andere Schlüssel führen zu `400`. properties: text_recognition: type: boolean description: >- Texterkennung für Textebenen aktivieren - `false`: Ebenen enthalten nur `name`, `description` und `bounding_box` (Standard) - `true`: Ebenen mit regulärem Text enthalten zusätzlich `text_recognition`: den vollständigen `text` (mehrere Zeilen mit `\n` verbunden, zuerst von oben nach unten, dann von links nach rechts), die `bounding_box` jeder Zeile sowie `text` und `style` jedes Textsegments (`similar_font_family` für eine ähnliche Schriftart, `foreground_color` für die Textfarbe und die Stilmerkmale `bold` / `italic` / `underline` / `strikethrough` / `shadow` / `translucent`) Künstlerische, handschriftliche und dekorative Textebenen liefern kein `text_recognition`. default: false example: true callback_url: type: string description: >- HTTPS-Callback-Adresse nach Aufgabenabschluss **Callback-Zeitpunkt:** - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde - Wird nach Abschluss der Abrechnungsbestätigung gesendet **Sicherheitsbeschränkungen:** - Nur HTTPS-Protokoll wird unterstützt - Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.) - URL-Länge darf `2048` Zeichen nicht überschreiten **Callback-Mechanismus:** - Timeout: `10` Sekunden - Maximal `3` Wiederholungsversuche bei Fehler (Wiederholung nach `1` Sekunde/`2` Sekunden/`4` Sekunden) - Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API - Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1757165031 id: type: string description: Aufgaben-ID example: task-unified-1793612934-seedream55layerize model: type: string description: Tatsächlich verwendeter Modellname example: doubao-seedream-5.5-layerize object: type: string enum: - image.generation.task description: Spezifischer Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/TaskInfo' description: Asynchrone Aufgabeninformationen type: type: string enum: - text - image - audio - video description: Aufgaben-Ausgabetyp example: image usage: $ref: '#/components/schemas/Usage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Bezeichner message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp TaskInfo: type: object properties: can_cancel: type: boolean description: Ob die Aufgabe abgebrochen werden kann example: true estimated_time: type: integer description: Geschätzte Abschlusszeit (Sekunden) minimum: 0 example: 150 Usage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_image - per_token - per_second example: per_image credits_reserved: type: number description: Geschätzter Guthabenverbrauch minimum: 0 example: 55.624 user_group: type: string description: Benutzergruppenkategorie example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle APIs erfordern Bearer-Token-Authentifizierung## **API-Schlüssel erhalten:** Besuchen Sie die [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Zum Anfrage-Header hinzufügen:** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.