# Seedream 5.0 Pro (https://wanapi.app/es/docs/seedream-5-0-pro)
Seedream 5.0 Pro genera una imagen a partir de un prompt, edita o combina hasta 10 imágenes de referencia y separa una imagen en una imagen base y hasta 16 capas transparentes. La salida puede ser de 1K, 1.5K, 2K o de unas dimensiones exactas en píxeles. [Detalles del modelo y área de pruebas](/es/models/seedream-5-0-pro).
## Conecta con Wan API [#conecta-con-wan-api]
Usa `https://api.wanapi.app` como URL base de la API. Crea una clave con la familia de modelos **Wan** en [los ajustes de claves API](/es/settings/apikeys) y envíala como `Authorization: Bearer YOUR_API_KEY`. Guarda las claves en tu servidor. El área de pruebas usa tu sesión del sitio web y cobra del mismo saldo de cuenta.
`GET /v1/models` enumera los modelos disponibles para tu clave. Seedream 5.0 Pro usa la API de OpenAI Images: `POST /v1/images/generations` con JSON, o `POST /v1/images/edits` con JSON o archivos subidos mediante multipart. La respuesta se devuelve cuando la imagen está lista; no hay ninguna tarea cuyo estado debas consultar.
| Ajuste | Seedream 5.0 Pro |
| ------------- | ------------------------------------------------------------------------------------------------------------------------- |
| ID del modelo | `bytedance/seedream-5.0-pro` |
| `size` | `1K`, `1.5K`, `2K` (por defecto) o `WIDTHxHEIGHT` con 921.600–4.624.220 píxeles y una relación de aspecto de 1:16 a 16:1. |
| `image` | Hasta 10 imágenes de referencia. |
| Salida | Una imagen por solicitud, o una imagen base y hasta 16 capas con `layer_decomposition`. |
## Genera una imagen [#genera-una-imagen]
Asigna tu clave a `WAN_API_KEY` en el servidor. Envía la solicitud una sola vez; la generación suele terminar en menos de un minuto, así que configura un tiempo de espera del cliente de al menos cuatro minutos.
```bash
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": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'
```
La respuesta sigue el formato de OpenAI Images. Los valores del ejemplo son ilustrativos:
```json
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}
```
Las URL de las imágenes permanecen disponibles durante 30 días. Guarda los archivos por tu cuenta si los necesitas durante más tiempo. Envía `"response_format": "b64_json"` para recibir también cada imagen como Base64 en `b64_json`.
## Precios de Seedream 5.0 Pro [#precios-de-seedream-50-pro]
Cada imagen generada se cobra por imagen según su tamaño en píxeles, a un precio un 30 % inferior a la tarifa oficial: hasta 2,61 millones de píxeles (1K y 1.5K) se usa la tarifa más baja; para imágenes mayores, la más alta. La primera imagen de referencia es gratuita; cada imagen de referencia adicional añade la tarifa de referencia. Una solicitud rechazada antes de generar una imagen no se cobra.
La descomposición en capas cobra la imagen base y cada capa devuelta. Cuando todas las imágenes devueltas tienen hasta 2,61 millones de píxeles, cada una cuesta un 30 % menos que la tarifa oficial de capas. Si alguna imagen devuelta es mayor, como siempre ocurre a `2K`, todas las imágenes se cobran a la tarifa oficial de capas correspondiente a su propio tamaño. Tu saldo debe cubrir el máximo de 17 imágenes; solo pagas por las imágenes devueltas.
## Campos de la solicitud [#campos-de-la-solicitud]
Envía un objeto JSON. `model` es obligatorio; `prompt` es obligatorio salvo que `layer_decomposition` sea `true`. Se rechazan los campos desconocidos.
| Campo | Tipo | Contrato |
| ------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | cadena | Obligatorio: `bytedance/seedream-5.0-pro`. |
| `prompt` | cadena | Qué generar o qué elementos separar en la descomposición en capas. Admite inglés, chino y otros idiomas; para obtener los mejores resultados, conviene no superar unas 600 palabras en inglés. |
| `image` | cadena o lista de cadenas | Hasta 10 imágenes de referencia como URL HTTP(S) o `data:image/;base64,...` con el formato en minúsculas. Formatos: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF; hasta 30 MB cada una; relación de aspecto de 1:16 a 16:1. |
| `size` | cadena | Generación de imágenes: `1K`, `1.5K`, `2K` (por defecto) o `WIDTHxHEIGHT`. Descomposición en capas: `1K`, `1.5K`, `2K` o `auto` (por defecto). |
| `layer_decomposition` | booleano | Por defecto: `false`. `true` separa exactamente una imagen PNG o JPEG en una imagen base y hasta 16 capas. |
| `optimize_prompt_options` | objeto | `{"mode": "standard"}` (por defecto) o `{"mode": "fast"}`. El modo rápido reduce el tiempo de generación con una calidad ligeramente inferior. |
| `output_format` | cadena | `jpeg` (por defecto) o `png`. En la descomposición en capas establece el formato de la imagen base; las capas siempre son PNG. |
| `background` | cadena | `opaque` (por defecto) o `transparent`. El fondo transparente requiere exactamente una imagen de entrada con canal alfa y salida en PNG; no se puede combinar con la descomposición en capas. |
| `watermark` | booleano | Por defecto: `true`; añade una pequeña etiqueta que indica que la imagen se ha generado con IA. Envía `false` para quitarla. |
| `nsfw_checker` | booleano | El valor por defecto `true` mantiene activada la comprobación de contenido. `false` envía la solicitud sin esa comprobación; el precio es el mismo. |
| `response_format` | cadena | `url` (por defecto) o `b64_json`. |
| `n` | entero | Opcional; debe ser `1`. |
Este modelo no admite `stream`, `sequential_image_generation`, `tools`, `seed`, `guidance_scale` ni `mask`; estos campos se rechazan.
## Edita y combina imágenes de referencia [#edita-y-combina-imágenes-de-referencia]
Envía una imagen con una instrucción de edición o varias imágenes para combinarlas:
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}
```
`POST /v1/images/edits` acepta los mismos campos. Con multipart, sube archivos en los campos `image` o `image[]` y envía `optimize_prompt_options` como una cadena JSON.
## Descomposición en capas [#descomposición-en-capas]
```json
{
"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": "2K"
}
```
La respuesta muestra primero la imagen base. Cada capa añade su orden de apilamiento, posición y descripción:
```json
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}
```
Si falla una capa, falla toda la solicitud. Si el prompt pide más capas de las permitidas, puede omitirse parte del contenido de las capas.
## Errores [#errores]
Los errores usan la estructura de errores de OpenAI `{"error": {"message", "type", "code"}}`.
| HTTP | `code` | Significado |
| ---- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| 400 | `invalid_request` o un mensaje de validación | Un campo o una combinación no es compatible. Corrige la solicitud; no se ha cobrado nada. |
| 400 | `content_policy_violation` | El prompt, una imagen de entrada o la salida se han rechazado por la política de contenido. No se ha cobrado nada. |
| 402 | cuota insuficiente | Añade saldo antes de enviar de nuevo. |
| 429 | `rate_limited` | Demasiadas solicitudes. Vuelve a intentarlo más tarde. |
| 502 | `submission_unknown` | No se ha recibido el resultado y la solicitud no se ha cobrado. Comprueba tus registros de uso antes de enviarla de nuevo. |
| 503 | `upstream_unavailable` | La generación de imágenes no está disponible temporalmente; la solicitud no se ha cobrado. |
Nunca reintentes automáticamente una solicitud tras agotar el tiempo de espera sin comprobar primero tus registros de uso.