HappyHorse 1.1 T2V API
快马1.1 文生视频, 输入文本 → 视频, 720p/1080p
- 模型名:
happyhorse-1.1-t2v - 厂商: HappyHorse
- 类型: video
POST /v1/videos/generations
happyhorse-1.1-t2v:提交视频任务,含必填项、嵌套响应和虚构示例。
基础调用
必填参数: model, duration, resolution, input, parameters
可用参数: model, duration, resolution, input, parameters, wait
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|
model | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选: happyhorse-1.1-t2v |
duration | integer | 是 | 输出视频秒数。 |
resolution | string | 是 | 输出分辨率档位,例如720p。 |
input | object | 是 | 按生成模式填写的输入。 |
parameters | object | 是 | 视频生成参数。 |
wait | boolean | 否 | false表示提交后立即返回任务;推荐使用后续查询。 |
## 使用与响应约定
- 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。
- 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。
- 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。
- 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。
- 生成文件请及时保存;不要假设结果链接永久有效。
### 提交后查询同一任务
提交响应的 `id` 是后续查询依据,不要使用示例标识发起真实查询,也不要为了查询进度重新提交生成。使用 `GET /v1/videos/generations/{id}`。pending、submitted、processing表示尚未完成;succeeded、failed、timeout、canceled为终态。成功后读取该型号返回的 `content.video_url`、`output.video_url` 或 `video.url`,只使用实际存在的结果字段。
## 参考
参数术语参考[HappyHorse官方说明](https://docs.modelstudio.console.alibabacloud.com/en/model-studio/happyhorse-api-reference);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。
## 完整嵌套字段说明
数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。
### 请求头
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `Content-Type` | string | 是 | 请求体格式为application/json。 |
### 请求体
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:happyhorse-1.1-t2v |
| `duration` | integer | 是 | 输出视频秒数。 最小值:1 |
| `resolution` | string | 是 | 输出分辨率档位,例如720p。 |
| `input` | object | 是 | 按生成模式填写的输入。 |
| `input.prompt` | string | 是 | 视频描述或运动说明。 |
| `input.media` | array[object] | 否 | 图生或参考生视频的素材;t2v可省略。 |
| `input.media[].type` | string | 是 | 素材类型。 可选值:first_frame, reference_image, reference_video |
| `input.media[].url` | string | 是 | 素材的可读取URL。 |
| `parameters` | object | 是 | 视频生成参数。 |
| `parameters.duration` | integer | 否 | 输出时长,与外层duration一致。 最小值:1 |
| `parameters.resolution` | string | 否 | 分辨率档位,例如720P。 |
| `wait` | boolean | 否 | false表示提交后立即返回任务;推荐使用后续查询。 默认:false |
### 响应 200
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `id` | string | 否 | 提交后返回的任务标识;作为不透明字符串原样保存。 |
| `model` | string | 否 | 任务型号。 |
| `status` | string | 否 | 任务状态;只有终态才结束查询。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown |
| `created_at` | integer | 否 | 创建时间,Unix秒。 |
| `content` | object | 否 | 部分视频型号的结果。 |
| `content.video_url` | string | 否 | 成功后的视频URL。 |
| `content.last_frame_url` | string | 否 | 提供时的末帧URL。 |
| `output` | object | 否 | 部分视频型号的输出对象。 |
| `output.video_url` | string | 否 | 成功后的视频URL。 |
| `output.task_status` | string | 否 | 提供时的原始任务状态。 |
| `video` | object | 否 | 部分视频型号的视频结果。 |
| `video.url` | string | 否 | 成功后的视频URL。 |
| `error` | object | 否 | 失败、取消或超时时的错误对象,成功时可能为null。 |
| `error.code` | string | 否 | 错误码。 |
| `error.message` | string | 否 | 错误说明。 |
### 响应 202
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `id` | string | 否 | 提交后返回的任务标识;作为不透明字符串原样保存。 |
| `model` | string | 否 | 任务型号。 |
| `status` | string | 否 | 任务状态;只有终态才结束查询。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown |
| `created_at` | integer | 否 | 创建时间,Unix秒。 |
| `content` | object | 否 | 部分视频型号的结果。 |
| `content.video_url` | string | 否 | 成功后的视频URL。 |
| `content.last_frame_url` | string | 否 | 提供时的末帧URL。 |
| `output` | object | 否 | 部分视频型号的输出对象。 |
| `output.video_url` | string | 否 | 成功后的视频URL。 |
| `output.task_status` | string | 否 | 提供时的原始任务状态。 |
| `video` | object | 否 | 部分视频型号的视频结果。 |
| `video.url` | string | 否 | 成功后的视频URL。 |
| `error` | object | 否 | 失败、取消或超时时的错误对象,成功时可能为null。 |
| `error.code` | string | 否 | 错误码。 |
| `error.message` | string | 否 | 错误说明。 |
### 错误响应结构
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `error` | object | 否 | 错误详情;以本次返回为准。 |
| `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 |
| `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 |
| `error.code` | string | 否 | 错误码,可能为空。 |
请求示例
curl --request POST https://api.router.ai/v1/videos/generations \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"model": "happyhorse-1.1-t2v",
"duration": 5,
"resolution": "720p",
"input": {
"prompt": "A fictional blue paper boat on a plain white background."
},
"parameters": {
"duration": 5,
"resolution": "720P"
},
"wait": false
}'
接口通用说明: Aliyun Wan 视频生成
GET /v1/videos/generations/{id}
查询本型号已提交任务的状态和结果,不创建新任务。
## 使用与响应约定
- 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。
- 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。
- 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。
- 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。
- 生成文件请及时保存;不要假设结果链接永久有效。
### 提交后查询同一任务
提交响应的 `id` 是后续查询依据,不要使用示例标识发起真实查询,也不要为了查询进度重新提交生成。使用 `GET /v1/videos/generations/{id}`。pending、submitted、processing表示尚未完成;succeeded、failed、timeout、canceled为终态。成功后读取该型号返回的 `content.video_url`、`output.video_url` 或 `video.url`,只使用实际存在的结果字段。
## 参考
参数术语参考[HappyHorse官方说明](https://docs.modelstudio.console.alibabacloud.com/en/model-studio/happyhorse-api-reference);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。
## 完整嵌套字段说明
数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。
### 路径参数
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `id` | string | 是 | 同一账号提交后返回的任务标识。 |
### 响应 200
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `id` | string | 否 | 提交后返回的任务标识;作为不透明字符串原样保存。 |
| `model` | string | 否 | 任务型号。 |
| `status` | string | 否 | 任务状态;只有终态才结束查询。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown |
| `created_at` | integer | 否 | 创建时间,Unix秒。 |
| `content` | object | 否 | 部分视频型号的结果。 |
| `content.video_url` | string | 否 | 成功后的视频URL。 |
| `content.last_frame_url` | string | 否 | 提供时的末帧URL。 |
| `output` | object | 否 | 部分视频型号的输出对象。 |
| `output.video_url` | string | 否 | 成功后的视频URL。 |
| `output.task_status` | string | 否 | 提供时的原始任务状态。 |
| `video` | object | 否 | 部分视频型号的视频结果。 |
| `video.url` | string | 否 | 成功后的视频URL。 |
| `error` | object | 否 | 失败、取消或超时时的错误对象,成功时可能为null。 |
| `error.code` | string | 否 | 错误码。 |
| `error.message` | string | 否 | 错误说明。 |
### 错误响应结构
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `error` | object | 否 | 错误详情;以本次返回为准。 |
| `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 |
| `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 |
| `error.code` | string | 否 | 错误码,可能为空。 |
请求示例
curl --request GET "https://api.router.ai/v1/videos/generations/$TASK_ID" \
--header "Authorization: Bearer $API_KEY"
接口通用说明: 查询视频任务