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": "Imagem de referência 1 (personagem1)",
"description": "Primeira imagem de referência. Marque este assunto no prompt como personagem1. Formato: JPEG, JPG, PNG ou WEBP. Lado curto ≥ 400px, recomendado 720P ou superior, máximo de 10MB.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
},
"image_url_2": {
"title": "Imagem de referência 2 (personagem2)",
"description": "Segunda imagem de referência opcional. Marque este assunto no prompt como personagem2. Formato: JPEG, JPG, PNG ou WEBP. Deixe em branco para pular.",
"type": "string"
},
"image_url_3": {
"title": "Imagem de referência 3 (personagem3)",
"description": "Terceira imagem de referência opcional. Marque este assunto no prompt como personagem3. Formato: JPEG, JPG, PNG ou WEBP. Deixe em branco para pular.",
"type": "string"
},
"image_url_4": {
"title": "Imagem de referência 4 (personagem4)",
"description": "Quarta imagem de referência opcional. Marque este assunto no prompt como personagem4. Deixe em branco para pular.",
"type": "string"
},
"image_url_5": {
"title": "Imagem de referência 5 (personagem5)",
"description": "Quinta imagem de referência opcional. Marque este assunto no prompt como personagem5. Deixe em branco para pular.",
"type": "string"
},
"image_url_6": {
"title": "Imagem de referência 6 (personagem6)",
"description": "Sexta imagem de referência opcional. Marque este assunto no prompt como personagem6. Deixe em branco para pular.",
"type": "string"
},
"image_url_7": {
"title": "Imagem de referência 7 (personagem7)",
"description": "Sétima imagem de referência opcional. Marque este assunto no prompt como personagem7. Deixe em branco para pular.",
"type": "string"
},
"image_url_8": {
"title": "Imagem de referência 8 (personagem8)",
"description": "Oitava imagem de referência opcional. Marque este assunto no prompt como personagem8. Deixe em branco para pular.",
"type": "string"
},
"image_url_9": {
"title": "Imagem de referência 9 (personagem9)",
"description": "Nona imagem de referência opcional. Marque este assunto no prompt como personagem9. Deixe em branco para pular.",
"type": "string"
},
"prompt": {
"title": "Prompt",
"description": "Descreva a cena, o movimento, a câmera e a iluminação. Consulte cada imagem de referência com caractere1, caracter2, caracter3… na ordem em que aparecem acima. Máximo de 2.500 caracteres chineses/5.000 caracteres não chineses.",
"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": "Proporção de aspecto (W:H)",
"description": "Proporção de aspecto de vídeo de saída.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"default": "16:9"
},
"resolution": {
"title": "Resolução",
"description": "Resolução de vídeo de saída. O modelo suporta 720P ou 1080P.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"duration": {
"title": "Duração",
"description": "Duração do vídeo de saída em 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": "Semente",
"description": "Semente opcional para gerações reproduzíveis. Use 0 para permitir que o provedor seja aleatório.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "Marca d’água",
"description": "Se a marca d’água do provedor deve ser mantida no vídeo gerado.",
"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.