Usa la API de RunComfy para ejecutar minimax/minimax-h3/reference-to-video. Para entradas y salidas admitidas, consulta el esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
"reference_images": [
"https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
],
"aspect_ratio": "16:9",
"duration": 5,
"resolution": "2k"
}'Define la variable de entorno YOUR_API_TOKEN con tu clave API (gestión en Perfil) e incluye en cada solicitud un token Bearer en la cabecera Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
"reference_images": [
"https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
],
"aspect_ratio": "16:9",
"duration": 5,
"resolution": "2k"
}'Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Proporciona una URL HTTPS públicamente accesible. El host debe permitir peticiones del servidor (sin login/cookies), sin rate limit agresivo ni bloqueo de bots. Recomendado: imágenes ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min a 720p). Para activos privados, URLs estables o firmadas.
{
"type": "object",
"title": "Esquema de entrada",
"required": [
"prompt",
"reference_images",
"aspect_ratio",
"duration",
"resolution"
],
"properties": {
"prompt": {
"title": "Instrucción",
"description": "Descripción de la escena, la interacción, el movimiento y el estilo visual. Entre 1 y 4000 caracteres.",
"type": "string",
"default": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look."
},
"reference_images": {
"title": "Imágenes de referencia",
"description": "Imágenes de referencia que guían el sujeto, el producto, el estilo o la composición. Hasta 9. Se requiere al menos una imagen o un vídeo de referencia.",
"type": "array",
"default": [
"https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
],
"items": {
"type": "string",
"format": "image_uri"
},
"maxItems": 9
},
"reference_videos": {
"title": "Vídeos de referencia",
"description": "Vídeos de referencia que guían el movimiento, el ritmo o la interacción. Hasta 3. Se requiere al menos una imagen o un vídeo de referencia.",
"type": "array",
"items": {
"type": "string",
"format": "video_uri"
},
"maxItems": 3
},
"reference_audios": {
"title": "Audios de referencia",
"description": "Audios de referencia opcionales. Hasta 3. No pueden proporcionarse sin una imagen o un vídeo de referencia.",
"type": "array",
"items": {
"type": "string",
"format": "audio_uri"
},
"maxItems": 3
},
"aspect_ratio": {
"title": "Relación de aspecto",
"description": "Relación de aspecto del vídeo de salida.",
"type": "string",
"enum": [
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "16:9"
},
"duration": {
"title": "Duración",
"description": "Duración del vídeo generado en segundos.",
"type": "integer",
"minimum": 5,
"maximum": 15,
"default": 5
},
"resolution": {
"title": "Resolución",
"description": "Resolución del vídeo de salida.",
"type": "string",
"enum": [
"2k"
],
"default": "2k"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL de una sola imagen"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL de un solo vídeo"
},
"images": {
"type": "array",
"description": "varias URLs de imagen",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "varias URLs de vídeo",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy es la principal ComfyUI plataforma, ofreciendo ComfyUI en línea entorno y servicios, junto con flujos de trabajo de ComfyUI con impresionantes imágenes. RunComfy también ofrece AI Models, permitiendo a los artistas aprovechar las últimas herramientas de AI para crear arte increíble.