
Tutorial de la API de Seedream 5.5: genera, edita y separa imágenes
Llama a Seedream 5.5 una vez, consulta su tarea, edita con referencias, crea PNG transparentes y separa capas. Consulta tamaños y precios actuales.
Seedream 5.5 devuelve un ID de tarea antes de devolver una imagen. Envía la solicitud una sola vez, guarda ese ID y consulta periódicamente el resultado terminado. La generación produce una imagen; la descomposición en capas puede producir una imagen base y capas transparentes. Ambos flujos usan model: "seedream-5-5", pero sus reglas de entrada difieren. 1
Este tutorial parte de unas instrucciones para una tetera de cerámica, pasa por la generación y una edición específica y después muestra cómo separar un cartel existente en capas. El área de pruebas de Seedream 5.5 ofrece los mismos controles de solicitud. Puedes revisar allí el JSON antes de añadirlo a una aplicación.
El contrato se verificó el 12 de noviembre de 2026. Nuestras comprobaciones de integración reprodujeron 34 casos de solicitud y respuesta, incluidos ajustes de transparencia incompatibles, límites de capas y salidas completadas sin dimensiones utilizables. Estas comprobaciones validan el manejo de solicitudes y los datos de entrada de contabilidad; no son una prueba de rendimiento de velocidad de generación ni de calidad de imagen. Las imágenes siguientes son muestras existentes de Seedream 5.5 del 10 de noviembre.
Empieza con una clave y una solicitud pequeña
Crea una clave en Claves API, guárdala en tu servidor y usa https://api.wanapi.app como URL base. Tu clave actual de Wan API funciona con los modelos y grupos disponibles. No hay una clave independiente que comprar o seleccionar para este modelo de imágenes.
Guarda esto como generate.json:
{
"model": "seedream-5-5",
"prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
"size": "1K",
"output_format": "png",
"content_filter": true
}Configura WAN_API_KEY en el entorno de tu servidor y envía una sola vez:
curl --fail-with-body --retry 0 --max-time 90 \
https://api.wanapi.app/seedream55/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @generate.json \
-o submitted.jsonUna respuesta correcta contiene id, model y un estado de procesamiento. Conserva el archivo submitted.json completo. No interpretes la ausencia de una URL de imagen como una generación fallida: esta respuesta confirma la recepción de la tarea. Si la conexión se interrumpe antes de recibir un ID, revisa los registros de tareas antes de intentar otro POST. Una respuesta incierta no autoriza a crear de nuevo la misma tarea de pago.
Seleccionamos 1K explícitamente para esta primera solicitud. Si omites size, la generación usa 2K por defecto. PNG es el formato predeterminado, la marca de agua está desactivada y la revisión de contenido activada. Quienes llaman a la API pública pueden cambiar content_filter explícitamente; el área de pruebas mantiene la revisión activada para las cuentas normales. 1
Consulta el ID guardado, incluso después de actualizar
La URL de consulta es GET /seedream55/v1/tasks/{id}. Una respuesta completada guarda las imágenes en output.data; no usa la estructura de respuesta de la API de imágenes síncrona. Cada entrada tiene una URL y su tamaño real en píxeles.
Este script de Python lee la respuesta guardada y consulta durante un máximo de diez minutos. Solo envía solicitudes GET, por lo que volver a ejecutarlo continúa la tarea existente:
import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path
saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
request = urllib.request.Request(
url,
headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
)
try:
with urllib.request.urlopen(request, timeout=30) as response:
task = json.load(response)
except urllib.error.HTTPError as error:
if error.code != 429 and error.code < 500:
raise
time.sleep(5)
continue
except (urllib.error.URLError, TimeoutError):
time.sleep(5)
continue
if task["id"] != task_id:
raise RuntimeError("Unexpected task identity")
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
if task["status"] == "completed":
Path("result.json").write_text(json.dumps(task, indent=2))
for index, image in enumerate(task["output"]["data"], start=1):
print(index, image["size"], image["url"])
break
time.sleep(5)
else:
print("Still waiting. Keep submitted.json and resume this GET later.")El límite de diez minutos pertenece a este cliente de ejemplo. No cancela una tarea ni demuestra que la generación haya fallado. No hemos establecido un intervalo de latencia medido para esta integración, por lo que conviene crear un estado pendiente en lugar de prometer un número fijo de segundos. Guarda los archivos descargados cuando estén listos; no trates las URL de resultados como almacenamiento permanente de recursos.

