Termina en—Modelos Wan hasta un 45 % más baratos que el precio oficial
LogoWan API
  • Modelos
  • Desarrolladores
  • Precios
  • Docs API
  • Guías
Tutorial de la API de Seedream 5.5: genera, edita y separa imágenes
12/11/2026

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.json

Una 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.

Tetera de cerámica con forma de zorro generada por Seedream 5.5 sobre un mantel de lino

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

Cartel original de Seedream 5.5 y capas separadas de fondo, músico y texto transparente

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:

CampoCómo usarlo
z_indexColoca los valores más altos por encima de los más bajos.
bounding_box.absoluteColoca la capa con las coordenadas izquierda, superior, derecha e inferior en píxeles de la imagen base.
bounding_box.normalizedLas coordenadas correspondientes en una escala de 0–1000.
name, descriptionIdentifica el elemento que ha separado el modelo.
text_recognitionLee 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

  1. 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.
  1. Precios actuales de Seedream 5.5: franjas de píxeles de salida y tarifas por imagen de referencia.
Todos los artículos

Autor

avatar for Wan API
Wan API

Categorías

  • Producto
Empieza con una clave y una solicitud pequeñaConsulta el ID guardado, incluso después de actualizarCambia la escena indicando qué debe conservarseSepara un cartel en capas reutilizablesElige las dimensiones antes de comparar costesCuando una solicitud o un resultado necesitan atenciónReferencias

Más artículos

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

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.

avatar for Wan API
Wan API
23/10/2026
Seedance 2.5 vs Seedance 2.0: ¿cuál encaja con tu escena?
Producto

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.

avatar for Wan API
Wan API
14/10/2026
Seedance 2.5 Flash: precios
Producto

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.

avatar for Wan API
Wan API
18/11/2026

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.

LogoWan API

Wan 3.0 y Wan 3.0 Prime. Generación de vídeo para tu próximo proyecto.Plataforma independiente. Sin afiliación ni respaldo de Alibaba, Wan o ByteDance.

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
Modelos
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • Precios
Desarrolladores
  • Documentación
  • Guía de Wan 3.0
  • Preguntas frecuentes
  • Acerca de Wan API
  • Contacta con Wan API
Información legal
  • Privacidad
  • Condiciones
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. Todos los derechos reservados.