Happy Horse 视频接口

Happy Horse 视频生成接口文档。渠道类型为"阿里通义千问"，通过 DashScope 接口调用。

支持模型：

happyhorse-1.0-t2v：文生视频

happyhorse-1.0-i2v：图生视频（首帧图）

happyhorse-1.0-r2v：参考图生视频（多张参考图）

happyhorse-1.0-video-edit：视频编辑（源视频 + 可选参考图）

接口地址

提交任务

POST https://www.moyu.info/v1/video/generations

查询结果

GET https://www.moyu.info/v1/video/generations/{task_id}

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

使用 happyhorse-1.0-i2v 模型，通过 input_reference 字段传入首帧图片 URL。

cURL

其他语言

输入图片限制：

格式：JPEG、JPG、PNG、WEBP

分辨率：宽和高不小于 300 像素

宽高比：1:2.5 ~ 2.5:1

文件大小：不超过 10MB

参考图生视频 (Reference-to-Video)

使用 happyhorse-1.0-r2v 模型，通过 images 数组传入多张参考图（最多 3 张）。可在 prompt 中使用"图1/图2/图3"引用对应的参考图。

cURL

其他语言

提示词技巧：在描述中使用"图1"、"图2"、"图3"等关键词引用对应的参考图，模型会按照引用关系组合参考图特征。

视频编辑 (Video Edit)

使用 happyhorse-1.0-video-edit 模型，通过 input_reference 字段传入源视频 URL，通过 images 数组传入可选的参考图。

cURL

其他语言

输入说明：

input_reference：源视频 URL（必填），支持 HTTP/HTTPS

images：参考图 URL 数组（可选），用于指导编辑效果（如换装、风格参考等）

提交任务响应格式

{
  "id": "c8ea538a-f08c-4bca-8111-28f753eaf000",
  "object": "video",
  "model": "happyhorse-1.0-t2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1777257469
}

重要：Happy Horse 为异步接口，返回 task_id（即 id 字段）后需要使用该 ID 查询生成结果。

查询结果

使用返回的 task_id 查询视频生成进度和结果。

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "0ad5fd4f-6945-4c1d-813f-d5346fad25db",
    "action": "textGenerate",
    "status": "IN_PROGRESS",
    "fail_reason": "",
    "submit_time": 1777258750,
    "start_time": 1777258755,
    "finish_time": 0,
    "progress": "30%",
    "data": {
      "output": {
        "task_id": "0ad5fd4f-6945-4c1d-813f-d5346fad25db",
        "task_status": "RUNNING",
        "submit_time": "2026-04-27 10:59:13.822",
        "scheduled_time": "2026-04-27 10:59:13.869"
      },
      "request_id": "154e2256-6585-9363-b23d-95c2dce2c3f6"
    }
  }
}

视频生成成功

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "0ad5fd4f-6945-4c1d-813f-d5346fad25db",
    "action": "textGenerate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://xxx.oss-accelerate.aliyuncs.com/xxx.mp4?...",
    "submit_time": 1777258750,
    "start_time": 1777258755,
    "finish_time": 1777258923,
    "progress": "100%",
    "data": {
      "usage": {
        "SR": 1080,
        "ratio": "9:16",
        "duration": 10,
        "video_count": 1,
        "output_video_duration": 10
      },
      "output": {
        "task_id": "0ad5fd4f-6945-4c1d-813f-d5346fad25db",
        "task_status": "SUCCEEDED",
        "video_url": "https://xxx.oss-accelerate.aliyuncs.com/xxx.mp4?...",
        "orig_prompt": "A majestic eagle soaring through clouds at sunset",
        "end_time": "2026-04-27 11:02:02.968"
      },
      "request_id": "2131f395-518e-92ee-8605-a21412f07e21"
    }
  }
}

说明：任务成功时，视频地址在外层 data.result_url 字段（此时 fail_reason 为空）；任务失败时 result_url 为空、fail_reason 记错误原因。内层 data.data.output.video_url 是上游原始体透传的同一地址，二者取其一即可。

请求参数

提交任务参数

通用参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称：`happyhorse-1.0-t2v`（文生视频）、`happyhorse-1.0-i2v`（图生视频）、`happyhorse-1.0-r2v`（参考图生视频）
prompt	string	是	-	视频描述文本，最多 2500 字符
duration	number	否	5	视频时长（秒），范围 3-15

文生视频专属参数 (`happyhorse-1.0-t2v`)

参数	类型	必填	默认值	说明
mode	string	否	std	质量模式：`pro`（专业）或 `std`（标准）
aspect_ratio	string	否	16:9	输出宽高比：`16:9`、`9:16`、`1:1`
sound	boolean	否	true	启用原生音频生成

