# API de Seedream 5.5 (https://wanapi.app/es/docs/seedream-5-5)





Seedream 5.5 genera una imagen a partir de texto o de hasta 10 imágenes de referencia. La descomposición en capas toma una imagen y devuelve una imagen base y capas transparentes, con un resultado opcional de reconocimiento de texto impreso.

[Prueba el área de pruebas](/es/models/seedream-5-5#playground) · [JSON de OpenAPI](/models/seedream-5-5/openapi.json) · [Tutorial de integración](/es/blog/seedream-5-5-api-guide)

## Autenticación y endpoints [#autenticación-y-endpoints]

Usa tu clave de Wan API como token Bearer. Una clave da acceso a todos los modelos y grupos disponibles; no seleccionas un grupo en la clave.

| Método | URL                                                       | Finalidad                  |
| ------ | --------------------------------------------------------- | -------------------------- |
| POST   | `https://api.wanapi.app/seedream55/v1/images/generations` | Enviar una tarea de imagen |
| GET    | `https://api.wanapi.app/seedream55/v1/tasks/{id}`         | Consultar esa tarea        |

El ID del modelo es &#x2A;*`seedream-5-5`**. Estos endpoints son asíncronos. Envía una sola vez, guarda el ID de tarea y consúltalo periódicamente hasta `completed` o `failed`. Una respuesta de red incierta no autoriza a enviar de nuevo.

## Generar una imagen [#generar-una-imagen]

```bash
curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'
```

Una solicitud aceptada devuelve una tarea en lugar de los bytes de la imagen:

```json
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
```

```bash
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"
```

Consulta el mismo ID cada pocos segundos. Consérvalo si tu aplicación deja de esperar, para poder reanudar después. Los ID de tarea y las marcas de tiempo de esta guía son ilustrativos.

## Parámetros [#parámetros]

| Parámetro                                      | Tipo               | Valor predeterminado      | Reglas                                                                                                             |
| ---------------------------------------------- | ------------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `model`                                        | string             | obligatorio               | `seedream-5-5`                                                                                                     |
| `prompt`                                       | string             | obligatorio para generar  | Opcional para la descomposición en capas.                                                                          |
| `image`                                        | URL o array de URL | ninguno                   | Hasta 10 referencias; exactamente una para capas. Se cobra cada referencia.                                        |
| `size`                                         | string             | `2K`, o `auto` para capas | Consulta las reglas de tamaño a continuación.                                                                      |
| `output_format`                                | string             | `png`                     | `png` o `jpeg`. Para capas, solo controla la imagen base.                                                          |
| `background`                                   | string             | `auto`                    | `auto`, `opaque`, `transparent`. La transparencia requiere PNG. Omite este campo por completo en el modo de capas. |
| `layer_decomposition`                          | boolean            | `false`                   | Separa una referencia en una imagen base y capas PNG transparentes.                                                |
| `layer_decomposition_options.max_images`       | integer            | `30`                      | Límite total de imágenes de 2–100, incluida la base. Solo para el modo de capas.                                   |
| `layer_decomposition_options.text_recognition` | boolean            | `false`                   | Solicita metadatos de texto impreso en las capas. Solo para el modo de capas.                                      |
| `optimize_prompt_options.mode`                 | string             | `standard`                | El único modo compatible es `standard`.                                                                            |
| `watermark`                                    | boolean            | `false`                   | Solicita una marca de agua de generación con IA.                                                                   |
| `content_filter`                               | boolean            | `true`                    | La API de clientes acepta false. En el área de pruebas, solo los administradores pueden desactivarlo.              |

No se admiten los parámetros `n`, `seed`, `stream`, `resolution`, `aspect_ratio`, `image_urls` ni `response_format`. Los campos no documentados se descartan y no activan esas funciones. Se rechazan las subidas multipart, Base64 y las URI de datos.

## Tamaño de salida [#tamaño-de-salida]

La generación admite `1K`, `1.5K`, `2K` o dimensiones exactas de `WIDTHxHEIGHT` píxeles. Los tamaños exactos deben sumar **921.600–4.624.220 píxeles** y tener una relación de aspecto de **1:16 a 16:1**. Por ejemplo, `2048x1152` es válido. Una relación como `16:9` no es un valor de tamaño.

La descomposición en capas admite `auto`, `1K`, `1.5K` o `2K`; ese modo no admite dimensiones exactas en píxeles. `auto` sigue la entrada y reserva la tarifa superior de salida. El modelo no tiene tamaños predefinidos 3K ni 4K.

<span id="reference-images-and-editing" />

## Imágenes de referencia y edición [#imágenes-de-referencia-y-edición]

Proporciona URL públicas HTTP(S) alojadas por ti, sin credenciales integradas. Los formatos compatibles son JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF, hasta 30 MB por imagen y un máximo de 36.000.000 píxeles en total. AVIF y JP2 no son compatibles. La URL debe servir una imagen directamente, sin inicio de sesión ni comprobación del navegador.

```json
{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}
```

Para varias referencias, pasa un array de URL y explica en el prompt la función de cada imagen. El resultado sigue siendo una imagen. Las URL de referencia de los ejemplos son marcadores de posición: sustitúyelas por tus propios archivos accesibles.

## Descomposición en capas y reconocimiento de texto [#descomposición-en-capas-y-reconocimiento-de-texto]

```json
{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}
```

El límite incluye la imagen base; `4` significa un máximo de cuatro imágenes devueltas, no cuatro capas más una base. El modelo puede devolver menos. Omite `prompt` para la separación automática o indica los elementos que separar. Un prompt puede suprimir el texto que excluya.

Las capas son archivos PNG con transparencia. Reconstruye la imagen en orden ascendente de `z_index`, con la base en 0. Si se proporciona un cuadro delimitador, ajusta la capa a ese cuadro antes de colocarla: las dimensiones en píxeles del archivo de capa pueden diferir de sus dimensiones de colocación.

El campo opcional `text_recognition` contiene el `text` completo y `lines`. Cada línea puede incluir un `bounding_box` y fragmentos `runs` con estilo. El `style` de un fragmento puede incluir `similar_font_family`, `foreground_color` (`#RRGGBB`), `bold`, `italic`, `underline`, `strikethrough`, `shadow` y `translucent`. Son estimaciones del modelo. Las letras artísticas o manuscritas pueden no tener un resultado de texto; trata el campo como opcional.

## Respuesta completada [#respuesta-completada]

```json
{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}
```

Cada imagen tiene una `url` y un `size`. Otros campos pueden incluir `output_format`, `background`, `z_index`, `name`, `description`, `bounding_box` y `text_recognition`. `bounding_box.absolute` es `[left, top, right, bottom]` en píxeles de la imagen base. `bounding_box.normalized` usa las mismas coordenadas escaladas a 0–1000. No des por hecho que todas las imágenes tienen metadatos opcionales.

Trata las URL de imágenes como enlaces de descarga privados y guarda los archivos que necesites. Una URL con un token `access` puede abrirse sin exponer la clave API de tu cuenta.

## Precios [#precios]

<Seedream55ModelPricing />

El límite de píxeles de salida es **2.610.000 píxeles**. Calcula la factura así:

```text
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate
```

Se cobra cada referencia, incluida la primera y la imagen original para las capas. La generación y las capas usan las mismas tarifas de salida. El envío reserva una salida o el límite `max_images` de capas, más las referencias. Al completarse, se usan las dimensiones en píxeles propias de cada imagen devuelta y se libera la reserva no utilizada. La tarea aceptada conserva su instantánea de precios aunque las tarifas cambien durante su ejecución. Las tareas fallidas se reembolsan.

## Errores y comportamiento de reintento [#errores-y-comportamiento-de-reintento]

Los parámetros no válidos se rechazan antes del envío. Un saldo o una cuota de clave insuficientes impiden la generación. Las comprobaciones de autenticación y propiedad se aplican tanto al envío como a las consultas periódicas. Una tarea fallida devuelve `status: "failed"` con un objeto `error`.

Reintenta una lectura de estado fallida con el mismo ID de tarea. **No repitas automáticamente un POST de generación**, tampoco tras un tiempo de espera agotado: puede haberse aceptado ya. Mientras el servicio de origen informe de un progreso normal, la tarea seguirá pendiente. Una tarea sin estado normal del servicio de origen ni entrega correcta durante tres horas continuas falla y se reembolsa.

Consulta el [tutorial de Seedream 5.5](/es/blog/seedream-5-5-api-guide) para ver un bucle de aplicación que guarda y reanuda el ID de tarea.
