Seedream 5.0 Pro
API de Seedream 5.0 Pro: texto a imagen, edición con referencias, descomposición en capas, PNG transparente, campos de solicitud, respuestas y precios.
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.
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 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
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.
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:
{
"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
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.
| Concepto facturado | Precio oficial | Precio de Wan API |
|---|---|---|
| Imagen de hasta 2,61 MP (1K, 1.5K) | 0,045 US$ | No disponible |
| Imagen de más de 2,61 MP (2K) | 0,09 US$ | No disponible |
| Descomposición en capas, todas las imágenes devueltas de hasta 2,61 MP | 0,0225 US$ | No disponible |
| Resultado en capas con una imagen mayor: cada imagen de hasta 2,61 MP | 0,0225 US$ | No disponible |
| Resultado en capas con una imagen mayor: cada imagen de más de 2,61 MP | 0,045 US$ | No disponible |
| Cada imagen de referencia después de la primera | 0,003 US$ | No disponible |
Wan API ofrece las imágenes de Seedream 5.0 Pro, las referencias adicionales y la descomposición en capas a 1K o 1.5K a un precio un 30 % inferior al precio oficial por imagen. Si un resultado en capas incluye una imagen de más de 2,61 MP, se cobra a la tarifa oficial.
La descomposición en capas cobra la imagen base y cada capa devuelta. Cuando todas las imágenes devueltas tienen hasta 2,61 MP, cada una se cobra a la tarifa de capas con descuento; si alguna imagen es mayor, todas se cobran a la tarifa oficial de capas correspondiente a su propio tamaño. La estimación cubre el máximo de 17 imágenes.
Precios oficiales: BytePlus ModelArk. Verificado el 2026-10-23.
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
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/<format>;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
Envía una imagen con una instrucción de edición o varias imágenes para combinarlas:
{
"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
{
"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:
{
"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
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.