Esta muestra tiene 1248 × 832 píxeles. El tamaño predefinido 1K es un nivel de resolución, no una promesa de que ambas dimensiones sean 1024. Lee size del resultado cuando tu diseño o cálculo de costes necesite dimensiones exactas.
Cambia la escena indicando qué debe conservarse
Para editar, añade image con una URL pública HTTP(S). Puede ser una foto original que alojes o un archivo generado que hayas descargado y alojado tú. Las referencias no pueden ser archivos subidos, Base64 ni URI de datos. Deben permanecer accesibles mientras se procesa la solicitud. Los formatos de entrada compatibles y los límites de medios se indican en la referencia de la API. 1
{
"model": "seedream-5-5",
"image": "https://your-public-host.example/fox-teapot.png",
"prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
"size": "1K"
}La URL anterior es un marcador de posición; sustitúyela por tu imagen accesible. Envíala como una tarea de edición independiente y deliberada, y guarda su respuesta con un nombre de archivo nuevo. El modelo no recuerda la tarea anterior: debes enviar la imagen que quieres editar.
Para varias referencias, image admite un array de hasta diez URL. Asigna una función a cada imagen en el prompt, como el producto de la primera imagen y el entorno de la segunda. Empieza con el conjunto más pequeño que resulte útil. Si el resultado cambia un detalle importante, tener menos referencias facilita identificar qué instrucción u original introdujo el cambio.
La conservación es una instrucción, no un bloqueo de píxeles. Compara la silueta del producto, las etiquetas y el ángulo de cámara con el original después de cada edición. Para carteles, pon entre comillas el titular exacto y revisa la puntuación, los nombres y las fechas al tamaño de visualización previsto. Las letras pequeñas o estilizadas aún pueden necesitar corrección manual; esta guía no promete una tasa de precisión medida para ningún idioma.
Para un recorte sin fondo, añade "background": "transparent" y conserva "output_format": "png". JPEG no puede contener ese canal alfa. La opción de transparencia está disponible para generación y edición; el modo de capas tiene sus propias reglas a continuación.
Separa un cartel en capas reutilizables
La descomposición en capas toma exactamente una imagen. El prompt es opcional: omítelo para que el modelo elija los elementos o indica las partes que quieres separar. Empieza con un límite pequeño de salidas mientras evalúas un diseño:
{
"model": "seedream-5-5",
"image": "https://your-public-host.example/poster.png",
"size": "1K",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 4,
"text_recognition": true
},
"output_format": "png"
}max_images también cuenta la imagen base. Por tanto, cuatro permite la base y hasta tres capas. El límite permitido es 2–100, con un valor predeterminado de 30, y el modelo puede devolver menos imágenes. No envíes background en este modo, ni siquiera como auto. Las capas separadas ya son PNG transparentes; output_format controla la imagen base. 1

