Skip to main content
Referencia de API para wan/wan2.5-i2i-preview, servida por Comfy Router de Wan. Entrada: Imagen, Texto · Salida: Imagen

Inicio rápido

Crea una clave en tu espacio de trabajo de Comfy y expórtala como COMFY_API_KEY. Los fragmentos de Python y TypeScript usan los SDK de Comfy (pip install comfy-sdk y npm install @comfyorg/sdk); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. ID del modelo: wan/wan2.5-i2i-preview Endpoint: POST https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview
El mismo cuerpo, enviado a POST https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests. Router responde 201 con un request_id en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. Entrega en cola repasa el estado, la cancelación y la recogida.

Esquema

Entrada

object
requerido
Ingresa información básica, como palabras del prompt, imágenes, etc.
string[]
requerido
Arreglo de URLs de imágenes para la generación de imagen a imagen
string
Palabras del prompt inverso para describir el contenido que no quieres ver en la imagen
string
requerido
Palabras del prompt positivo para describir los elementos esperados de la imagen y sus características visuales. Admite chino e inglés, con una longitud no mayor a 2000 caracteres
string
El ID del modelo a llamar para la generación de imagen a imagen. NO está restringido en este componente: Comfy Router lo completa a partir del segmento de ruta {model} de POST /v2/models/wan/{model}. Una llamada directa a v1 a POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis DEBE proporcionarlo, y el enum de grafías aceptadas se encuentra en el componente propio de esa operación, WanImage2ImageGenerationRequest.
object
Parámetros de procesamiento de la imagen
integer
predeterminado:"4"
Número de imágenes generadas. Rango de 1 a 4, el valor predeterminado es 4Rango: 1 a 4
integer
Semilla de número aleatorio para controlar la aleatoriedad. Rango [0, 2147483647]Rango: 0 a 2147483647
string
predeterminado:"\"1280*1280\""
La resolución de la imagen de salida en el formato anchoalto. El valor predeterminado es 12801280. La API acepta un área en píxeles entre 589824 (768768) y 1638400 (12801280) con una relación de aspecto entre 1:4 y 4:1
boolean
predeterminado:"false"
Si se agrega el logotipo de marca de agua en la esquina inferior derecha
Generado a partir del esquema que Router publica en GET /v2/models/wan/wan2.5-i2i-preview/openapi.json, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.

Salida

object
requerido
string
Prompt real después de la reescritura inteligente (para tareas de video)
string
URL de audio para tareas I2V con generación de audio
string
El código de error de la solicitud fallida (no se devuelve si la solicitud es exitosa)
string
Hora de finalización de la tarea
string
Información detallada sobre la solicitud fallida (no se devuelve si la solicitud es exitosa)
string
Prompt de entrada original (para tareas de video)
object[]
Lista de resultados de la tarea para tareas de generación de imágenes
string
Prompt real después de la reescritura inteligente (si está habilitada)
string
Código de error de la imagen (se devuelve cuando fallan algunas tareas)
string
Información de error de la imagen (se devuelve cuando fallan algunas tareas)
string
Prompt de entrada original
string
Dirección URL de la imagen generada
string
Hora de ejecución de la tarea
string
Hora de envío de la tarea
string
requerido
ID de la tarea
object
Estadísticas de resultados de la tarea para tareas de generación de imágenes
integer
Número de tareas fallidas
integer
Número de tareas exitosas
integer
Número total de tareas
string
requerido
Estado de la tareaValores posibles: PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED, UNKNOWN
string
URL del video para tareas de generación de video completadas. El enlace es válido durante 24 horas
string
requerido
Identificador único de la solicitud
object
Estadísticas de la información de salida. Solo se cuentan los resultados exitosos
integer
Nivel de resolución del video (tareas I2V y wan3.0-video)
number
Duración del video generado en segundos (tareas I2V y wan3.0-video)
integer
Frecuencia de cuadros del video generado (tareas wan3.0-video)
integer
Número de imágenes generadas (tareas T2I e I2I)
number
Duración del video de entrada en segundos, 0.0 cuando no hay video de entrada (tareas wan3.0-video)
number
Duración del video de salida en segundos (tareas wan3.0-video)
string
Relación de aspecto del video generado, por ejemplo 16:9 (tareas wan3.0-video)
string
Resolución de la imagen (tareas T2I e I2I)
integer
Número de videos generados (tareas T2V)
number
Duración del video generado en segundos (tareas T2V)
string
Relación de resolución del video (tareas T2V)
string
Código de error de una solicitud fallida, informado en la RAÍZ del envelope y no bajo output (no se devuelve si la solicitud fue exitosa).
string
Información detallada sobre una solicitud fallida, informada en la RAÍZ del envelope y no bajo output (no se devuelve si la solicitud fue exitosa). Léela antes de recurrir a output.message.

Ejemplos

Entrada

Salida

Antes de lanzar

Los SDK crean una Idempotency-Key y la reutilizan para los reintentos automáticos. Para los reintentos manuales, reutiliza la clave original. Router puede mantener la conexión abierta hasta 10 minutos. Cuando una solicitud falla, Router envía un encabezado de respuesta X-Comfy-Error-Type que explica el motivo. Un 422 significa que Router rechazó la entrada antes de llamar al proveedor, y un 413 significa que el cuerpo de la solicitud era más grande de lo que Router acepta. Descarga los recursos generados de inmediato, porque las URL de resultados pueden caducar. Cualquier límite de tamaño mencionado en la descripción de un campo más arriba es el límite propio del proveedor para ese campo, citado de la especificación del proveedor. Router aplica un tope aparte al cuerpo completo de la solicitud, con el que cuentan los medios codificados en base64: consulta tamaño del cuerpo de la solicitud. Esta página documenta un modelo socio al que se llama a través de Comfy Router. El mismo paquete comfy-sdk / @comfyorg/sdk también incluye un segundo cliente, para ejecutar todo un gráfico de flujo de trabajo de ComfyUI en Comfy Cloud: Comfy(api_key=...) / new Comfy({ apiKey }), con client.workflows, client.assets y client.jobs. Consulta SDK de Comfy.

Encabezados

Autenticación, idempotencia, IDs de solicitud, agrupaciones de errores, ritmo de reintentos y límites de gasto.

Uso de la API de Router

Descubrimiento de modelos, errores de validación, reintentos y facturación.

Limitaciones

Lo que Router no hace hoy y qué usar en su lugar.