HappyHorse 1.0 — RunComfy专业套件

runcomfy.com · 文本转视频 · GitHub

HappyHorse 1.0——目前在Artificial Analysis Video Arena排名第一（文本转视频Elo评分1333 / 图像转视频Elo评分1392）——托管于RunComfy Model API。支持生成原生1080p视频，并具备生成过程同步音频（对话、环境音、拟音）和多镜头角色一致性特性。

bash

npx skills add agentspace-so/runcomfy-skills --skill happyhorse-1-0 -g

模型选择指南（与同类模型对比）

你的需求	推荐模型
具备角色/服装一致性的多镜头故事	HappyHorse 1.0
生成过程中同步输出原生音频	HappyHorse 1.0
当前盲选排名第一的视频生成模型	HappyHorse 1.0
带精准唇形同步的对话+参考视频	Seedance 2.0 Pro
精细运动控制+多参考条件输入	Wan 2.7
超快速迭代（每帧耗时不到1秒）	LTX 2
现有素材的电影级运动编辑	Kling Video O1

如果用户明确提到“HappyHorse”/“happy horse video”，无论需求如何都路由到此模型。

前置条件

RunComfy CLI — 执行
```
npm i -g @runcomfy/cli
```
安装
RunComfy账号 — 执行
```
runcomfy login
```
会打开浏览器设备码登录流程
CI/容器环境 — 设置环境变量
```
RUNCOMFY_TOKEN=<token>
```
替代
```
runcomfy login
```

接口端点与输入规则

happyhorse/happyhorse-1-0/text-to-video

字段	类型	是否必填	默认值	说明
`prompt`	字符串	是	—	最多2500字符，支持6种语言（中/英/日/韩/德/法）
`aspect_ratio`	枚举	否	`16:9`	仅支持 `16:9` 、 `9:16` 、 `1:1` 、 `4:3` 、 `3:4`
`resolution`	枚举	否	`1080P`	可选 `720P` 或 `1080P`
`duration`	整数	否	5	取值范围3-15秒
`seed`	整数	否	0	取值范围0到2^31-1，重复使用可对比不同变体
`watermark`	布尔值	否	true	是否添加服务商水印

调用方式

默认配置（16:9 1080p 5秒）：

bash

runcomfy run happyhorse/happyhorse-1-0/text-to-video \
  --input '{"prompt": "<用户提示词>"}' \
  --output-dir <绝对路径>

竖版短视频（9:16，8秒，无水印）：

bash

runcomfy run happyhorse/happyhorse-1-0/text-to-video \
  --input '{
    "prompt": "<用户提示词>",
    "aspect_ratio": "9:16",
    "duration": 8,
    "watermark": false
  }' \
  --output-dir <绝对路径>

低成本测试（720p）：

bash

runcomfy run happyhorse/happyhorse-1-0/text-to-video \
  --input '{"prompt": "<用户提示词>", "resolution": "720P", "duration": 3}' \
  --output-dir <绝对路径>

CLI会提交请求，每2秒轮询一次直到任务完成，然后将结果中所有

*.runcomfy.net

*.runcomfy.com

的URL下载到

--output-dir

指定路径。标准输出为结果JSON，标准错误输出为进度信息。

提示词技巧——有效方法

描述随时间变化的动作，而非静态画面。比如“一位女士从窗边转身，走到书桌前两步，拿起杯子，举到脸前，喝一口”比“一位女士喝咖啡”效果更好。

用直白的英语描述镜头与机位。将镜头描述放在开头：

"Wide shot. ..."

"Tracking shot. ..."

"Locked tripod, low angle. ..."

会被当作真实指令。可以指定镜头质感：

"35mm anamorphic"

、

"shallow DOF"

、

"crushed shadows"

。

迭代时每个片段只聚焦一个视觉节拍。不要堆砌“她走路AND狗跑AND车经过”。先选定一个节拍，优化到位后再通过多镜头提示词叠加内容。

多镜头一致性——描述两个节拍时，每个节拍都要重复锚点信息：

"Shot 1: 穿红色羊毛外套、蓝色围巾的高个女士在雨中小巷。Shot 2: 同一位穿红外套/蓝围巾的女士，现在躲在遮阳篷下。"

HappyHorse能保持角色外观，但需要明确的锚点信息。

音频指令——直接描述你想要的声音：

"远处的寺庙钟声，湿路面上的脚步声，无对话"

或

"温暖友好的语气，英语"

。

反模式：

静态画面描述（无时间相关动词）→ 动作会模糊不清
冲突的风格指令→ 相互抵消
超过2500字符的提示词→ 效果下降
超出5种支持范围的宽高比→ 返回422错误

适用场景

