https://api.comfy.org. Crea una clave API en tu espacio de trabajo de Comfy y luego llama a cualquier modelo con los SDK oficiales de Python y TypeScript o por HTTP simple. La facturación es de pago por uso: de forma predeterminada, cada solicitud toma créditos del saldo de tu espacio de trabajo, sin suscripción. Consulta los precios de Router para ver las tarifas y otras opciones de facturación.
¿Haces seguimiento del gasto con LiteLLM? Router informa el costo en USD de una ejecución síncrona en el encabezado que LiteLLM lee, así no tienes que mantener una tabla de precios. Consulta Usar Comfy Router con LiteLLM.
Crear una clave API
Crea una clave en tu espacio de trabajo de Comfy. En una terminal compatible con Bash, establece:Mantén las claves API en tu servidor o en tu entorno local. Estos ejemplos son para una terminal o un servidor, no para JavaScript del navegador.Router cobra créditos por solicitud. Si tu espacio de trabajo no tiene saldo de créditos, la primera llamada real devuelve
402 con error_type: insufficient_credits. Esta comprobación se ejecuta antes de la validación del cuerpo, así que un espacio de trabajo sin fondos puede devolver 402 incluso para una solicitud no válida. Agrega créditos en facturación del espacio de trabajo antes de depurar el cuerpo de la solicitud.Encolar una solicitud
Elige tu idioma y ejecuta el ejemplo. La generación puede tardar unos minutos.Cada llamada de envío del SDK crea una clave de idempotencia y la reutiliza para los reintentos automáticos.
El ejemplo de cURL crea una con
uuidgen. Si no está disponible, usa otro generador de UUID.
Para obtener detalles sobre el estado, la cancelación y la recopilación, consulta Entrega en cola.Imagen a video y referencia a video
La misma solicitud de Seedance acepta entradas de imagen, video y audio. Agrega elementos acontent y define el role de cada uno. Los roles que envías deciden la operación que ejecuta Router. El precio sigue los tipos de medio de content, no los roles: una solicitud con cualquier entrada de video se factura como video a video; si no, una con cualquier imagen se factura como imagen a video, y una solicitud solo de texto se factura como texto a video. Algunos modelos cobran la misma tarifa para texto a video y para imagen a video.
Una
url de imagen puede ser una URL pública o una cadena data:image/<format>;base64,<content>. Envía, consulta y recoge exactamente como en el inicio rápido de arriba. Solo cambia el cuerpo.
Imagen a video
Referencia a video
ratio o envía adaptive, porque una relación concreta se rechaza con un 400. El esquema de la solicitud es compartido en toda la familia Seedance y puede listar roles que un modelo ignora, así que revisa el campo x-comfy-router-input-modalities en el esquema de entrada de cada modelo para conocer los tipos de entrada que ese modelo acepta. Por ejemplo, reference_video y reference_audio necesitan un modelo que liste video o audio ahí.
Próximos pasos
Explorar modelos
Explora los modelos disponibles y encuentra ejemplos de solicitudes para cada modelo.
Usar la API del Router
Conoce cómo funciona el descubrimiento de modelos, los esquemas, las solicitudes en cola, los errores y la facturación.