先定画面，再设计运动
首帧图片直接作为视频的起点，让商品位置、角色外观和场景构图有明确依据。相比只靠文字搭建镜头，这种方式更适合已有视觉素材的创作；提示词可以集中描述抬头、转身、风吹衣物或缓慢推进等变化，减少对初始画面的重复描述。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作方式
- 单张首帧图生视频，可配合文字动作描述
- 平台分辨率
- 720P、1080P
- 视频时长
- 3–15秒，平台接受整数秒
- 原生视频输出
- 24 fps，MP4
- 画幅控制
- 输出宽高比尽量跟随首帧图片
- 原生音频
- 支持音频视频生成
- 任务交付
- 支持异步查询、完成回调及视频URL结果
原生分辨率还包含480P；本平台入口提供720P和1080P，首帧任务按输入图片确定画幅。
核心能力
了解 happyhorse-1.1-i2v 能为你的工作带来什么。
把静态素材发展为短镜头
该型号面向首帧动画，可围绕主体动作、环境动态和镜头移动设计短片。实际创作时，建议先确定一个主要动作，再补充光线、背景和运镜要求，让几秒钟的画面承担清晰任务，而不是把完整故事、多个转场和复杂互动挤进同一片段。
按任务获取视频结果
通过POST /happyhorse/videos提交首帧与创作描述，显式选择image_to_video和happyhorse-1.1-i2v。需要后台处理时，可使用async获取任务ID并查询状态，或用callback_url接收完成结果，适合接入素材制作工具和批量创作流程。
适用场景
从具体任务出发，找到模型发挥作用的位置。
商品静图动效化
输入构图明确的商品照片，描述轻微镜头推进、背景光影变化或周围环境运动，生成用于营销预览的短片。需要突出包装和品牌文字时，应以克制动作保留视觉重点，并在交付前检查标签、小字和轮廓，避免动态变化影响商品信息。
角色镜头预演
将角色设定图作为首帧，配合抬头、回望、衣物摆动等动作描述，得到分镜动态草案。交付物可用于讨论表演方向和镜头节奏；如果任务变为多张角色图共同约束新场景，应选择参考图生视频型号，而不是继续增加首帧输入。
场景插画动态预览
以风景图或场景插画为起点，描述水面、树叶、云层与摄影机的运动，制作短时氛围镜头。制作竖屏内容时先准备竖构图图片，让画幅随首帧延续；完成后获取视频URL，下载素材并进入剪辑流程，组合成更长的内容。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
按输入素材选择1.1型号
已有一张需要作为开场画面的图片，选择happyhorse-1.1-i2v；只有文字脚本时选择happyhorse-1.1-t2v；需要多张图片约束角色、道具或风格时选择happyhorse-1.1-r2v。区别在于图片是否必须成为首帧，而不只是创作参考。已有视频的修改则属于video-edit任务。
与1.0及其他视频任务取舍
1.1和1.0首帧型号的原生时长、帧率与文件格式相同，1.1增加原生480P档位；在此入口两者都使用720P或1080P，不应仅凭版本号假定速度或画质提升。新建首帧任务可选1.1；若必须指定结尾画面、衔接长镜头，应选择明确支持首尾帧控制的型号。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 这是单首帧生成型号，不是多图参考或已有视频编辑工具。不要用image_urls代替image_url，也不要期待传入video_url就能修改视频；任务动作与型号必须匹配，提交时应明确写出image_to_video。
- 画幅尽量跟随首帧，不适合依赖ratio强行改变构图。素材需使用公网可访问的图片URL；建议在上传前完成横竖版构图、主体留白和关键内容布局，避免生成后再裁切损失画面重点。
- 单次创作范围为3–15秒。首帧定义起点，不等于后续每一帧都保持细节不变；复杂遮挡、大幅转身及精细文字应逐段检查。音频能力也不等于可直接指定配音、参考音轨或精确口型同步。
常见问题
解答使用 happyhorse-1.1-i2v 时的常见疑问。
首帧图必须怎样提交？
使用image_url提交一张公网可访问的图片，并将action设为image_to_video、model设为happyhorse-1.1-i2v。图片会作为视频首帧；prompt用于补充后续动作、环境变化与运镜，不必重新描述所有静态细节。
能指定竖屏或方形视频吗？
首帧任务的输出宽高比尽量跟随图片，不需要额外传ratio。希望制作竖屏或方形内容时，应先准备对应构图的首帧；商品标签、人物头部和其他重要元素最好留出安全空间，再检查最终视频的实际画幅。
它能用多张参考图保持角色一致吗？
本型号以一张首帧图片启动生成，不是多图参考模式。需要组合角色、服装或道具参考时，应选happyhorse-1.1-r2v；如果主要目标是让现有画面开始运动，而不重新组织场景，i2v更符合任务结构。
支持哪些清晰度、时长和音频能力？
此入口可选720P或1080P，时长为3–15秒整数；原生视频规格为24 fps、MP4，并支持音频。音频生成与精确配音控制是不同能力，不能把原视频音频保留或参考音频输入作为本型号的使用方式。
提交后怎样拿到成片？
可设置async=true，保存返回的task_id，再通过/happyhorse/tasks查询；也可提供callback_url等待完成通知。结果状态包括pending、succeeded和error，成功结果包含video_url；不要仅凭已取得任务ID就判断视频已生成完成。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Pricing
$0.10–$0.18· per second
Official $0.14–$0.24−24%vs official
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits46% OFF
You're billed in credits. Pick a top-up tier to see its per-credit rate — the larger the top-up, the cheaper each credit.
Quickstart
Try the API
API Key
Please obtain an API Key first
This is only a basic call example. See the full docs for more parameters and advanced usage.
View Docs