curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612934-seedream55layerize",
  "model": "doubao-seedream-5.5-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 150
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 55.624,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.5-layerize",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedream 5.5

Seedream 5.5 Ebenenzerlegung

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
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

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612934-seedream55layerize",
  "model": "doubao-seedream-5.5-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 150
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 55.624,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.5-layerize",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:doubao-seedream-5.5-layerize

erforderlich

Modellname für Bildgenerierung

Verfügbare Optionen:

doubao-seedream-5.5-layerize

Beispiel:

"doubao-seedream-5.5-layerize"

image_urls

string<uri>[]

erforderlich

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

Required array length: 1 element

Beispiel:

["https://example.com/poster.png"]

prompt

string

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 <bbox>-Tags die Position angeben, z. B. Titeltext<bbox>179 58 809 197</bbox>; normalisierte Koordinaten (0~1000) werden empfohlen

Beispiel:

"Den Papagei und den Titeltext herauslösen"

integer

Standard:30

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

Erforderlicher Bereich: 2 <= x <= 100

Beispiel:

30

quality

enum<string>

Standard:auto

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

Verfügbare Optionen:

auto,

1K,

1.5K,

2K

Beispiel:

"auto"

prompt_priority

enum<string>

Standard:standard

Modus zur Prompt-Optimierung. Unterstützt wird ausschließlich standard als Standardwert.

Die Übergabe von fast führt zu 400 ohne Berechnung.

Verfügbare Optionen:

standard

Beispiel:

"standard"

output_format

enum<string>

Standard:png

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.

Verfügbare Optionen:

png,

jpeg

Beispiel:

"png"

model_params

object

Zusätzliche Optionen für die Ebenenzerlegung. Nur text_recognition ist zulässig; andere Schlüssel führen zu 400.

Show child attributes

callback_url

string<uri>

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

Beispiel:

"https://your-domain.com/webhooks/image-task-completed"

Antwort

Bildgenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757165031

string

Aufgaben-ID

Beispiel:

"task-unified-1793612934-seedream55layerize"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"doubao-seedream-5.5-layerize"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

image.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Asynchrone Aufgabeninformationen

Show child attributes

type

enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"image"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Seedream 5.5 Ebenenzerlegung

Ausgabe

Abrechnung

Autorisierungen

Body

Antwort