HappyHorse 1.0 支持文生视频、图生视频和视频编辑，具备高度还原的动态画面生成能力，能够精准理解文本语义，输出流畅自然、细节丰富的高质量视频。
模型参数
- 模型ID：
happyhorse-1.0-t2v/happyhorse-1.0-i2v/happyhorse-1.0-r2v/happyhorse-1.0-video-edit
- 模型价格：你可以在模型广场查看最新价格信息
- 调用入口：
https://geekai.co/api/v1/videos/generations
- 模型参数：参考视频 API 手册
- API认证：获取 API KEY
HappyHorse 1.0 宽高比 aspect_ratio 参数支持以下取值：
HappyHorse 1.0 不同宽高比对应的输出视频分辨率 resolution 值如下：
| 分辨率 | 宽高比 | 输出视频分辨率（宽x高） |
|---|
| 720P | 16:9 | 1280x720 |
| 9:16 | 720x1280 |
| 1:1 | 960x960 |
| 4:3 | 1104x832 |
| 3:4 | 832x1104 |
| 1080P | 16:9 | 1920x1080 |
| 9:16 | 1080x1920 |
| 1:1 | 1440x1440 |
| 4:3 | 1648x1248 |
| 3:4 | 1248x1648 |
注意： 在使用 resolution 参数时，请确保分辨率中的P需要大写，如：720P（默认值），1080P。
duration 输出视频时长为 3-15 秒，默认值为 5 秒，输入参考视频支持时长为 2-10 秒。
模型价格
HappyHorse 1.0 的价格按照生成视频的分辨率、时长来计算，以下是价格速算表：
| 模型 | 分辨率 | 价格（单位：元/秒） |
|---|
happyhorse-1.0-t2v | 720P | 0.9 |
happyhorse-1.0-i2v | 720P | 0.9 |
happyhorse-1.0-r2v | 720P | 0.9 |
happyhorse-1.0-video-edit | 720P | 0.9 |
happyhorse-1.0-t2v | 1080P | 1.6 |
happyhorse-1.0-i2v | 1080P | 1.6 |
happyhorse-1.0-r2v | 1080P | 1.6 |
happyhorse-1.0-video-edit | 1080P | 1.6 |
0.8，那么生成 5 秒 720p 标准视频价格是 0.9x5x0.8=3.6 元，其他参数依次类推。
文生视频
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
"model": "happyhorse-1.0-t2v",
"prompt": "一段紧张刺激的侦探追查故事，展现电影级叙事能力。第1个镜头[0-3秒] 全景：雨夜的纽约街头，霓虹灯闪烁，一位身穿黑色风衣的侦探快步行走。 第2个镜头[3-6秒] 中景：侦探进入一栋老旧建筑，雨水打湿了他的外套，门在他身后缓缓关闭。 第3个镜头[6-9秒] 特写：侦探的眼神坚毅专注，远处传来警笛声，他微微皱眉思考。 第4个镜头[9-12秒] 中景：侦探在昏暗走廊中小心前行，手电筒照亮前方。 第5个镜头[12-15秒] 特写：侦探发现关键线索，脸上露出恍然大悟的表情。",
"resolution": "720P",
"aspect_ratio": "16:9"
"async": true
}'
图生视频
基于首帧
传入图片到 image 字段即可实现基于首帧生成视频：
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
"model": "happyhorse-1.0-i2v",
"prompt": "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由rap构成，没有其他对话或杂音。",
"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
"async": true
}'
HappyHorse 1.0 目前仅支持首帧生视频，不支持首尾帧生视频。
参考生视频
参考图
通过 images 传入一张或多张图即可实现基于参考图生成视频：
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
"model": "happyhorse-1.0-r2v",
"prompt": "@图1戴着眼镜穿着蓝色T恤的男生和@图2的柯基小狗，坐在@图3的草坪上，3D卡通风格",
"images": [
"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
"https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
],
"async": true
}'
HappyHorse 1.0 参考生视频目前仅支持基于参考图片生成视频，不支持音视频参数。
视频编辑
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
"model":"happyhorse-1.0-video-edit",
"prompt": "将视频中女孩的衣服替换为图片中的衣服",
"video": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4",
"images": [
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png"
],
"async": true
}'
异步任务
由于视频生成通常比较耗时，建议通过极客智坊提供的通用异步方式生成视频。
视频 API 中的 async 参数用于控制是否异步生成视频，默认为 false，表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 true，则会异步生成视频并返回任务ID，你可以使用该任务ID轮询视频生成状态。
具体操作请参考Sora-2示例，流程完全一样。 