核心用法
HappyHorse on RunAPI 是一个多模态 AI 视频生成技能，通过统一的 runapi CLI 或各语言 SDK 提供四种核心能力：
1. 文生视频（text-to-video）：输入文本描述生成 3-15 秒 720p/1080p 视频片段
2. 角色参考视频（character）：基于 1-9 张有序参考图生成保持角色一致性的视频
3. 图生视频（image-to-video）：以单张首帧图像为起点，智能生成动态视频
4. 视频编辑（edit-video）：对 3-60 秒源视频进行基于提示词的智能编辑，支持最多 5 张参考图引导
运行时区分两条路径：CLI 路径适用于一次性生成、调试、手动测试场景；SDK 路径适用于应用集成、后端服务、生产工作流等需要代码内调用的场景。SDK 覆盖 JavaScript/TypeScript、Ruby、Go 等主流语言。
显著优点
多模态输入灵活性：同时支持纯文本、单图、多图序列作为生成起点，满足不同创作场景需求。角色参考模式尤其适合 IP 内容、虚拟形象、故事连续性创作。
版本与参数可控：提供 HappyHorse 1.0 各变体（t2v/r2v/i2v）的显式选择，输出分辨率支持 720p 和 1080p，视频时长 3-15 秒可调。
工程化友好：CLI 支持同步/异步双模式，异步任务可配合 runapi wait 轮询；SDK 提供标准化客户端方法（create/get/run）和错误类，便于异常处理。
平台中立接入：RunAPI 作为统一接口层，屏蔽底层模型差异，未来可平滑切换或对比不同提供商模型。
潜在缺点与局限性
临时存储限制：生成文件的 URL 有效期仅 7 天，必须自行迁移至持久化存储，增加了基础设施成本。
视频时长与分辨率上限：单次生成最长 15 秒（编辑模式 60 秒源素材），1080p 对于专业影视制作可能不足，且不支持 4K 或自定义帧率。
异步复杂度：生产环境需自行实现轮询或 webhook 回调机制，SDK 未暴露高级别事件监听抽象。
区域与合规未明确：文档未说明数据驻留区域、内容安全审核策略及生成内容的版权归属条款。
适合的目标群体
- 短视频创作者与 MCN 机构：快速生成概念验证、分镜预览、营销素材
- 游戏与动画工作室：角色一致性视频、动态立绘、宣传片段批量生产
- AI 应用开发者：需集成视频生成功能的 SaaS、创意工具、社交平台
- 广告与电商运营：商品动态展示、场景化视频素材自动化生成
使用风险
性能风险：视频生成任务耗时从秒级到分钟级不等，高峰期可能存在队列等待；异步模式设计不当易导致任务积压或状态同步延迟。
依赖与供应风险：CLI 通过 Homebrew 分发，SDK 依赖 npm/gem/go mod 生态；RunAPI 服务本身的可用性、速率限制及定价变动直接影响业务连续性。
成本风险：视频类模型token消耗通常高于文本模型，高频调用或高分辨率输出可能产生意外账单；临时存储迁移不及时可能导致数据丢失后的重复生成成本。
安全与合规风险：API 密钥需妥善管理，CLI 的 auth import-token 操作在共享环境中存在泄露可能；生成内容需遵守平台 AUP 及当地法规，未明确审核机制前存在合规隐患。