图生视频专属参数 (`happyhorse-1.0-i2v`)

参数	类型	必填	默认值	说明
input_reference	string	是	-	首帧图片 URL（HTTP 或 HTTPS）
resolution	string	否	1080P	视频分辨率：`720P` 或 `1080P`
watermark	boolean	否	true	是否在视频右下角添加 "Happy Horse" 水印
seed	integer	否	-	随机数种子，范围 [0, 2147483647]

参考图生视频专属参数 (`happyhorse-1.0-r2v`)

参数	类型	必填	默认值	说明
images	string[]	是	-	参考图 URL 数组（HTTP/HTTPS 或 base64），建议 1-3 张
resolution	string	否	720P	视频分辨率：`720P` 或 `1080P`
aspect_ratio	string	否	16:9	输出宽高比：`16:9`、`9:16`、`1:1`
seed	integer	否	-	随机数种子，范围 [0, 2147483647]

视频编辑专属参数 (`happyhorse-1.0-video-edit`)

参数	类型	必填	默认值	说明
input_reference	string	是	-	源视频 URL（HTTP 或 HTTPS）
images	string[]	否	-	参考图 URL 数组，用于指导编辑效果（如换装、风格参考等）
resolution	string	否	720P	视频分辨率，目前支持 `720P`

输入图片限制（图生视频）：

格式：JPEG、JPG、PNG、WEBP

分辨率：宽和高不小于 300 像素

宽高比：1:2.5 ~ 2.5:1

文件大小：不超过 10MB

质量模式说明（文生视频）：

std：标准模式，生成速度较快

pro：专业模式，画质更高（分辨率 1080P）

时长说明：

支持 3-15 秒

默认 5 秒

提示词建议：

使用详细、具体的描述

包含场景、光线、动作、情绪等元素

建议使用英文以获得更好的效果

响应字段说明

提交任务响应字段

字段	类型	说明
id	string	任务唯一标识符（task_id），用于查询结果
object	string	对象类型，固定为 "video"
model	string	使用的模型名称
status	string	任务状态：queued（排队中）
progress	integer	进度百分比
created_at	integer	创建时间戳

查询结果响应字段

字段	类型	说明
code	string	响应码，"success" 表示查询成功
message	string	响应消息
data.task_id	string	任务 ID
data.action	string	操作类型，如 "textGenerate"
data.status	string	任务状态：IN_PROGRESS（进行中）、SUCCESS（成功）、FAILURE（失败）
data.progress	string	进度百分比，如 "30%"、"100%"
data.submit_time	integer	提交时间戳
data.start_time	integer	开始时间戳
data.finish_time	integer	完成时间戳
data.result_url	string	成功时的视频下载地址（有时效性）；失败时为空
data.fail_reason	string	失败原因；成功时为空
data.data.usage.ratio	string	实际输出宽高比
data.data.usage.duration	integer	实际输出视频时长（秒）
data.data.usage.SR	integer	实际输出分辨率
data.data.output.video_url	string	视频下载地址（有时效性）
data.data.output.orig_prompt	string	原始提示词

接口地址#

提交任务#

查询结果#

请求示例#

文生视频 (Text-to-Video)#

cURL#

其他语言#

图生视频 (Image-to-Video)#

cURL#

其他语言#

参考图生视频 (Reference-to-Video)#

cURL#

其他语言#

视频编辑 (Video Edit)#

cURL#

其他语言#

提交任务响应格式#

查询结果#

查询请求示例#

cURL#

其他语言#

查询响应格式#

任务进行中#

视频生成成功#

请求参数#

提交任务参数#

通用参数#

文生视频专属参数 (happyhorse-1.0-t2v)#

图生视频专属参数 (happyhorse-1.0-i2v)#

参考图生视频专属参数 (happyhorse-1.0-r2v)#

视频编辑专属参数 (happyhorse-1.0-video-edit)#

响应字段说明#

提交任务响应字段#

查询结果响应字段#

接口地址

提交任务

查询结果

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

cURL

其他语言

参考图生视频 (Reference-to-Video)

cURL

其他语言

视频编辑 (Video Edit)

cURL

其他语言

提交任务响应格式

查询结果

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

视频生成成功

请求参数

提交任务参数

通用参数

文生视频专属参数 (`happyhorse-1.0-t2v`)

图生视频专属参数 (`happyhorse-1.0-i2v`)

参考图生视频专属参数 (`happyhorse-1.0-r2v`)

视频编辑专属参数 (`happyhorse-1.0-video-edit`)

响应字段说明

提交任务响应字段

查询结果响应字段