用参考图延续角色身份
与仅用文字描述外观不同，参考图能为角色、服装和道具提供明确的视觉依据。你可以在提示词中改变环境与动作，同时继续使用相同角色素材，适合围绕一个形象创作不同场景的短镜头；一致性是创作目标，而非逐帧完全不变的保证。
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作模式
- 参考图生视频；输入 prompt 与 1–9 张 image_urls
- 素材引用
- 按图片顺序使用 character1、character2 等名称
- 原生输出
- 480P、720P、1080P；24 fps；MP4
- 调用分辨率
- 720P、1080P；默认 1080P
- 视频时长
- 3–15 秒；默认 5 秒
- 可选画幅
- 16:9、9:16、1:1、4:3、3:4
- 任务交付
- 支持异步查询与完成回调，返回 video_url
原生规格包含音频能力与 480P 输出；本平台此入口提供 720P、1080P 的参考图生成调用。
核心能力
了解 happyhorse-1.1-r2v 能为你的工作带来什么。
按顺序分配素材职责
图片不是无序附件：可用 character1、character2 指向对应素材，并说明哪张提供主体、哪张提供服装或视觉风格。例如让 character1 穿过草地，同时采用 character2 的皮革与金色饰边风格，使素材与镜头描述之间建立清晰关系。
从生成任务到视频交付
通过 POST /happyhorse/videos 提交任务，显式选择 reference_to_video 和本型号，再设置时长、分辨率与画幅。长连接不便时可使用 async 或 callback_url，保存 task_id 后查询结果或接收完成通知，取得视频链接用于下载与后续剪辑。
适用场景
从具体任务出发，找到模型发挥作用的位置。
角色系列短片
输入同一角色的参考图，为不同镜头分别描述场景、动作和拍摄方式，产出可剪辑的短片段。例如围绕一个角色制作草地行走、街头停留等镜头，先验证外观延续性，再挑选符合叙事要求的结果组成系列内容。
服装与道具创意预演
准备人物、服装或道具素材，在提示词中明确各参考图的用途，生成角色携带道具或呈现造型的动态预览。交付物适合用于讨论视觉方向、动作安排和场景氛围；涉及商品细节时，应检查纹理、标识与结构是否符合原始设计。
多画幅内容素材
围绕同一组角色参考素材，分别制作横屏、竖屏或方形短片，用于不同展示位置的创意试片。输入时同时调整画幅与构图描述，而不是只改变比例；输出后检查主体位置和动作空间，再交给剪辑流程添加字幕与品牌信息。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
参考图还是固定首帧
希望角色在新环境中继续出现，且不要求参考图原样成为开场画面时，选择 happyhorse-1.1-r2v。若任务重点是让一张已定稿图片作为首帧动起来，选择 happyhorse-1.1-i2v；没有图像素材、主要依赖脚本与镜头文字时，则使用 happyhorse-1.1-t2v。
区分版本与编辑任务
1.1-r2v 与 1.0-r2v 都属于参考图生成，公开规格中的明确差别是 1.1 增加原生 480P 档位，而此入口仍提供 720P、1080P。不要把版本号理解为固定质量增幅。若已有视频需要换装、风格迁移或局部替换，应选择 happyhorse-1.0-video-edit。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 参考图生成不是视频编辑，也不是动作复制。此型号的创作输入是图片与提示词，不应把共享接口中的 video_url 当成它的视频参考能力；需要保留已有镜头运动或修改原片时，应采用对应的编辑工作流。
- 单次生成时长为 3–15 秒，不适合直接交付长篇连续叙事。可先拆成独立镜头，再剪辑成片；跨片段的人物细节、位置关系和动作衔接仍需人工检查，参考图不能代替完整的连续性审核。
- 图片需以公网可访问 URL 提交，并保持顺序与提示词引用一致。多张素材若对同一角色的服装、外观或风格提出相互矛盾的要求，会让创作意图不清晰；建议筛选素材，并明确每张图片承担的职责。
常见问题
解答使用 happyhorse-1.1-r2v 时的常见疑问。
参考图会直接成为视频首帧吗？
本型号用参考图指导角色与视觉元素，不应按固定首帧流程使用。若需要以一张确定构图的图片作为开场画面，应选择 happyhorse-1.1-i2v。r2v 更适合保留参考主体，同时通过文字重新安排环境、动作和镜头。
如何让提示词对应多张参考图？
将 1–9 张图片 URL 放入 image_urls，并在提示词中按顺序使用 character1、character2 等引用。除了指明对应素材，还应写清主体动作、场景及素材用途，避免仅列出名称却没有说明它们之间的关系。
调用时需要显式指定哪些关键项？
设置 action 为 reference_to_video，model 为 happyhorse-1.1-r2v，并提交 prompt 与 image_urls。不要依赖默认的文生视频动作。随后根据用途选择 resolution、ratio 和 duration，即可形成完整的参考图生成请求。
它能生成音频或保留原视频声音吗？
该型号具备原生音频能力，但参考图生成不等于保留原视频声音，也不等于指定配音或口型同步。保留原音频的 origin 用法属于视频编辑任务；若声音有明确交付要求，应检查生成结果并安排必要的音频后期。
如何获取异步生成的视频？
使用 async 提交后保存 task_id，通过 /happyhorse/tasks 查询任务；也可填写 callback_url 接收完成通知。结果包含任务状态和 video_url，状态可能为 pending、succeeded 或 error，完成成功后再下载视频进行检查。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。