Skip to main content
Referencia de API para wan/wan2.5-t2i-preview, que Comfy Router sirve desde Wan. Entrada: 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 mediante HTTP sin procesar. ID del modelo: wan/wan2.5-t2i-preview Endpoint: POST https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview
El mismo cuerpo, enviado a POST https://api.comfy.org/v2/models/wan/wan2.5-t2i-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 explica el estado, la cancelación y la recogida.

Esquema

Entrada

object
requerido
Ingresa la información básica, como las palabras del prompt, etc.
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 de la imagen y las características visuales esperadas. Admite chino e inglés, con una longitud no superior a 800 caracteres
string
El ID del modelo que se debe llamar para la generación de texto a imagen. NO está restringido en este componente: Comfy Router lo completa desde el segmento de ruta {model} de POST /v2/models/wan/{model}. Una llamada directa a la v1 de POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis DEBE proporcionarlo, y la enumeración de grafías aceptadas se encuentra en el componente propio de esa operación, WanImageGenerationRequest.
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
boolean
predeterminado:"true"
Habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero
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 de píxeles entre 1638400 (12801280) y 2073600 (14401440) con una relación de aspecto entre 1:4 y 4:1, por lo que 768*2700 es válido
boolean
predeterminado:"false"
Indica si se debe agregar el logotipo de marca de agua en la esquina inferior derecha
Generado a partir del esquema que Router expone en GET /v2/models/wan/wan2.5-t2i-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
Código de error de la solicitud fallida (no viene en la respuesta si la solicitud es exitosa)
string
Hora de finalización de la tarea
string
Información detallada sobre la solicitud fallida (no viene en la respuesta si la solicitud es exitosa)
string
prompt de entrada original (para tareas de video)
object[]
Lista de resultados de las 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 algunas tareas fallan)
string
Información de error de la imagen (se devuelve cuando algunas tareas fallan)
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 las 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 por 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 y 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 y 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, reportado en la RAÍZ del envelope en lugar de bajo output (no se devuelve si la solicitud tuvo éxito).
string
Información detallada sobre una solicitud fallida, reportada en la RAÍZ del envelope en lugar de bajo output (no se devuelve si la solicitud tuvo éxito). 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.