> ## 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.0 Pro Ebenenzerlegung
> - Seedream 5.0 Pro Ebenenzerlegung (doubao-seedream-5.0-pro-layerize) zerlegt ein Bild in ein Basisbild und mehrere eigenständige Ebenen; jede Ebene ist ein PNG mit Alphakanal, das Format des Basisbilds richtet sich nach `output_format`
- Es wird **genau ein** Eingabebild benötigt; `prompt` ist optional – ohne Prompt erkennt das Modell automatisch alle wesentlichen Elemente im Bild und zerlegt sie einzeln
- Die Anzahl der Ausgabebilder ergibt sich aus dem Zerlegungsergebnis (`1` ~ `17`) und lässt sich nicht über Anfrageparameter steuern; schlägt eine Ebene fehl, schlägt die gesamte Anfrage fehl – Teilerfolge gibt es nicht, und eine fehlgeschlagene Anfrage wird vollständig erstattet
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur [Abfrage](/de/api-manual/task-management/get-task-detail). In den Aufgabendetails enthält jeder Eintrag in `result_data` ein `z_index` (Stapelreihenfolge: `0` für das Basisbild, ab `1` aufsteigend für Ebenen); Ebenen enthalten zusätzlich `bounding_box` (`absolute` in Pixelkoordinaten des Basisbilds, `normalized` im Bereich `0`~`1000`), `name` und `description`
- Dieses Modell braucht länger als eine einfache Generierung: etwa `120` Sekunden
- Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend
## OpenAPI
````yaml de/api-manual/image-series/seedream/seedream-5.0-pro-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
title: doubao-seedream-5.0-pro-layerize Schnittstelle
description: >-
Mit dem Seedream 5.0 Pro 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.0-pro-layerize Schnittstelle
description: >-
- Seedream 5.0 Pro Ebenenzerlegung (doubao-seedream-5.0-pro-layerize)
zerlegt ein Bild in ein Basisbild und mehrere eigenständige Ebenen; jede
Ebene ist ein PNG mit Alphakanal, das Format des Basisbilds richtet sich
nach `output_format`
- Es wird **genau ein** Eingabebild benötigt; `prompt` ist optional –
ohne Prompt erkennt das Modell automatisch alle wesentlichen Elemente im
Bild und zerlegt sie einzeln
- Die Anzahl der Ausgabebilder ergibt sich aus dem Zerlegungsergebnis
(`1` ~ `17`) und lässt sich nicht über Anfrageparameter steuern; schlägt
eine Ebene fehl, schlägt die gesamte Anfrage fehl – Teilerfolge gibt es
nicht, und eine fehlgeschlagene Anfrage wird vollständig erstattet
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene
Aufgaben-ID zur
[Abfrage](/de/api-manual/task-management/get-task-detail). In den
Aufgabendetails enthält jeder Eintrag in `result_data` ein `z_index`
(Stapelreihenfolge: `0` für das Basisbild, ab `1` aufsteigend für
Ebenen); Ebenen enthalten zusätzlich `bounding_box` (`absolute` in
Pixelkoordinaten des Basisbilds, `normalized` im Bereich `0`~`1000`),
`name` und `description`
- Dieses Modell braucht länger als eine einfache Generierung: etwa `120`
Sekunden
- Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese
umgehend
operationId: createSeedreamLayerizeImageGeneration
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationRequest'
examples:
auto_layerize:
summary: Automatische Zerlegung (ohne Prompt)
value:
model: doubao-seedream-5.0-pro-layerize
image_urls:
- https://example.com/poster.png
quality: auto
output_format: jpeg
prompt_layerize:
summary: Elemente in natürlicher Sprache angeben
value:
model: doubao-seedream-5.0-pro-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.0-pro-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.0-pro-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.0-pro-layerize
default: doubao-seedream-5.0-pro-layerize
example: doubao-seedream-5.0-pro-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`)
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
quality:
type: string
description: >-
Ausgabestufe, Standardwert `auto`
**Optionen:** `auto`, `1K`, `1.5K`, `2K`
**Hinweise:**
- Der Ebenenmodus **akzeptiert nur Stufen**; ein Seitenverhältnis
(z. B. `16:9`) oder explizite Pixel (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
**Abrechnung:** Die Stufe wird je Ausgabebild anhand seiner eigenen
Pixelzahl bestimmt; `1K` und `1.5K` kosten gleich viel, ein
Ausgabebild über `2610000` Pixel wird zur höheren Stufe abgerechnet.
enum:
- auto
- 1K
- 1.5K
- 2K
default: auto
example: auto
prompt_priority:
type: string
description: >-
Prompt-Optimierungsstrategie, zur Einstellung des Modus für die
Prompt-Optimierung
**Optionen:**
- `standard`: Standardmodus, höhere Ausgabequalität, längere
Verarbeitungszeit
- `fast`: Schnellmodus, kürzere Verarbeitungszeit, etwas geringere
Qualität als der Standardmodus
enum:
- standard
- fast
default: standard
example: standard
output_format:
type: string
description: >-
Ausgabebildformat
**Optionen:**
- `jpeg`: JPEG-Format (Standard)
- `png`: PNG-Format
**Hinweis:** Dieser Parameter **steuert nur das Basisbild**. Die
Ebenen sind immer PNG mit Alphakanal und davon nicht betroffen.
enum:
- jpeg
- png
default: jpeg
example: jpeg
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-1757165031-seedream5prolayerize
model:
type: string
description: Tatsächlich verwendeter Modellname
example: doubao-seedream-5.0-pro-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: 120
Usage:
type: object
description: Nutzungs- und Abrechnungsinformationen
properties:
billing_rule:
type: string
description: Abrechnungsregel
enum:
- per_call
- per_token
- per_second
example: per_call
credits_reserved:
type: number
description: Geschätzter Guthabenverbrauch
minimum: 0
example: 39.168
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
```
````