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 separación en capas

Seedream 5.5 Descomposición en capas (doubao-seedream-5.5-layerize) separa una imagen en una imagen base y varias capas independientes
Proporciona 1 imagen de entrada. prompt es opcional; si se omite, el modelo identifica y separa automáticamente los elementos principales
Usa n para limitar el número de imágenes de salida y model_params.text_recognition para activar el reconocimiento de texto
Procesamiento asíncrono: usa el ID de tarea devuelto para consultar su estado
Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente

Detalles de salida

output_format determina el formato de la imagen base. Las capas independientes siempre son PNG con canal alfa
Cada imagen de result_data incluye z_index (orden de apilado: 0 para la imagen base, desde 1 para las capas) y background (opaque para la imagen base, transparent para las capas). Las capas también incluyen bounding_box (absolute usa coordenadas de píxel del sistema de la imagen base; normalized va de 0 a 1000), name y description
Si falla una capa, falla toda la tarea y se reembolsa el importe completo. No se devuelven resultados parciales

Facturación

La imagen base y cada capa se cobran individualmente. La imagen de entrada se cobra por separado
Al crear la tarea se reservan créditos para 1 imagen de entrada y hasta n imágenes de salida. Al finalizar, se liquida el importe según el número real de imágenes de salida y los créditos no utilizados se devuelven automáticamente

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

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:doubao-seedream-5.5-layerize

requerido

Nombre del modelo de generación de imágenes

Opciones disponibles:

doubao-seedream-5.5-layerize

Ejemplo:

"doubao-seedream-5.5-layerize"

image_urls

string<uri>[]

requerido

URL de la imagen que se va a separar (obligatorio)

Nota:

Se requiere exactamente 1 imagen; omitirla o enviar 2 o más devuelve un error
Formatos admitidos: .png, .jpeg, .jpg (más estricto que la generación normal: webp y otros se rechazan)
Tamaño de imagen: no más de 30MB
Total de píxeles: [262144, 6000×6000], es decir, al menos 512×512 (límite inferior más alto que en la generación normal)
Relación de aspecto (ancho/alto): [1/16, 16]
La URL de la imagen debe ser directamente visible por el servidor, o debe activar la descarga directa al acceder (normalmente estas URLs terminan con una extensión de archivo de imagen, como .png o .jpg)
La imagen de entrada se cobra por separado

Required array length: 1 element

Ejemplo:

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

prompt

string

Qué elementos separar (opcional)

Tres formas de usarlo:

Omitirlo: el modelo detecta todos los elementos principales de la imagen y los separa uno a uno
Lenguaje natural: p. ej. Separa el loro y el texto del título; los elementos se identifican semánticamente y se convierten en capas
Coordenadas exactas: usa etiquetas <bbox> para fijar la posición, p. ej. texto del título<bbox>179 58 809 197</bbox>; se recomiendan coordenadas normalizadas (0~1000)

Ejemplo:

"Separa el loro y el texto del título"

integer

predeterminado:30

Número máximo de imágenes de salida, incluida la imagen base. El valor predeterminado es 30.

Detalles:

Rango permitido: de 2 a 100. Los valores fuera del rango devuelven 400 sin cargo
La descomposición termina al alcanzar el límite; los elementos restantes pueden fusionarse u omitirse. Un valor mayor permite una separación más detallada
Un valor de n mayor reserva más créditos. Al finalizar, se liquida el importe según el número real de imágenes de salida y los créditos no utilizados se devuelven automáticamente

Rango requerido: 2 <= x <= 100

Ejemplo:

30

quality

enum<string>

predeterminado:auto

Resolución de salida. El valor predeterminado es auto.

Opciones: auto, 1K, 1.5K, 2K

Notas:

Solo se admiten las opciones de resolución indicadas. Enviar una proporción (como 16:9) o dimensiones en píxeles (como 2048x2048) devuelve un error
auto hace que la salida siga a la imagen de entrada: si el tamaño original está dentro de [921600, 4624220] píxeles se mantiene tal cual; por debajo de 1K se emite en 1K y por encima de 2K en 2K
Cada capa conserva su propia proporción de la imagen original y la imagen base conserva la proporción de la entrada

Opciones disponibles:

auto,

1K,

1.5K,

2K

Ejemplo:

"auto"

prompt_priority

enum<string>

predeterminado:standard

Modo de optimización del prompt. Solo se admite standard, que es el valor predeterminado.

Enviar fast devuelve 400 sin cargo.

Opciones disponibles:

standard

Ejemplo:

"standard"

output_format

enum<string>

predeterminado:png

Formato de la imagen de salida

Opciones:

png: Formato PNG (predeterminado)
jpeg: Formato JPEG

Nota: este parámetro solo controla la imagen base. Las capas siempre son PNG con canal alfa y no se ven afectadas.

Opciones disponibles:

png,

jpeg

Ejemplo:

"png"

model_params

object

Opciones adicionales para la separación en capas. Solo se acepta text_recognition; otras claves devuelven 400.

Show child attributes

callback_url

string<uri>

Dirección de callback HTTPS después de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa, falla o se cancela
Se envía después de completar la confirmación de facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
El callback a direcciones IP internas está prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Máximo 3 reintentos en caso de fallo (reintentos después de 1 segundo/2 segundos/4 segundos)
El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos

Ejemplo:

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

Respuesta

Tarea de generación de imagen creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757165031

string

ID de tarea

Ejemplo:

"task-unified-1793612934-seedream55layerize"

model

string

Nombre del modelo real utilizado

Ejemplo:

"doubao-seedream-5.5-layerize"

object

enum<string>

Tipo de tarea específico

Opciones disponibles:

image.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información de tarea asíncrona

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"image"

usage

object

Información de uso y facturación

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Seedream 5.5 separación en capas

Detalles de salida

Facturación

Autorizaciones

Cuerpo

Respuesta