Introducción
Seedream 5.0 Pro Layer Decomposition divide una imagen terminada en una imagen base y hasta dieciséis capas PNG transparentes. Cada capa viene con un cuadro de posición y un nombre, así que puedes reconstruir la composición original o reorganizarla en un lienzo.
Desarrollado por ByteDance (ID de modelo dola-seedream-5-0-pro-260628). Úsalo cuando las capas deban volver exactamente a su sitio.
Elige un modo según tu material de partida
| Material de partida | Modo |
|---|---|
| Una imagen terminada cuyas partes necesitas por separado | Seedream 5.0 Pro Separación en capas |
| Una dirección de arte o un brief de diseño por escrito | Seedream 5.0 Pro Texto a imagen |
| Una imagen fuente aprobada que quieres revisar | Seedream 5.0 Pro Edición de imagen |
| La misma separación, también con nombres y cuadros de posición, a menor precio por imagen | Seedream 5.0 Flash Separación en capas |
Pro o Flash para las capas
Ambos niveles devuelven boundingBox y name para cada capa. En el mismo póster de cine, ejecutado sin prompt, Pro devolvió nueve imágenes y Flash ocho. Las diferencias son el precio y un límite de contenido. Pro cuesta $0.042 por imagen de salida en 1K y 1.5K y $0.084 en 2K; Flash cuesta $0.026 en cualquier nivel. Pro rechaza las imágenes de origen de nivel Muy fuerte, mientras que Flash dividió el mismo tipo de imagen en sus figuras. Ninguno fue más rápido de forma constante en nuestras pruebas.
Funciones y aspectos destacados
Cuadros de posición y nombres
Cada capa devuelve boundingBox como [x1, y1, x2, y2] en píxeles de la imagen base y un name como “Woman in red trench coat”. En nuestra prueba con el póster, al apilar las capas en sus cuadros se reprodujo el póster original. El PNG de una capa suele ser mayor que el cuadro que ocupa (un cuadro de 671 por 139 vino con un PNG de 1233 por 256), así que escálalo dentro del cuadro al colocarlo de nuevo.
Imagen base limpia
Los elementos separados se quitan y el fondo se completa. Al dividir el anuncio de perfume quedó una superficie de mármol negro vacía donde estaban el frasco, la cinta y las letras.
Guíalo con palabras o con coordenadas
Nombra los elementos o fíjalos con coordenadas <bbox>. Sin prompt, el modelo elige por su cuenta los elementos principales.
Capas PNG transparentes
Las capas son siempre PNG transparentes, elijas el output_format que elijas. Ese ajuste solo cambia la imagen base.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | Una imagen para dividir: png, jpeg, webp, bmp, tiff o gif, de hasta 30 MB, de 262144 a 36000000 de píxeles en total, con relación de aspecto entre 1:16 y 16:1. mínimo 1 caracteres |
prompt | No | Opcional, de cualquier longitud. Déjalo vacío y el modelo elige por su cuenta los elementos principales; nombra elementos y separará esos. mínimo 1 caracteres · máximo 5000 caracteres |
resolution | No | auto, 1k, 1.5k o 2k. La imagen base conserva la relación de aspecto de la entrada y cada capa conserva las proporciones de su elemento. |
output_format | No | jpeg o png solo para la imagen base. Las capas son siempre PNG transparentes, elijas lo que elijas. |
Precios
| Especificación | Precio |
|---|---|
| $0.042 / imagen |
| $0.042 / imagen |
| $0.084 / imagen |
| $0.084 / imagen |
Casos de uso
Cambiar las palabras de un póster
Saca la capa del título, reemplázala o dale otro estilo, y vuelve a apilar todo en los cuadros devueltos.
Cambiar el fondo de un producto
Extrae el producto y sus letras de un anuncio, conserva la imagen base o reemplázala, y recompón para una nueva campaña.
Crear recursos de parallax o animación
Convierte una ilustración en capas ordenadas con posiciones conocidas, listas para movimiento de profundidad o un rig.
Aislar a una persona de una escena
Pide solo a la persona y obtén una capa transparente más la escena sin ella.
Guía de prompts y consejos prácticos
Nombra las piezas que quieres
Para un póster, enuméralas con palabras sencillas: “Separate the diner building, the tagline, the LATE SHIFT title, the woman in the red trench coat and the ADMIT ONE ticket stub.” Esa ejecución devolvió seis imágenes: la imagen base y exactamente esas cinco capas.
Enmarca un elemento con un cuadro delimitador
Añade <bbox>x1 y1 x2 y2</bbox> después del nombre del elemento. Las coordenadas están normalizadas de 0 a 1000 desde la esquina superior izquierda, así que no dependen del tamaño en píxeles de la imagen.
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
Elige una resolución
1k y 1.5k cuestan lo mismo por imagen de salida; 2k y auto se cobran a la tarifa de 2K porque auto puede producir una salida en 2K. Usa 1k o 1.5k cuando solo necesites una separación de trabajo.
Cuenta con la reserva
Una solicitud reserva el costo de 17 imágenes y devuelve la diferencia cuando se conoce el número real de capas. Los resultados típicos son unas pocas imágenes.
Límites de contenido
Seedream 5.0 Pro · Layer Decomposition. SpicyAPI no añade ningún filtro de contenido en la plataforma en este endpoint. Las restricciones del modelo siguen vigentes y los resultados no están garantizados. En nuestras pruebas separó todas las imágenes de origen sin filtrar que probamos, salvo las de nivel Muy fuerte, que el modelo rechazó sin cargo. Eres responsable de cumplir nuestra política de contenido.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
