img_uuid，然后轮询或接收 HTTPS 回调以获取结果。用于视频生成的 HappyHorse 1.1 API
通过独立的 GoEnhance 开放 API 访问 HappyHorse 1.1 API，可进行文本生成视频、首帧图像生成视频或独立的参考图像工作流。提交异步任务，保存返回的
创建 API 密钥
选择合适的 HappyHorse API 模式
首帧图像生成视频
添加 image_url 以对首帧进行动画处理。图像必须为 JPEG、PNG 或 WEBP 格式，尺寸至少 300px，大小不超过 10MB，且比例在文档规定的 1:2.5 到 2.5:1 范围内。
参考图像视频
使用 model: happyhorse-1-1-ref 并提供 1–9 个 image_urls 中的 URL。在提示词中分别引用每个源，如 [Image 1]、[Image 2] 等。
在将任务发送到生产队列之前，请验证所选的请求模式。
HappyHorse 1.1 API 功能与限制
两种标准输入模式
仅使用提示词进行文本生成视频，或添加一个 <code>image_url</code> 进行首帧图像生成视频。
独立多参考模型
使用 <code>happyhorse-1-1-ref</code> 并提供 1–9 个必需的参考图像 URL；该模式不支持纯文本生成视频。
3–15 秒时长
将 <code>duration</code> 设置为 3 到 15 秒之间的整数。文档默认值为 5 秒。
720p 或 1080p 输出
选择 <code>720p</code> 或 <code>1080p</code>。文档默认值为 <code>720p</code>。
竖屏、方形和横屏比例
标准路径支持 16:9、9:16、1:1、4:3 和 3:4。参考模式还列出了 4:5 和 5:4。
轮询与回调
保留 <code>img_uuid</code>，轮询作业详情端点，或提供公共 HTTPS 回调 URL 以获取状态更新。
GoEnhance 的文档显示每 token 价格为 $0.02，目前将这些费率标记为限时优惠。
HappyHorse 1.1 API 定价
720p：每秒 $0.104
720p 生成消耗每秒 5.2 个代币。5 秒的请求消耗 26 个代币，按文档转换汇率计算为 $0.52。
1080p：每秒 $0.144
1080p 生成消耗每秒 7.2 个 token，相当于每生成一秒收费 $0.144。
按时长估算
将选定的每秒费率乘以所需的 3–15 秒时长。在进行生产批处理之前，请查看实时 API 参考文档，因为促销价格可能会发生变化。
集成 HappyHorse 1.1 API
1
1. 创建并保护 API 密钥
创建一个 GoEnhance 密钥，并从受信任的服务器端代码中将其作为 bearer 授权发送。
2
2. 选择模型
选择
happyhorse-1-1 进行纯提示词或首帧生成，或选择 happyhorse-1-1-ref 以使用 1–9 张参考图像。 3
3. 构建并验证有效载荷
提供所需的提示词，然后针对所选模式验证图像字段、时长、分辨率、比例和回调 URL。
4
4. 提交视频任务
向
https://api.goenhance.ai/api/v1/videos/generations 发送 POST 请求并存储返回的 img_uuid。 5
5. 跟踪状态
轮询
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... 或在公共 HTTPS 回调中接收状态变更。 6
6. 处理最终结果
以幂等方式处理成功和失败结果，验证返回的资产，并避免在轮询和回调重叠时产生重复的下游工作。
将结构化生成请求连接到评审、存储和交付工作流。
HappyHorse API 的开发者用例
营销视频变体
根据结构化提示词生成短视频动态概念，用于创意评审和下游编辑。
产品与品牌动态
在后端控制时长、分辨率和完成处理的同时，为已批准的首帧添加动画效果。
角色交互研究
使用参考模型来描述已批准源图像中的主体应如何在同一场景中共同呈现。
故事板预可视化
在投入更大规模的生产流程之前，将镜头描述转化为可供评审的剪辑片段。
本地化创意流水线
为区域变体参数化提示词，同时保持任务提交和监控的一致性。
自动化资产队列
在后端服务中连接生成、任务状态持久化、回调、存储和人工审批。
关于定价、请求模式、输入限制和异步任务处理的解答。