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": "Immagine di riferimento 1 (personaggio1)",
"description": "Prima immagine di riferimento. Contrassegna questo argomento nel prompt come carattere1. Formato: JPEG, JPG, PNG o WEBP. Lato corto ≥ 400px, consigliato 720P o superiore, max 10MB.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
},
"image_url_2": {
"title": "Immagine di riferimento 2 (personaggio2)",
"description": "Seconda immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere2. Formato: JPEG, JPG, PNG o WEBP. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_3": {
"title": "Immagine di riferimento 3 (carattere3)",
"description": "Terza immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere3. Formato: JPEG, JPG, PNG o WEBP. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_4": {
"title": "Immagine di riferimento 4 (carattere 4)",
"description": "Quarta immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere4. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_5": {
"title": "Immagine di riferimento 5 (carattere5)",
"description": "Quinta immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere5. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_6": {
"title": "Immagine di riferimento 6 (carattere6)",
"description": "Sesta immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere6. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_7": {
"title": "Immagine di riferimento 7 (carattere7)",
"description": "Settima immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere7. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_8": {
"title": "Immagine di riferimento 8 (carattere 8)",
"description": "Ottava immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere8. Lascia vuoto per saltare.",
"type": "string"
},
"image_url_9": {
"title": "Immagine di riferimento 9 (carattere 9)",
"description": "Nona immagine di riferimento opzionale. Contrassegna questo argomento nel prompt come carattere9. Lascia vuoto per saltare.",
"type": "string"
},
"prompt": {
"title": "Prompt",
"description": "Descrivi la scena, il movimento, la telecamera e l'illuminazione. Fai riferimento a ciascuna immagine di riferimento con carattere1, carattere2, carattere3... nell'ordine in cui appaiono sopra. Massimo 2500 caratteri cinesi/5000 non cinesi.",
"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": "Proporzioni (L:A)",
"description": "Proporzioni video in uscita.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"default": "16:9"
},
"resolution": {
"title": "Risoluzione",
"description": "Risoluzione video in uscita. Il modello supporta 720P o 1080P.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"duration": {
"title": "Durata",
"description": "Durata del video in uscita in secondi. Valori consentiti: 3–15.",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"seed": {
"title": "Seme",
"description": "Seme opzionale per generazioni riproducibili. Utilizzare 0 per consentire al provider di randomizzare.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "Filigrana",
"description": "Se mantenere la filigrana del provider sul video generato.",
"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.