happyhorse 视频生成模型接入指南

happyhorse 是阿里云百炼平台提供的视频生成模型系列，支持文生视频、图生视频和参考生视频三种模式。

接口基地址: https://api.numspirit.com/v1

模型列表

模型ID	功能	说明
`happyhorse-1.1-t2v`	文生视频	根据文本描述生成视频
`happyhorse-1.1-i2v`	图生视频	根据输入图片生成视频
`happyhorse-1.1-r2v`	参考生视频	根据参考图片/视频生成视频

接口概览

功能	接口路径	方法	说明
视频生成	`/v1/videos/generations`	POST	提交视频生成任务
任务查询	`/v1/videos/generations/{task_id}`	GET	查询任务状态

1. 文生视频 - happyhorse-1.1-t2v

根据文本描述生成视频。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`happyhorse-1.1-t2v`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率：`720P` 或 `1080P`
`ratio`	string	是	宽高比：`16:9`、`9:16`、`1:1` 等
`duration`	integer	是	时长（秒）：3-15

cURL 示例

响应示例

{
  "success": true,
  "data": {
    "task_id": "9dc4e5f1-69b5-4874-b475-f815b8a30a5d",
    "model": "happyhorse-1.1-t2v",
    "status": "PENDING"
  }
}

2. 图生视频 - happyhorse-1.1-i2v

基于首帧图片生成视频。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`happyhorse-1.1-i2v`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率：`720P` 或 `1080P`
`duration`	integer	是	时长（秒）：3-15
`media`	array	是	媒体列表，包含首帧图片

media 参数说明

字段	类型	必填	说明
`type`	string	是	固定值：`first_frame`
`url`	string	是	图片URL地址

cURL 示例

3. 参考生视频 - happyhorse-1.1-r2v

根据参考图片生成视频，支持多主体参考。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`happyhorse-1.1-r2v`
`prompt`	string	是	视频描述文本，可引用参考图片
`resolution`	string	是	分辨率：`720P` 或 `1080P`
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：3-15
`media`	array	是	参考媒体列表

media 参数说明

字段	类型	必填	说明
`type`	string	是	固定值：`reference_image`
`url`	string	是	参考图片URL地址

cURL 示例

4. 查询任务状态

接口

GET https://api.numspirit.com/v1/videos/generations/{task_id}?model={model_id}

说明

task_id: 创建任务时返回的任务ID

model: 创建任务时使用的模型ID（用于确定查询渠道）

cURL 示例

响应示例（进行中）

{
  "success": true,
  "data": {
    "task_id": "9dc4e5f1-69b5-4874-b475-f815b8a30a5d",
    "status": "running",
    "output_urls": [],
    "error": null
  }
}

响应示例（成功）

{
  "success": true,
  "data": {
    "task_id": "9dc4e5f1-69b5-4874-b475-f815b8a30a5d",
    "status": "succeeded",
    "output_urls": [
      "https://dashscope-a717.oss-accelerate.aliyuncs.com/xxx.mp4"
    ],
    "error": null
  }
}

通用参数说明

resolution（分辨率）

值	说明
`720P`	高清 720P
`1080P`	全高清 1080P

ratio（宽高比）

值	说明
`16:9`	横屏（默认）
`9:16`	竖屏
`1:1`	正方形
`4:3`	标准屏
`3:4`	竖屏

duration（时长）

范围：3-15 秒

默认：5 秒

附录：文件上传接口

happyhorse 模型的图生视频、参考生视频等功能需要图片或音频文件。你可以通过以下接口上传文件到阿里云 OSS，获取临时签名 URL。

单文件上传

接口: POST https://api.numspirit.com/v1/uploads

请求 Header:

Authorization: Bearer sk-silievo-xxxxxxxx
Content-Type: multipart/form-data

请求参数:

参数	类型	必填	说明
`file`	File	是	要上传的文件（图片/音频/视频）

支持的文件类型:

图片：image/png, image/jpeg, image/webp, image/gif

音频：audio/mpeg, audio/wav, audio/mp3, audio/aac, audio/ogg, audio/flac

视频：video/mp4, video/webm, video/quicktime

cURL 示例:

响应示例:

{
  "success": true,
  "data": {
    "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx.jpg?Expires=...",
    "oss_key": "users/123/uploads/2026-07/xxx.jpg",
    "mime": "image/jpeg",
    "size": 102400
  }
}

批量文件上传

接口: POST https://api.numspirit.com/v1/uploads/batch

请求参数:

参数	类型	必填	说明
`files`	File[]	是	要上传的文件列表（最多 5 个）

cURL 示例:

响应示例:

{
  "success": true,
  "data": [
    {
      "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx1.jpg?Expires=...",
      "oss_key": "users/123/uploads/2026-07/xxx1.jpg",
      "mime": "image/jpeg",
      "size": 102400
    },
    {
      "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx2.png?Expires=...",
      "oss_key": "users/123/uploads/2026-07/xxx2.png",
      "mime": "image/png",
      "size": 204800
    }
  ]
}

使用上传后的 URL

上传成功后，将返回的 url 作为 media.url 参数传入视频生成接口：

happyhorse视频模型接口

happyhorse 视频生成模型接入指南#

模型列表#

接口概览#

1. 文生视频 - happyhorse-1.1-t2v#

请求参数#

cURL 示例#

响应示例#

2. 图生视频 - happyhorse-1.1-i2v#

请求参数#

media 参数说明#

cURL 示例#

3. 参考生视频 - happyhorse-1.1-r2v#

请求参数#

media 参数说明#

cURL 示例#

4. 查询任务状态#

接口#

说明#

cURL 示例#

响应示例（进行中）#

响应示例（成功）#

通用参数说明#

resolution（分辨率）#

ratio（宽高比）#

duration（时长）#

附录：文件上传接口#

单文件上传#

批量文件上传#

使用上传后的 URL#

happyhorse 视频生成模型接入指南

模型列表

接口概览

1. 文生视频 - happyhorse-1.1-t2v

请求参数

cURL 示例

响应示例

2. 图生视频 - happyhorse-1.1-i2v

请求参数

media 参数说明

cURL 示例

3. 参考生视频 - happyhorse-1.1-r2v

请求参数

media 参数说明

cURL 示例

4. 查询任务状态

接口

说明

cURL 示例

响应示例（进行中）

响应示例（成功）

通用参数说明

resolution（分辨率）

ratio（宽高比）

duration（时长）

附录：文件上传接口

单文件上传

批量文件上传

使用上传后的 URL