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.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modelos de imagen

Seedream 5.0 ProAPI de Seedream 5.5

Modelos de lenguaje

API de ClaudeClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2API de GPTGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

API de Seedream 5.5

Genera y edita imágenes o separa capas con Seedream 5.5. Parámetros, tareas asíncronas, metadatos de imagen y precios actuales por imagen.

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 · JSON de OpenAPI · Tutorial de integración

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étodoURLFinalidad
POSThttps://api.wanapi.app/seedream55/v1/images/generationsEnviar una tarea de imagen
GEThttps://api.wanapi.app/seedream55/v1/tasks/{id}Consultar esa tarea

El ID del modelo es 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

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:

{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
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ámetroTipoValor predeterminadoReglas
modelstringobligatorioseedream-5-5
promptstringobligatorio para generarOpcional para la descomposición en capas.
imageURL o array de URLningunoHasta 10 referencias; exactamente una para capas. Se cobra cada referencia.
sizestring2K, o auto para capasConsulta las reglas de tamaño a continuación.
output_formatstringpngpng o jpeg. Para capas, solo controla la imagen base.
backgroundstringautoauto, opaque, transparent. La transparencia requiere PNG. Omite este campo por completo en el modo de capas.
layer_decompositionbooleanfalseSepara una referencia en una imagen base y capas PNG transparentes.
layer_decomposition_options.max_imagesinteger30Límite total de imágenes de 2–100, incluida la base. Solo para el modo de capas.
layer_decomposition_options.text_recognitionbooleanfalseSolicita metadatos de texto impreso en las capas. Solo para el modo de capas.
optimize_prompt_options.modestringstandardEl único modo compatible es standard.
watermarkbooleanfalseSolicita una marca de agua de generación con IA.
content_filterbooleantrueLa 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

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.

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.

{
  "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

{
  "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

{
  "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

Imagen facturableUSD por imagen
Salida de hasta 2,61 MP (1K / 1.5K)0,017 US$
Salida de más de 2,61 MP (2K)0,02975 US$
Cada imagen de referencia, incluida la primera0,0068 US$

Las tarifas se actualizan automáticamente. Una clave API funciona con todos los modelos y grupos.

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

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

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 para ver un bucle de aplicación que guarda y reanuda el ID de tarea.

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.

API de Claude

Usa Claude con Anthropic Messages u OpenAI Chat Completions. IDs, ejemplos de streaming y precios de entrada, salida y caché por grupo.

Índice

Autenticación y endpointsGenerar una imagenParámetrosTamaño de salidaImágenes de referencia y ediciónDescomposición en capas y reconocimiento de textoRespuesta completadaPreciosErrores y comportamiento de reintento