mingyanmingyan
微信微信
mingyan

Happy Horse - 查询任务

查询 Happy Horse 视频生成任务的状态和结果

GET/kyyReactApiServer/v1/result/{id}

Happy Horse 查询任务

使用任务 ID 查询 Happy Horse 视频生成任务的状态和结果。该查询接口适用于 Happy Horse 文生视频、首帧图生视频和参考生视频任务。

认证

认证

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

基础 URL

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

路径参数

idstring必填
视频任务的唯一标识符，从创建任务接口返回。
创建接口直接返回字段 id，查询时请将该值作为这里的 id 使用。

响应参数

idstring
视频任务的唯一标识符。
objectstring
对象类型，固定为 video。
createdinteger
任务创建时间戳。
modelstring
使用的模型名称，例如 happyhorse-1.0-t2v、happyhorse-1.0-i2v 或 happyhorse-1.0-r2v。
statusstring
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
video_urlstring
生成或编辑后的视频 URL。当状态为 completed 时返回。
actualDurationnumber
视频实际输出时长（秒）。当状态为 completed 时返回。
errorstring
错误信息。当状态为 failed 时返回。

状态流程

queued

任务已创建并进入队列，等待处理。

processing

任务正在处理中，Happy Horse 正在生成视频。

completed

任务完成，可通过 video_url 获取结果。

轮询建议

轮询策略：
  • 建议轮询间隔：30-60 秒
  • 不同模型、视频时长、参考图片数量会影响完成时间
  • 当 status 变为 completed 或 failed 时停止轮询
重要提示：
  • 查询接口中的 {id} 必须使用创建接口返回的 id
  • 生成结果通常为临时下载地址，请及时保存