用镜头语言组织画面
将主体、环境、动作、光线和镜头移动写进提示词，从文字直接构建动态场景。适合描述晨光中的缓慢推进、人物经过街道等单镜头创意，让分镜先形成可观看的片段，再判断构图与节奏是否符合预期。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 创作模式
- 文字生成视频；action=generate，必须提供 prompt
- 平台分辨率
- 720P、1080P；默认 1080P
- 平台请求时长
- 3–15 秒；默认 5 秒
- 平台画幅
- 16:9、9:16、1:1、4:3、3:4；默认 16:9
- 调用入口
- POST /happyhorse/videos；model=happyhorse-1.1-t2v
- 任务交付
- 支持异步查询与回调，返回任务 ID、视频 URL 和结果状态
HappyHorse 1.1 的公开创作定位与本入口的调用规格分别说明，上述时长、画幅和默认值属于本平台调用范围。
核心能力
了解 happyhorse-1.1-t2v 能为你的工作带来什么。
面向动态与光影创作
HappyHorse 1.1 的创作方向强调电影感光照与稳定镜头运动，适合需要氛围、空间变化和主体动作的短片。可以围绕同一场景调整动作或照明描述，比较视觉方案；复杂互动仍应逐镜检查，不把风格定位当作每次结果的保证。
把视频生成接入产品
生成任务可采用异步方式提交，应用保存 task_id 后查询状态，也可设置 callback_url 接收完成结果。成功后取得 video_url、时长和分辨率，便于把生成、预览、用户筛选与下载接入同一套创作流程。
适用场景
从具体任务出发，找到模型发挥作用的位置。
广告分镜预演
输入广告脚本中的一个镜头，明确商品所在环境、主体动作、光线方向和运镜方式，生成供团队讨论的动态预演。适合先验证开场氛围与镜头节奏，再决定拍摄或后期方案；准确包装外观需要更强的图片约束时，应改用图像创作型号。
竖屏社交氛围素材
围绕旅行、生活方式或节日主题编写场景描述，选择 9:16 画幅生成短片，再加入字幕、配乐与品牌信息。每个任务集中呈现一个清晰动作或视觉变化，更便于筛选素材，也便于在剪辑阶段组合成完整的社交内容。
短剧镜头概念验证
把剧本拆成独立镜头，为每段描述人物行为、场景气氛与摄影机运动，生成概念片段辅助讨论。它适合探索视觉方向，而不是一次完成整部短剧；需要跨镜头固定角色或服装时，可将任务转向同系列的参考图生视频型号。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
从零构思选 T2V，有素材选图像型号
尚未确定视觉资产、希望直接从文字探索画面时，选择 happyhorse-1.1-t2v。已有商品图或角色图，并希望以它作为首帧，可选择 happyhorse-1.1-i2v；需要用多张图片约束角色、道具或风格，则选择 happyhorse-1.1-r2v。三者对应不同创作起点，不宜混用动作与型号。
新任务从 1.1 开始，旧流程保留实测
happyhorse-1.1-t2v 是默认文生视频型号，适合作为新项目的起点。若已有基于 happyhorse-1.0-t2v 的提示词和验收样片，建议用相同场景并排测试后决定是否切换，不预设固定提升幅度。若目标是修改已有视频，应选择 happyhorse-1.0-video-edit，而非文生视频型号。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 本型号从文字生成新视频，不将 image_url、image_urls 或 video_url 作为对应创作模式的素材输入。首帧动画、参考图约束和已有视频编辑需要各自匹配的型号；共享接口中的字段不能替代正确的动作选择。
- 平台单次请求时长为 3–15 秒，更适合单镜头素材与短片原型。长叙事应拆分生成后剪辑；涉及多个连续动作、复杂接触或精确角色延续时，需要逐段验收，不能仅靠增加提示词长度保证连贯。
- 不要将此型号作为对白、口型同步或原视频音频保留工具使用。audio_setting 的音频保留用法属于视频编辑任务；本型号的创作流程以画面生成为主，配乐、解说与精确声音设计宜安排在后期。
常见问题
解答使用 happyhorse-1.1-t2v 时的常见疑问。
happyhorse-1.1-t2v 最少需要什么输入？
提供 prompt 即可开始文生视频，并使用 action=generate、model=happyhorse-1.1-t2v。提示词建议写清主体、环境、动作和镜头方向；分辨率、画幅与时长可按交付需求另行设置，不需要先准备图片。
可以生成横屏和竖屏吗？
可以。本入口支持 16:9、9:16、1:1、4:3 和 3:4，默认 16:9。社交短片可选 9:16，横屏预演可选 16:9；最好在生成前确定目标画幅，减少后续裁切对主体位置和构图的影响。
如何选择时长和分辨率？
请求时长可设为 3–15 秒，默认 5 秒；分辨率支持 720P 与 1080P，默认 1080P。探索阶段可先用较短片段验证动作和构图，视觉方向确定后再按展示需求选择分辨率，避免在单段中堆叠过多事件。
已有商品图，还应该选 T2V 吗？
若只想探索商品所处的环境与广告氛围，T2V 仍适合。如果商品外观和首帧构图必须跟随现有图片，优先选择 happyhorse-1.1-i2v；多张角色、道具或风格图片共同参与约束时，则考虑 happyhorse-1.1-r2v。
提交后如何获取生成的视频？
可设置 async=true，保存返回的 task_id，并通过 /happyhorse/tasks 查询；也可提供 callback_url 接收完成通知。任务状态包括 pending、succeeded 和 error，成功后读取 video_url 下载视频，不应把拿到任务 ID 当作生成完成。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits
Official $0.14–$0.24−24%vs official
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
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.