Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

模式路由

happyhorse-1.1 是文生视频 / 图生视频 / 参考图生视频的统一入口,后端根据传入参数自动判断模式,所有模式按统一规则计费(仅按分辨率 × 秒) 路由优先级(从高到低):first_frame_image > image_urls > 仅 prompt 字段互斥规则:两个媒体字段(first_frame_image / image_urls互斥。同时传两个互斥字段会返回 400 mixed_media_not_allowed

请求参数

string
必填
视频生成模型名称,固定为 happyhorse-1.1
string
视频内容描述,最多 2500 字符,不能包含特殊 token示例:"一个小女孩走在路上,电影感画面"
string
首帧图片,触发 I2V(图生视频)。支持 URL 或 base64(data:image/<mime>;base64,<payload>,网关自动转储到 OSS)image_urls 互斥
首帧图片要求:
  • 格式:JPEG / JPG / PNG / BMP / WEBP
  • 短边像素:≥ 300px
  • 宽高比:1:2.5 ~ 2.5:1
  • 大小:≤ 10MB
array<string>
图片数组(R2V 模式):1~9 张,作为主体/风格参考生成全新画面支持 URL 或 base64first_frame_image 互斥
参考图要求:
  • 格式:JPEG / JPG / PNG / BMP / WEBP
  • 短边像素:推荐 ≥ 720p
  • 宽高比:短边 / 长边 ≥ 0.4
  • 大小:≤ 10MB
  • 数量:1~9 张
string
默认值:"1080P"
视频分辨率(影响计费)可选值:
  • 720P - 标清
  • 1080P - 高清(默认)
integer
默认值:"5"
视频时长(秒,影响计费)支持范围:3 ~ 15 的任意整数默认值:5
string
默认值:"16:9"
画面宽高比支持的格式:
  • 16:9 - 横版宽屏(默认)
  • 9:16 - 竖版长屏
  • 1:1 - 正方形
  • 4:3 - 横版
  • 3:4 - 竖版
I2V 模式下此参数会被忽略,输出宽高比由输入媒体(首帧图)自动决定
boolean
默认值:"false"
是否在生成的视频上添加水印
  • true:添加水印
  • false:不添加水印(默认)
integer
随机种子,用于控制生成内容的随机性取值范围:[0, 2147483647],省略则随机
  • 相同的请求下,模型收到不同的 seed 值(如:不指定 seed 值),将生成不同的结果
  • 相同的请求下,模型收到相同的 seed 值,会生成类似的结果,但不保证完全一致

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:文生视频 T2V(最简请求)

场景 2:文生视频 T2V(完整参数)

场景 3:图生视频 I2V(first_frame_image)

场景 4:参考图生视频 R2V(多张参考图)

场景 5:720P 节省额度

模式选择建议

使用建议

  1. 统一入口逻辑:根据传入字段自动路由模式,注意两个媒体字段(first_frame_image / image_urls)互斥
  2. size 仅 T2V/R2V 生效:I2V 模式下 size 会被忽略,输出宽高比由输入媒体决定
  3. 时长建议:5~10 秒为甜点区,过短动作不连贯,过长上游耗时显著增加
  4. 首帧图片质量:清晰、构图明确、主体居中,能显著提升 I2V 效果
  5. prompt 写作:描述运动 / 镜头 / 氛围(如 “缓慢推近、电影感、暖色调”),比单纯描述静态场景效果更好
查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。