HappyHorse 生视频 - AI 接口对接文档中心

1. 概述

本接口用于创建 HappyHorse 文生视频和图生视频异步任务。创建成功后返回任务 ID 和初始任务状态。

baseUrl：https://token.soar.qjclouds.cn/laserEr/00000000/v1
completionsPath：/video/generations/{apiType}
标准地址：POST {baseUrl}{completionsPath}
创建任务：POST {baseUrl}/video/generations/{apiType}
查询任务：POST {baseUrl}/video/resource-actions/{apiType}

2. 接入前置条件

项	说明
`api_key`	平台生成的 API Key。
`model`	已开通的 HappyHorse 视频模型编码。

3. 鉴权

Header	必填	说明
`Content-Type`	是	`application/json`
`Authorization`	是	`Bearer <api_key>`

4. 文生视频

创建任务：POST {baseUrl}/video/generations/{apiType}
示例模型：happyhorse-1.0-t2v
apiType：TextToVideo

请求地址：https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/TextToVideo

4.1 请求参数

参数	类型	是否必填	说明
`model`	string	是	模型名称，可选值：`happyhorse-1.0-t2v`。
`input`	object	是	模型输入信息。
`input.prompt`	string	是	文本提示词，用于描述期望生成的视频内容。支持任意语言；非中文字符不超过 4000 个，中文字符不超过 2000 个，超出部分自动截断。
`parameters`	object	否	视频处理参数，包括分辨率、宽高比、时长和随机种子。
`parameters.resolution`	string	否	分辨率，可选 `720P`、`1080P`，默认 `1080P`。
`parameters.ratio`	string	否	宽高比，可选 `16:9`（默认）、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`。
`parameters.duration`	integer	否	视频时长，取值为 3～15 秒的整数，默认 5 秒。
`parameters.seed`	integer	否	随机种子，范围 `0–2147483647`；未指定时由系统生成。相同 seed 不保证每次结果完全一致。

4.2 请求示例

JSON

{
  "model": "happyhorse-1.0-t2v",
  "input": {
    "prompt": "生成一段海边日落的短视频。"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5,
    "seed": 1
  }
}

4.3 响应示例

JSON

{
  "output": {
    "task_status": "PENDING",
    "task_id": "fa22eea6-3bdb-4877-ba1c-d47e30d22d50"
  },
  "request_id": "d656784a-9df1-4947-b693-a23dcf95a319"
}

4.4 响应字段

参数	类型	说明
`output`	object	任务输出信息。
`output.task_id`	string	任务 ID，查询有效期为 24 小时。
`output.task_status`	string	任务状态：`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`UNKNOWN`。
`request_id`	string	请求唯一标识，用于问题溯源和排查。
`code`	string	请求失败时返回的错误码。
`message`	string	请求失败时返回的详细信息。

5. 图生视频

创建任务：POST {baseUrl}/video/generations/{apiType}
示例模型：happyhorse-1.0-i2v
apiType：ImageToVideo

请求地址：https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/generations/ImageToVideo

5.1 请求参数

参数	类型	是否必填	说明
`model`	string	是	模型名称，可选值：`happyhorse-1.0-i2v`。
`input`	object	是	模型输入信息。
`input.prompt`	string	否	文本提示词，用于描述期望生成的视频内容。支持任意语言；非中文字符不超过 4000 个，中文字符不超过 2000 个，超出部分自动截断。
`input.media`	array<object>	是	输入媒体列表，用于指定视频生成所需的图像。
`input.media[].type`	string	是	媒体素材类型，可选 `first_frame`，表示首帧。当前模型仅支持首帧图像。
`input.media[].url`	string	是	公网可访问的 HTTP 或 HTTPS 图片 URL。支持 JPEG、JPG、PNG、WEBP；宽高不小于 300 像素，宽高比为 1:2.5～2.5:1，文件不超过 20 MB。
`parameters`	object	否	视频处理参数，包括分辨率、时长和随机种子。
`parameters.resolution`	string	否	分辨率，可选 `720P`、`1080P`，默认 `1080P`。
`parameters.duration`	integer	否	视频时长，取值为 3～15 秒的整数，默认 5 秒。
`parameters.seed`	integer	否	随机种子，范围 `0–2147483647`；未指定时由系统生成。相同 seed 不保证每次结果完全一致。

