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.0-pro-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5prolayerize",
  "model": "doubao-seedream-5.0-pro-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 39.168,
    "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.0-pro-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

Seedream 5.0 Pro separación en capas

Seedream 5.0 Pro separación en capas (doubao-seedream-5.0-pro-layerize) divide una imagen en una imagen base y varias capas independientes; cada capa es un PNG con canal alfa, mientras que el formato de la imagen base sigue a output_format
Se requiere exactamente una imagen de entrada; prompt es opcional: si se omite, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa uno a uno
El número de imágenes de salida lo determina el resultado de la separación (1 ~ 17) y no se puede controlar con parámetros de la solicitud; si falla cualquier capa, falla toda la solicitud: no hay éxito parcial y la solicitud fallida se reembolsa por completo
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar. En el detalle de la tarea, cada elemento de result_data incluye z_index (orden de apilado: 0 para la imagen base y desde 1 en adelante para las capas); las capas incluyen además bounding_box (absolute en coordenadas de píxel de la imagen base y normalized en el rango 0~1000), name y description
Este modelo tarda más que una generación normal: unos 120 segundos
Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente

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.0-pro-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5prolayerize",
  "model": "doubao-seedream-5.0-pro-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 39.168,
    "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.0-pro-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.0-pro-layerize

requerido

Nombre del modelo de generación de imágenes

Opciones disponibles:

doubao-seedream-5.0-pro-layerize

Ejemplo:

"doubao-seedream-5.0-pro-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)

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"

quality

enum<string>

predeterminado:auto

Nivel de resolución de salida, valor predeterminado auto

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

Notas:

El modo de capas solo acepta niveles; enviar una proporción (como 16:9) o píxeles explícitos (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

Facturación: el nivel se determina por imagen de salida según su propio número de píxeles; 1K y 1.5K cuestan lo mismo, y una imagen de salida con más de 2610000 píxeles se factura al nivel alto.

Opciones disponibles:

auto,

1K,

1.5K,

2K

Ejemplo:

"auto"

prompt_priority

enum<string>

predeterminado:standard

Estrategia de optimización de prompt, utilizada para configurar el modo de optimización de prompt

Opciones:

standard: Modo estándar, salida de mayor calidad, mayor tiempo de procesamiento
fast: Modo rápido, menor tiempo de procesamiento, calidad ligeramente inferior al modo estándar

Opciones disponibles:

standard,

fast

Ejemplo:

"standard"

output_format

enum<string>

predeterminado:jpeg

Formato de la imagen de salida

Opciones:

jpeg: formato JPEG (predeterminado)
png: formato PNG

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

Opciones disponibles:

jpeg,

png

Ejemplo:

"jpeg"

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-1757165031-seedream5prolayerize"

model

string

Nombre del modelo real utilizado

Ejemplo:

"doubao-seedream-5.0-pro-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.0 Pro separación en capas

Autorizaciones

Cuerpo

Respuesta