模型名称:happyhorse-1.0
  • 面向标准视频池中的通用视频生成与镜头延展场景
  • default / standard 两个分组均可用,参数范围和请求体一致
  • 提交成功后返回视频任务 ID
  • 支持文生视频、首帧参考图生成和单参考视频生成
  • duration 支持 3 到 15 秒
  • aspect_ratio 支持 16:9、9:16、1:1、4:3、3:4
  • quality 支持 720P、1080P
  • 当前页面展示平台稳定公共字段

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

提交任务接口

请求参数

参考视频最多 1 条;不支持 audio_urls、草稿、任务链和回调字段。

响应

提交成功响应示例:
提交失败响应示例:

任务查询接口

查询成功示例:

使用示例

文生视频

首帧参考图视频

单参考视频生视频

注意事项

  1. default / standard 两个分组使用相同参数能力,只需切换对应分组的 API Key。
  2. 对外请使用 images / video_urls 传入参考素材,并使用 aspect_ratio / quality 描述画面规格。
  3. images、video_urls 建议单次只传一种参考来源;参考视频当前最多传 1 条。
  4. audio_setting 当前只作为对象透传,不单独扩展成新的公共子字段。
  5. 页面优先展示当前稳定协议,不展开更多底层实现细节。
  6. 提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口;只有 completed 状态才读取顶层 result_url。 任务失败时保持视频对象结构,并返回顶层 error 与 fail_reason,不要按图片接口读取 code/data/works: