Usa la API de RunComfy para ejecutar happyhorse/happyhorse-1.0/reference-to-video. Para entradas y salidas admitidas, consulta el esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
"prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
}'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/happyhorse/happyhorse-1.0/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
"prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
}'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": [
"image_url_1",
"prompt"
],
"properties": {
"image_url_1": {
"title": "Imagen de referencia 1 (carácter1)",
"description": "Primera imagen de referencia. Etiqueta este tema en el mensaje como personaje1. Formato: JPEG, JPG, PNG o WEBP. Lado corto ≥ 400px, recomendado 720P o superior, máximo 10MB.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
},
"image_url_2": {
"title": "Imagen de referencia 2 (personaje2)",
"description": "Segunda imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje2. Formato: JPEG, JPG, PNG o WEBP. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_3": {
"title": "Imagen de referencia 3 (personaje3)",
"description": "Tercera imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje3. Formato: JPEG, JPG, PNG o WEBP. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_4": {
"title": "Imagen de referencia 4 (personaje4)",
"description": "Cuarta imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje4. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_5": {
"title": "Imagen de referencia 5 (personaje5)",
"description": "Quinta imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje5. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_6": {
"title": "Imagen de referencia 6 (personaje6)",
"description": "Sexta imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje6. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_7": {
"title": "Imagen de referencia 7 (personaje7)",
"description": "Séptima imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje7. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_8": {
"title": "Imagen de referencia 8 (personaje8)",
"description": "Opcional octava imagen de referencia. Etiqueta este tema en el mensaje como personaje8. Déjelo en blanco para omitir.",
"type": "string"
},
"image_url_9": {
"title": "Imagen de referencia 9 (personaje9)",
"description": "Novena imagen de referencia opcional. Etiqueta este tema en el mensaje como personaje9. Déjelo en blanco para omitir.",
"type": "string"
},
"prompt": {
"title": "Prompt",
"description": "Describe la escena, el movimiento, la cámara y la iluminación. Consulte cada imagen de referencia con carácter1, carácter2, carácter3… en el orden en que aparecen arriba. Máximo 2500 caracteres chinos / 5000 no chinos.",
"type": "string",
"default": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look.",
"maxLength": 5000
},
"aspect_ratio": {
"title": "Relación de aspecto (W:H)",
"description": "Relación de aspecto del vídeo de salida.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"default": "16:9"
},
"resolution": {
"title": "Resolución",
"description": "Resolución de vídeo de salida. El modelo admite 720P o 1080P.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"duration": {
"title": "Duración",
"description": "Duración del vídeo de salida en segundos. Valores permitidos: 3–15.",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"seed": {
"title": "Semilla",
"description": "Semilla opcional para generaciones reproducibles. Utilice 0 para permitir que el proveedor realice la aleatorización.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "Filigrana",
"description": "Si se debe mantener la marca de agua del proveedor en el video generado.",
"type": "boolean",
"default": false
}
}
}{
"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.