使用 RunComfy 的 API 运行 community/fantasy-portrait/image-to-video。 可接受的输入与输出请参阅模型的 数据结构说明。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
"160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
"155_positive_prompt": "woman acting"
}'将 YOUR_API_TOKEN 环境变量设置为您的 API 密钥(在 个人资料中管理密钥),并在每个请求的 Authorization 标头中以 Bearer 令牌形式携带: Authorization: Bearer $YOUR_API_TOKEN。
提交异步生成任务,将立即获得 request_id 以及用于查询状态、获取结果和取消的 URL。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"143_image": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
"160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
"155_positive_prompt": "woman acting"
}'根据 request_id 获取当前状态("in_queue"、"in_progress"、"completed" 或 "cancelled")。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"获取指定 request_id 的最终输出与元数据;若任务未完成,响应会返回当前状态,便于继续轮询。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"通过 request_id 取消排队中的任务;进行中的任务无法取消。
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"请提供可公网访问的 HTTPS 地址。确保目标主机允许服务端拉取(无需登录或 Cookie)、未被限流或拦截爬虫。建议:图片 ≤ 50 MB(约 4K),视频 ≤ 100 MB(约 720p 下 2–5 分钟)。私有资源请使用稳定或预签名 URL。
{
"type": "object",
"title": "输入结构",
"required": [
"143_image",
"160_video",
"155_positive_prompt"
],
"properties": {
"160_video": {
"title": "参考视频",
"description": "必填。提供生成时需要参考的动作。",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4"
},
"143_image": {
"title": "人像图片",
"description": "必填。提供需要制作成动画的人物。",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png"
},
"155_positive_prompt": {
"title": "提示词",
"description": "必填。描述希望呈现的动作、表情或画面方向。",
"type": "string",
"default": "woman acting"
},
"169_valuex170_value": {
"title": "分辨率(宽:高)",
"description": "可从 10 种正方形、竖版或横版尺寸中选择,默认值为 720x720 (1:1)。",
"type": "string",
"enum": [
"480x480 (1:1)",
"720x720 (1:1)",
"480x720 (2:3)",
"720x480 (3:2)",
"540x960 (9:16)",
"576x1024 (9:16)",
"720x1280 (9:16)",
"960x540 (16:9)",
"1024x576 (16:9)",
"1280x720 (16:9)"
],
"default": "720x720 (1:1)"
},
"174_value": {
"title": "帧数",
"description": "可选择 81 或 141 帧,默认值为 81。",
"type": "integer",
"enum": [
81,
141
],
"default": 81
},
"163_frame_rate": {
"title": "帧率",
"description": "播放帧率可设为 12–24 FPS,默认值为 16。",
"type": "integer",
"default": 16,
"minimum": 12,
"maximum": 24
},
"150_strength": {
"title": "人像强度",
"description": "控制 Fantasy Portrait 嵌入对视频的影响。数值越高,人物特征与表情越突出。范围为 0.3–2.0,默认值为 1。",
"type": "float",
"default": 1,
"minimum": 0.3,
"maximum": 2
},
"149_seed": {
"title": "种子",
"description": "用于复现相近结果或生成不同版本的整数,默认值为 96860978。",
"type": "integer",
"default": 96860978
},
"149_steps": {
"title": "采样步数",
"description": "去噪迭代次数。增加步数可能改善细节和稳定性,但耗时也会增加。范围为 6–20,默认值为 6。",
"type": "integer",
"default": 6,
"minimum": 6,
"maximum": 20
},
"149_cfg": {
"title": "引导强度",
"description": "调节提示词遵循程度与创作变化之间的平衡。范围为 0.6–2.0,默认值为 1。",
"type": "float",
"default": 1,
"minimum": 0.6,
"maximum": 2
},
"149_shift": {
"title": "采样偏移",
"description": "调整采样进程。数值越高,动作或风格越强,但稳定性可能降低。范围为 1–15,默认值为 5。",
"type": "integer",
"default": 5,
"minimum": 1,
"maximum": 15
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "单张图片 URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "单个视频 URL"
},
"images": {
"type": "array",
"description": "多张图片 URL",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "多个视频 URL",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy 是首选的 ComfyUI 平台,提供 ComfyUI 在线 环境和服务,以及 ComfyUI 工作流 具有惊艳的视觉效果。 RunComfy还提供 AI Models, 帮助艺术家利用最新的AI工具创作出令人惊叹的艺术作品。