Inicio rápido
Crea una clave en tu espacio de trabajo de Comfy y expórtala comoCOMFY_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 directo.
ID del modelo: minimax/minimax-h3
Endpoint: POST https://api.comfy.org/v2/models/minimax/minimax-h3
- Esperar el resultado
- Enviar y recoger más tarde
El mismo cuerpo, enviado a
POST https://api.comfy.org/v2/models/minimax/minimax-h3/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 del resultado.Esquema
Entrada
boolean
Indica si se debe agregar una marca de agua AIGC a la salida. El valor predeterminado es false.
string
Opcional. URL que recibe los cambios de estado de la tarea después de la verificación del desafío.
object[]
requerido
Elementos de contenido que impulsan la generación. Debe contener un elemento de texto no vacío; de forma opcional, agrega imágenes first_frame/last_frame o medios reference_*.
object
Fuente de audio. Requerido para los elementos audio_url.
string
Una URL accesible públicamente, una referencia mm_file://{file_id} o un data URI.
object
Fuente de imagen. Requerido para los elementos image_url.
string
Una URL accesible públicamente, una referencia mm_file://{file_id} o un data URI.
string
Rol de un elemento multimedia. Opciones: first_frame, last_frame, reference_image, reference_video, reference_audio, base_video. Los roles de fotograma clave y los roles reference_* son mutuamente excluyentes dentro de una solicitud; base_video marca el video de origen de una solicitud de regeneración de video.
string
El texto del prompt. Se requiere exactamente un elemento de texto no vacío por solicitud.
string
requerido
Tipo de elemento de contenido. Opciones: text, image_url, video_url, audio_url.
object
Fuente de video. Requerido para los elementos video_url.
string
Una URL accesible públicamente, una referencia mm_file://{file_id} o un data URI.
integer
requerido
Duración del video en segundos. Comfy Router acepta de 4 a 15 y rechaza cualquier valor fuera de ese rango antes de llamar al proveedor. La documentación propia de MiniMax para este modelo indica de 5 a 15; los nodos ComfyUI MiniMax H3 ofrecen de 4 a 15 y se ha observado que una generación de 4 segundos se completa correctamente, por lo que aquí se acepta 4.Rango: de
4 a 15string
ID del modelo. Opciones: MiniMax-H3. Quienes llaman al Router pueden omitir este campo o enviar null; el Router inyecta el modelo seleccionado por la ruta de la solicitud antes del despacho al proveedor.
string
Relación de aspecto. Opciones: adaptive (predeterminada), 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Es requerida y no debe ser adaptive para texto a video; se ignora (se trata como adaptive) en la generación con primer fotograma o último fotograma.
string
requerido
Resolución del video. Opciones: 2K, 768P. El valor se compara sin distinguir mayúsculas y minúsculas y se normaliza antes del despacho, así que
2k y 768p se aceptan y se envían como 2K y 768P.Valores posibles: 2K, 2k, 768P, 768pinteger
Semilla aleatoria en [-1, 2^32 - 1]; si se omite o es -1, es aleatoria.Formato:
int64GET /v2/models/minimax/minimax-h3/openapi.json, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor.
Salida
object
Una tarea de generación de video de Minimax V2.
object
Salida generada; está presente cuando el estado es succeeded.
string
El prompt de video mejorado que produce una tarea h3_context_ir completada correctamente.
string
URL con tiempo limitado del MP4 generado. Consulta de nuevo para obtener una URL renovada.
number
La duración del video generado en segundos.
object
Detalles del error cuando el estado es failed; incluye code y message.
string
El ID de la tarea.
string
El modelo usado para la tarea.
string
La relación de aspecto real del video generado.
string
La resolución del video generado.
string
Estado de la tarea. Opciones: queued, running, succeeded, failed, cancelled, expired.
string
El tipo de la tarea.
object
El uso registrado para la tarea.
integer
integer
number
number
integer
number
integer
Ejemplos
Entrada
Salida
duration, ratio, resolution, seed, aigc_watermark y callback_url, y ninguno de ellos selecciona una renderización silenciosa. Por eso, un pipeline que pretenda superponer su propia voz en off sobre el clip tiene que silenciar o quitar primero la pista devuelta, o hará el mux sobre un clip que ya está hablando. El prompt es lo que guía el audio: describe el diálogo, los efectos de sonido y la música en el mismo bloque de prompt que la toma. Consulta la guía de prompts de MiniMax H3 para saber cómo estructurar uno, y la descripción general de MiniMax H3 para saber qué hace el modelo en ComfyUI.
La URL del video caduca. Router vuelve a alojar el MP4 y responde con una URL firmada por Comfy válida durante 12 horas, y recurre al enlace propio de MiniMax, de vida más corta, cuando el re-alojamiento falla. La descripción de task.content.url en el esquema de respuesta anterior te indica que consultes de nuevo para obtener una URL actualizada: esa es la redacción propia de MiniMax para su API, trasladada sin cambios, y Router no expone la ruta de consulta de tareas de MiniMax. Volver a leer la ruta de resultados de una solicitud en cola devuelve el documento de resultado almacenado mientras la solicitud se conserva durante 24 horas después de completarse, pero nada documenta que esa lectura genere una URL recién firmada. Descarga el MP4 cuanto antes en lugar de guardar el enlace.
Antes de lanzar
Los SDK crean unaIdempotency-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.