Esta vista previa existente combina el cartel original y los elementos transparentes devueltos. Ayuda a ver qué significa la separación, pero no garantiza que todos los carteles se dividan en el mismo número de capas ni que tengan bordes limpios.
Revisa los metadatos opcionales junto a cada resultado:
| Campo | Cómo usarlo |
|---|---|
z_index | Coloca los valores más altos por encima de los más bajos. |
bounding_box.absolute | Coloca la capa con las coordenadas izquierda, superior, derecha e inferior en píxeles de la imagen base. |
bounding_box.normalized | Las coordenadas correspondientes en una escala de 0–1000. |
name, description | Identifica el elemento que ha separado el modelo. |
text_recognition | Lee el texto reconocido, las líneas y la información de estilo disponible. |
Conserva el JSON completo del resultado, no solo sus URL. Una capa puede tener un tamaño de imagen distinto al de su colocación en el lienzo base. Usa el cuadro delimitador al reconstruir la composición y comprueba visualmente el resultado. Las sugerencias de fuentes son estimaciones; los metadatos OCR no garantizan la fuente original ni un archivo PSD listo para usar. Las letras artísticas, los elementos superpuestos y el texto excluido por tu prompt pueden producir resultados incompletos.
Elige las dimensiones antes de comparar costes
La generación admite 1K, 1.5K y 2K, además de dimensiones exactas WIDTHxHEIGHT entre 921.600–4.624.220 píxeles totales y una relación de aspecto de 1:16 a 16:1. El modo de capas acepta esos tamaños predefinidos o auto, pero no dimensiones exactas. Este contrato no ofrece tamaños predefinidos 3K o 4K, n para lotes, semilla ni modo de optimización rápida de prompts. No traslades parámetros de otra versión de Seedream sin comprobarlos. 1
Aquí se muestran las tarifas actuales de la misma fuente de precios que el área de pruebas:
Los precios no están disponibles en este momento. Actualiza esta página para intentarlo de nuevo.
Las tarifas se actualizan automáticamente. Una clave API funciona con todos los modelos y grupos.
Sea L la tarifa de salida hasta 2,61 millones de píxeles, H la tarifa por encima de ese límite y R la tarifa por imagen de referencia. Una generación 1K sin referencia cuesta L; una edición con una referencia cuesta L + R. Tanto 1K como 1.5K usan la tarifa inferior de salida. Se cobra cada referencia, incluida la primera. 2
Una solicitud de capas 1K de cuatro imágenes estima 4L + R. Si solo devuelve la base y dos capas, cada una dentro de la franja inferior, el coste final es 3L + R. Para tamaños de salida mixtos, cuenta cada imagen por separado: dos imágenes de la franja inferior y una imagen mayor cuestan 2L + H + R. La base es una imagen de salida y no debe omitirse de ese recuento.
La reserva inicial cubre el límite elegido. Los fondos no usados se liberan tras liquidar las salidas reales y una tarea fallida se reembolsa. En nuestras pruebas de contabilidad, reproducir la misma respuesta completada no modificó el saldo por segunda vez. También comprobamos que una finalización sin todos los datos necesarios del uso de imágenes quedaba sin liquidar, en lugar de tratar las cantidades estimadas como salidas observadas.
Cuando una solicitud o un resultado necesitan atención
Un error de validación suele indicar una incompatibilidad de modo: varias referencias en el modo de capas, JPEG transparente, un tamaño no compatible u opciones de capas en una solicitud de generación. Corrige la solicitud antes de crear una tarea nueva. Un error temporal de consulta es distinto: conserva el ID existente y reintenta el GET. Son decisiones independientes; combinarlas en un manejador genérico de «reintentar todo» puede duplicar generaciones de pago.
Si una edición es deficiente, compara un cambio cada vez con el original. Una salida mayor no demuestra que el modelo haya conservado una etiqueta o representado correctamente un titular. Para las capas, revisa los bordes y los metadatos ausentes antes de importar el resultado a un diseño de producción. La revisión de contenido sigue activada por defecto; un rechazo de contenido no debe provocar un reenvío automático con la revisión desactivada.
Seedream 5.5 encaja en flujos que necesitan generación, ediciones con referencias o elementos de diseño separables bajo este contrato. Seedream 5.0 Pro es un modelo independiente con valores predeterminados y límites distintos. No hemos realizado una comparación controlada que permita afirmar que uno es siempre mejor. Esta guía tampoco afirma por separado la disponibilidad de «5.5 Pro» ni promete generación gratuita. Consulta la página del modelo para ver el área de pruebas y el precio actuales, o usa el documento OpenAPI para incorporar la validación de solicitudes a tu aplicación.
Referencias
- Referencia de la API de Seedream 5.5: campos de solicitud, valores predeterminados, entradas URL, respuestas asíncronas y metadatos de capas. Contrato verificado el 12 de noviembre de 2026.
- Precios actuales de Seedream 5.5: franjas de píxeles de salida y tarifas por imagen de referencia.
Categorías
Más artículos

Seedream 5.0 Pro: qué devuelve la separación en capas y cómo se cobra
Cómo separar imágenes en capas con la API de Seedream 5.0 Pro: requisitos, tamaños, datos devueltos y facturación por capa para estimar el coste.


Seedance 2.5 vs Seedance 2.0: ¿cuál encaja con tu escena?
Compara duración, referencias y muestras de Seedance 2.5 y 2.0. Planifica una prueba sin dar por hecho qué modelo ofrece mejor calidad o rapidez.


Seedance 2.5 Flash: precios
Calcula el precio de Seedance 2.5 Flash para un plano de cinco segundos. Compara texto, vídeo de referencia y ediciones con las tarifas vigentes de 480p y 720p.

Novedades de Wan API
Novedades del servicio y de los modelos
Suscríbete para recibir novedades de los modelos y del servicio e información sobre la integración de la API.