宽高比：图生视频会自动跟随输入首帧图像的宽高比，无需也不支持传入 ratio 参数。

5.2 请求示例

JSON

{
  "model": "happyhorse-1.0-i2v",
  "input": {
    "prompt": "让画面中的人物微笑并轻轻挥手。",
    "media": [
      {
        "type": "first_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241022/emyrja/dog_and_girl.jpeg"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5,
    "seed": 1
  }
}

5.3 响应示例

JSON

{
  "output": {
    "task_status": "PENDING",
    "task_id": "110a5829-be77-4396-8db1-4ef6dadb665a"
  },
  "request_id": "34cdf986-9b6b-4e09-8bff-2931d60a96ba"
}

6. 视频任务查询

查询任务：POST {baseUrl}/video/resource-actions/{apiType}
apiType：QueryVideo

请求地址：https://token.soar.qjclouds.cn/laserEr/00000000/v1/video/resource-actions/QueryVideo

6.1 请求参数

参数	类型	是否必填	说明
`model`	string	是	创建任务时使用的 HappyHorse 模型编码，如 `happyhorse-1.0-i2v`。
`task_id`	string	是	创建任务返回的任务 ID，查询有效期为 24 小时。

6.2 请求示例

JSON

{
  "model": "happyhorse-1.0-i2v",
  "task_id": "110a5829-be77-4396-8db1-4ef6dadb665a"
}

6.3 响应示例

JSON

{
  "request_id": "49a5310d-d515-4f55-ac70-f9c529990d75",
  "output": {
    "task_id": "110a5829-be77-4396-8db1-4ef6dadb665a",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-09-08 09:48:40.949975",
    "scheduled_time": "2026-09-08 09:48:44.478041",
    "end_time": "2026-09-08 09:50:15.232430",
    "orig_prompt": "让画面中的人物微笑并轻轻挥手。",
    "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/9b/20260908/3419032b/94695994-metadata_video_720p_1ed37510-6f16-44b2-9f98-5d6de9361963_refiner.mp4?Expires=1788918608&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=m5r1YQEW2B98n%2Fkl3MwsE02P3hs%3D"
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 720,
    "ratio": "16:9"
  }
}

6.4 响应字段

参数	类型	说明
`output`	object	任务输出信息。
`output.task_id`	string	任务 ID，查询有效期为 24 小时。
`output.task_status`	string	任务状态：`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`UNKNOWN`。成功时返回视频 URL；失败时检查错误信息。
`output.submit_time`	string	任务提交时间，格式为 YYYY-MM-DD HH:mm:ss.SSS。
`output.scheduled_time`	string	任务执行时间。
`output.end_time`	string	任务完成时间。
`output.video_url`	string	生成的视频 URL，仅在任务成功时返回，链接有效期为 24 小时。
`output.orig_prompt`	string	原始输入的提示词。
`output.code`	string	请求失败时返回的错误码。
`output.message`	string	请求失败时返回的详细信息。
`usage`	object	成功结果的输出统计信息。
`usage.input_video_duration`	integer	输入视频时长，单位为秒。
`usage.output_video_duration`	integer	输出视频时长，单位为秒。
`usage.duration`	integer	总视频时长，用于计费。
`usage.SR`	integer	输出视频的分辨率档位。
`usage.ratio`	string	输出视频的宽高比。
`usage.video_count`	integer	输出视频数量，固定为 1。
`request_id`	string	请求唯一标识，用于问题溯源和排查。