Seedream 5.0 Pro: qué devuelve la separación en capas y cómo se cobra

La separación en capas de Seedream 5.0 Pro toma una imagen terminada en PNG o JPEG y devuelve una imagen base y hasta 16 capas PNG transparentes, cada una con su orden de apilamiento, posición, nombre y descripción. Se cobra por imagen devuelta, no por solicitud: cada capa cuesta la tarifa de capas correspondiente a su propio tamaño en píxeles. En la API, la función se llama descomposición en capas y se activa con layer_decomposition: true. 1 2

ByteDance presentó esta capacidad con el lanzamiento de Seedream 5.0 Pro el 8 de julio de 2026, mostrando un cartel dividido en más de diez capas, entre ellas el texto, el sujeto principal y el fondo. Las zonas ocultas detrás del sujeto se rellenan, de modo que se puede mover una capa sin dejar un hueco. 3 Esta guía explica qué envías, qué recibes y cómo estimar el coste antes de usar la función. Puedes probarla en el área de pruebas de Seedream 5.0 Pro cambiando el modo a descomposición en capas.

Qué envíasCopiar enlace del encabezado

La separación en capas usa el mismo endpoint de imágenes que la generación normal, con requisitos de entrada más estrictos. 1

auto mantiene la imagen base y cada capa en su tamaño original cuando este se encuentra entre 921.600 y 4.624.220 píxeles, amplía las más pequeñas hasta 1K y reduce las más grandes hasta 2K, conservando la relación de aspecto de cada elemento. Con un tamaño predefinido fijo, la imagen base tiene el tamaño elegido y cada capa se devuelve a una resolución cercana a él. 1

En Wan API, la separación en capas no se puede combinar con background: "transparent"; las capas ya tienen transparencia real y la solicitud se rechaza antes de cobrar nada.

Qué recibesCopiar enlace del encabezado

La respuesta muestra primero la imagen base (z_index: 0) y después cada capa:

Estos campos bastan para reconstruir la composición en una herramienta de diseño: coloca cada PNG en su cuadro delimitador, siguiendo el orden de z_index. 1

Lo probamos con un cartel de festival generado con Seedream 5.0 Pro, pidiendo el titular, la línea de la fecha, los nombres de los artistas, el saxofonista y el fondo. A 1.5K devolvió la imagen base y cinco capas. La imagen base de la izquierda ya no contiene ni el texto ni el músico; el fondo que había detrás de ellos se ha rellenado.

Cada capa se devolvió con un name en inglés, como "BLUE HOUR JAZZ headline", acorde con el prompt. Los elementos pequeños se entregan a mayor tamaño del que tienen en el cartel: la capa con los nombres de los artistas mide 2011×202 píxeles.

Hay dos comportamientos que debes tener en cuenta al integrar esta función. Si falla una capa, falla toda la solicitud; no hay resultados parciales. Y si tu prompt pide más capas que el límite de 16, puede omitirse parte del contenido de las capas en lugar de que falle la solicitud. 1

Cómo se cobra la separación en capasCopiar enlace del encabezado

La tarifa oficial de la descomposición en capas de Seedream 5.0 Pro es por imagen de salida: 0,0225 US$ para una imagen de hasta 2,61 millones de píxeles y 0,045 US$ por encima de ese tamaño. 2 En Wan API, un resultado en el que todas las imágenes devueltas tienen hasta 2,61 millones de píxeles cuesta un 30 % menos: 0,01575 US$ por imagen. Un resultado que incluya una imagen mayor, como ocurre con todas las solicitudes a 2K, se cobra a la tarifa oficial por cada imagen. Puedes consultar los importes actuales en la tabla de precios.

Como el modelo decide cuántas capas devolver, el coste depende del resultado:

Un elemento pequeño se mantiene en el tramo de tarifa más baja incluso en una solicitud a 2K: la capa de título de 1273×265 del ejemplo oficial tiene unos 0,34 millones de píxeles. 1

En nuestra prueba anterior, las seis imágenes tenían como máximo 2,61 millones de píxeles: la imagen base medía 1344×1792 (unos 2,41 millones de píxeles) y la capa más grande, 1216×1662. Eso equivale a 6 × 0,0225 US$ = 0,135 US$ a la tarifa oficial, y nuestra pasarela cobró exactamente el importe esperado según los tamaños devueltos. Al precio de Wan API, el mismo resultado cuesta 6 × 0,01575 US$ = 0,0945 US$.

En Wan API, tu saldo debe cubrir el máximo resultado posible antes de que comience la solicitud; después solo pagas por la imagen base y las capas que se hayan devuelto. Elegir 1K o 1.5K reduce ese límite de 0,765 US$ a 0,26775 US$ y suele mantener todas las imágenes en el tramo de tarifa más baja con descuento.

Comprueba cómo cuenta las capas un planCopiar enlace del encabezado

Lee las condiciones de facturación antes de comprar un plan de imágenes para esta función. En una publicación de agosto de 2026, un cliente de BytePlus contó que había comprado un plan de imágenes de Seedream 5.0 Pro para separar imágenes en capas y había descubierto que las solicitudes de capas se cobraban por capa a las tarifas de pago por uso, en lugar de consumir la cuota de imágenes del plan; el equipo de soporte reconoció que la distinción «puede no haberse comunicado con claridad». 4 Sea cual sea el servicio que uses, confirma si las capas cuentan dentro de un paquete y cuánto cuesta cada una.

Úsalo en Wan APICopiar enlace del encabezado

Envía la solicitud una sola vez a POST https://api.wanapi.app/v1/images/generations con tu clave API. La respuesta se devuelve cuando todas las capas están listas.

curl https://api.wanapi.app/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Separate the title text, the parrot and the background",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "1.5K"
}'

Descarga las capas en un plazo de 30 días. La guía de la API de Seedream 5.0 Pro enumera todos los campos, la estructura completa de la respuesta y los códigos de error.

Cuándo conviene usar la separación en capasCopiar enlace del encabezado

Úsala cuando ya tengas una imagen terminada y necesites partes editables: sustituir el titular de un cartel, mover una fotografía de producto o entregar un diseño plano a alguien que trabaja con capas. Usa la generación normal o la edición con referencias cuando quieras una imagen nueva; usa el modo de fondo transparente cuando necesites un sujeto sobre un fondo transparente en lugar de un conjunto completo de capas.

Empieza en el área de pruebas: sube una imagen, elige descomposición en capas y comprueba la estimación antes de generar.

FuentesCopiar enlace del encabezado

1. BytePlus ModelArk: image generation API, layer_decomposition, size, output_format y campos de respuesta de Seedream 5.0 Pro. Consultado el 23 de octubre de 2026.

2. BytePlus ModelArk: model pricing, tarifas de generación de una imagen y descomposición en capas de Seedream 5.0 Pro. Consultado el 23 de octubre de 2026.

3. ByteDance Seed: Introducing Seedream 5.0 Pro, publicación de lanzamiento del 8 de julio de 2026, sección de separación en capas. Consultado el 23 de octubre de 2026.

4. Reddit r/generativeAI: "PSA: Why BytePlus Seedream 5.0 Pro's Layer Separation marketing felt misleading", relato de un cliente publicado el 31 de agosto de 2026. Consultado el 23 de octubre de 2026.