mingyanmingyan
mingyan

Happy Horse 视频编辑 - 创建任务

创建 Happy Horse 视频编辑任务,模型固定为 happyhorse-1.0-video-edit

POST/kyyReactApiServer/v1/happyhorse-edit/videos

Happy Horse 视频编辑创建任务

使用 happyhorse-1.0-video-edit 创建视频编辑任务。该接口必须传入 1 个待编辑视频,可选传入最多 5 张参考图片。

认证

所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

modelbodystring必填
模型名称,固定为 happyhorse-1.0-video-edit
promptbodystring必填
视频编辑提示词,最长 2500 个中文字符或 5000 个非中文字符。
referenceVideosbodyarray必填
待编辑视频 URL 列表,必须且只能传 1 个视频。
视频限制:
  • 格式:MP4MOV,建议 H.264 编码
  • 时长:3-60
  • 分辨率:长边不超过 4096 像素,短边不小于 360 像素
  • 宽高比:1:2.52.5:1
  • 文件大小:不超过 100MB
  • 帧率:大于 8fps
referenceImagesbodyarray
参考图片 URL 列表,可选,最多 5 张。
图片限制:
  • 格式:JPEGJPGPNGWEBP
  • 宽和高不小于 300 像素
  • 宽高比:1:2.52.5:1
  • 文件大小:不超过 20MB
audioSettingbodystring
声音控制,默认 auto
  • auto:由模型自行控制
  • origin:保留输入视频原始声音
resolutionbodystring
输出分辨率,默认 720P,可选值为 720P1080P
seedbodyinteger
随机种子,范围 0-2147483647,默认 0

响应参数

idstring
视频生成任务的唯一标识符,用于后续查询任务状态。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
创建任务时使用的模型名称。
statusstring
任务状态。创建成功时固定返回 queued
errorstring
错误信息。创建成功时通常为 null
关键约束:
  • model 必须为 happyhorse-1.0-video-edit
  • referenceVideos 必须且只能传 1 个视频
  • 输入视频超过 15 秒时,会从头截取前 15 秒作为有效片段
  • referenceImages 最多 5
  • audioSetting 仅支持 autoorigin