modelApiDoc_getStartedBeforeModelhappyhorse/happyhorse-1.0/reference-to-videomodelApiDoc_getStartedAfterModel modelApiDoc_getStartedMid modelApiDoc_schemaLinkmodelApiDoc_getStartedAfterSchema
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."
}'modelApiDoc_authP1 YOUR_API_TOKEN modelApiDoc_authP2 modelApiDoc_profilemodelApiDoc_authP3 Authorization modelApiDoc_authP4 Authorization: Bearer $YOUR_API_TOKENmodelApiDoc_authP5
modelApiDoc_submitBody
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."
}'modelApiDoc_monitorBody
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"modelApiDoc_retrieveBody
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"modelApiDoc_cancelBody
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"modelApiDoc_hostedFileBody
{
"type": "object",
"title": "modelApiDoc_navInputSchema",
"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": "modelApiDoc_outDescImage"
},
"video": {
"type": "string",
"format": "uri",
"description": "modelApiDoc_outDescVideo"
},
"images": {
"type": "array",
"description": "modelApiDoc_outDescImages",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "modelApiDoc_outDescVideos",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.