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": "参考图像 1(角色 1)",
"description": "第一个参考图像。在提示中将此主题标记为“character1”。格式:JPEG、JPG、PNG 或 WEBP。短边≥400px,建议720P或更高,最大10MB。",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
},
"image_url_2": {
"title": "参考图像 2(字符 2)",
"description": "可选的第二个参考图像。在提示中将此主题标记为“character2”。格式:JPEG、JPG、PNG 或 WEBP。留空可跳过。",
"type": "string"
},
"image_url_3": {
"title": "参考图像 3(角色 3)",
"description": "可选的第三个参考图像。在提示中将此主题标记为“character3”。格式:JPEG、JPG、PNG 或 WEBP。留空可跳过。",
"type": "string"
},
"image_url_4": {
"title": "参考图像 4(字符 4)",
"description": "可选的第四个参考图像。在提示中将此主题标记为“character4”。留空可跳过。",
"type": "string"
},
"image_url_5": {
"title": "参考图像 5(字符 5)",
"description": "可选的第五个参考图像。在提示中将此主题标记为“character5”。留空可跳过。",
"type": "string"
},
"image_url_6": {
"title": "参考图像 6(字符 6)",
"description": "可选的第六参考图像。在提示中将此主题标记为“character6”。留空可跳过。",
"type": "string"
},
"image_url_7": {
"title": "参考图像 7(字符 7)",
"description": "可选的第七个参考图像。在提示中将此主题标记为“character7”。留空可跳过。",
"type": "string"
},
"image_url_8": {
"title": "参考图像 8(字符 8)",
"description": "可选的第八个参考图像。在提示中将此主题标记为“character8”。留空可跳过。",
"type": "string"
},
"image_url_9": {
"title": "参考图像 9(字符 9)",
"description": "可选的第九个参考图像。在提示中将此主题标记为“character9”。留空可跳过。",
"type": "string"
},
"prompt": {
"title": "提示词",
"description": "描述场景、动作、摄像机和灯光。按照上面出现的顺序,使用字符 1、字符 2、字符 3 ... 来引用每个参考图像。最多 2500 个中文/5000 个非中文字符。",
"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": "纵横比(宽:高)",
"description": "输出视频宽高比。",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"default": "16:9"
},
"resolution": {
"title": "分辨率",
"description": "输出视频分辨率。该模型支持 720P 或 1080P。",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"duration": {
"title": "时长",
"description": "输出视频持续时间(以秒为单位)。允许值:3–15。",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"seed": {
"title": "种子",
"description": "可繁殖世代的可选种子。使用 0 让提供者随机化。",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "水印",
"description": "是否在生成的视频上保留提供商水印。",
"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.