使用场景	选择HappyHorse 1.0的原因
具备一致角色的多镜头品牌故事	原生跨镜头身份保留能力
需要片段内旁白+环境音的讲解类视频	生成过程中同步输出音频
多语言短视频广告	支持6种语言提示词，脚本质量无下降
电影级1080p交付	原生1080p输出，达到广播级标准
综合视频质量盲选排名第一	在Artificial Analysis Video Arena排名第一

示例提示词（已验证可生成优质结果）

模型页面示例（电影级场景）：

Wide shot. A lone astronaut in dusty orange suit with blue-gray harness
skis across lunar plain, leaving parallel tracks in gray regolith.
Mid-stride, poles planted, pushing in 1/6th gravity with subtle upward
drift. Fine dust haze along ski tracks. Crescent Earth above lunar
horizon, blue-white glow against black sky. Raw sunlight, crushed
shadows, no fill. 8K photorealistic.

多镜头一致性示例：

Shot 1: Medium close-up. A woman in a navy trench coat enters a
rain-slick neon-lit Tokyo alley, looks left, holds up an umbrella.
Shot 2: Same woman in same navy trench, now under the awning of a
ramen shop, shaking water off the umbrella. Warm interior glow, soft
chatter, gentle rain on metal roof in the audio.

竖版平台原生示例：

9:16 vertical short. A barista in a black apron pulls a single
espresso shot, steam rising into the morning sun, rich crema slowly
forming. Close-up handheld, shallow DOF, warm cafe ambience and the
hiss of the steam wand.

局限性

时长上限15秒——如需更长叙事，可拆分为多镜头提示词后拼接
宽高比限制——仅支持文档中列出的5种；超宽电影级比例会被裁剪或拒绝
仅生成过程同步音频——无法传入外部音频驱动唇形同步。如需音频驱动唇形同步，请使用Wan 2.7（支持
```
audio_url
```
参数）或Seedance 2.0 Pro
本模板不支持免费图像转视频——HappyHorse通过单独流水线支持图像转视频；此处的文本转视频接口仅支持文本输入

退出码

runcomfy

CLI使用sysexits风格的退出码：

代码	含义
0	成功
64	CLI参数错误
65	输入JSON错误/规则不匹配（例如 `duration: 30` 会返回422错误）
69	上游服务5xx错误
75	可重试：超时/429限流
77	未登录或令牌被拒绝

完整参考：docs.runcomfy.com/cli/troubleshooting

工作原理

本技能调用

runcomfy run happyhorse/happyhorse-1-0/text-to-video

，传入符合规则的JSON请求体

CLI携带用户的Bearer令牌向

https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1-0/text-to-video

发送POST请求

Model API返回
```
request_id
```
；CLI每2秒轮询
```
GET .../requests/<id>/status
```
获取状态
任务完成后，CLI调用
```
GET .../requests/<id>/result
```
获取结果，并将所有主机后缀为
```
.runcomfy.net
```
或
```
.runcomfy.com
```
的URL下载到
```
--output-dir
```
指定路径。其他URL仅列出不下载
轮询时按
```
Ctrl-C
```
会发送
```
POST .../requests/<id>/cancel
```
请求，避免为已停止的GPU使用付费

本技能不具备的功能

不是自托管视频生成器。不提供独立能力——依赖可用的RunComfy账号。

安全与隐私

令牌存储：
```
runcomfy login
```
会将API令牌写入
```
~/.config/runcomfy/token.json
```
，权限为0600（仅所有者可读写）。在CI/容器环境中可设置
```
RUNCOMFY_TOKEN
```
环境变量完全绕过文件存储
输入边界：用户提示词通过
```
--input
```
以JSON字符串形式传递给CLI。CLI不会对提示词进行shell展开；直接通过HTTPS将JSON请求体传输给Model API。提示词内容不存在shell注入风险
第三方内容：你传入的图像/蒙版/视频URL由RunComfy模型服务器获取，而非本地CLI。请将外部URL视为不可信；基于图像的提示词注入是所有图像编辑/视频编辑模型的已知风险
出站端点：仅与
```
model-api.runcomfy.net
```
（请求提交）和
```
*.runcomfy.net
```
/
```
*.runcomfy.com
```
（生成结果下载白名单）通信。无遥测，无回调
生成文件大小限制：CLI会中止任何超过2 GiB的单个下载，防止恶意或异常模型输出占满磁盘

happyhorse-1-0

NPX安装

标签

SKILL.md 内容（中文）

HappyHorse 1.0 — RunComfy专业套件

模型选择指南（与同类模型对比）

前置条件

接口端点与输入规则

`happyhorse/happyhorse-1-0/text-to-video`

调用方式

提示词技巧——有效方法

适用场景

示例提示词（已验证可生成优质结果）

局限性

退出码

工作原理

本技能不具备的功能

安全与隐私