LogoDocumentación de Wan API
Página de inicio
X (Twitter)
Página de inicio

Primeros pasos

Descripción generalGuía de integraciónConsultar saldoEliminar una tarea

Modelos Wan

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Modelos Seedance

Seedance 2.5Seedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modelos de imagen

Seedream 5.0 Pro
X (Twitter)

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.

AjusteSeedream 5.0 Pro
ID del modelobytedance/seedream-5.0-pro
size1K, 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.
imageHasta 10 imágenes de referencia.
SalidaUna 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.

Tarifas actualesUSD por imagen
Precios de Seedream 5.0 Pro
Concepto facturadoPrecio oficialPrecio 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 MP0,0225 US$No disponible
Resultado en capas con una imagen mayor: cada imagen de hasta 2,61 MP0,0225 US$No disponible
Resultado en capas con una imagen mayor: cada imagen de más de 2,61 MP0,045 US$No disponible
Cada imagen de referencia después de la primera0,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.

CampoTipoContrato
modelcadenaObligatorio: bytedance/seedream-5.0-pro.
promptcadenaQué 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.
imagecadena o lista de cadenasHasta 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.
sizecadenaGeneració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_decompositionbooleanoPor defecto: false. true separa exactamente una imagen PNG o JPEG en una imagen base y hasta 16 capas.
optimize_prompt_optionsobjeto{"mode": "standard"} (por defecto) o {"mode": "fast"}. El modo rápido reduce el tiempo de generación con una calidad ligeramente inferior.
output_formatcadenajpeg (por defecto) o png. En la descomposición en capas establece el formato de la imagen base; las capas siempre son PNG.
backgroundcadenaopaque (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.
watermarkbooleanoPor defecto: true; añade una pequeña etiqueta que indica que la imagen se ha generado con IA. Envía false para quitarla.
nsfw_checkerbooleanoEl 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_formatcadenaurl (por defecto) o b64_json.
nenteroOpcional; 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"}}.

HTTPcodeSignificado
400invalid_request o un mensaje de validaciónUn campo o una combinación no es compatible. Corrige la solicitud; no se ha cobrado nada.
400content_policy_violationEl prompt, una imagen de entrada o la salida se han rechazado por la política de contenido. No se ha cobrado nada.
402cuota insuficienteAñade saldo antes de enviar de nuevo.
429rate_limitedDemasiadas solicitudes. Vuelve a intentarlo más tarde.
502submission_unknownNo se ha recibido el resultado y la solicitud no se ha cobrado. Comprueba tus registros de uso antes de enviarla de nuevo.
503upstream_unavailableLa 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.

Seedance 2.0 Mini

API de Seedance 2.0 Mini: generación de vídeo, fotogramas, referencias, ejemplos de solicitudes, consulta de tareas, descargas y precios.

Índice

Conecta con Wan APIGenera una imagenPrecios de Seedream 5.0 ProCampos de la solicitudEdita y combina imágenes de referenciaDescomposición en capasErrores