HappyHorse / Alibaba

HappyHorse 视频生成 API

HappyHorse 文生视频模型，输入文本提示词生成物理真实、运动流畅的视频内容。API 采用异步调用方式：先创建任务获取 task_id，再轮询查询结果。视频生成通常需要 1-5 分钟。

HTTP 调用流程

创建任务获取 task_id

POSThttps://nexusflow.hk/v1/tasks

根据 task_id 轮询结果

GEThttps://nexusflow.hk/v1/tasks/{task_id}

注意：

创建成功后，使用返回的 id（即 task_id）查询结果。请勿重复创建任务，轮询获取即可。
轮询建议间隔 10-15 秒。
task_id 查询有效期 24 小时，超时后无法查询。
视频 URL 有效期 24 小时，获取后请立即下载保存。

步骤1：创建任务

模型ID：happyhorse-1.0-t2v

请求参数

参数	类型	必选	说明
`model`	string	*	happyhorse-1.0-t2v 或 happyhorse-1.1-t2v（新一代，480P，最长 10 秒）
`prompt`	string	*	文本提示词，描述期望生成的视频内容。支持中英文，不超过 2500 个中文字符。
`resolution`	string	-	分辨率档位：720P（默认）或 1080P。影响计费：720P ¥0.9/秒，1080P ¥1.6/秒。
`ratio`	string	-	宽高比。可选值：16:9（默认）、9:16、1:1、4:3、3:4。
`duration`	integer	-	视频时长（秒），取值 [3, 15]，默认 5。
`watermark`	boolean	-	是否添加水印，默认 true。
`seed`	integer	-	随机种子 [0, 2147483647]，固定 seed 可提升可复现性。

请求示例

curl

curl -X POST 'https://nexusflow.hk/v1/tasks' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-t2v",
    "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。",
    "resolution": "1080P",
    "ratio": "16:9",
    "duration": 5
  }'

步骤1 响应：获取 task_id

创建成功后返回任务信息，id 即为 task_id，用于后续查询。

json

{
  "id": "task_0385dc79-5ff8-4d82-xxxx",
  "object": "task",
  "status": "running",
  "model": "happyhorse-1.0-t2v",
  "type": "video",
  "created_at": "2026-06-01T10:00:00.000Z"
}

字段	说明
`id`	任务ID（task_id），用于查询结果。有效期 24 小时。
`object`	固定值 "task"。
`status`	初始状态为 running。
`model`	所使用的模型 ID。
`type`	任务类型，视频生成固定为 "video"。
`created_at`	任务创建时间（ISO 8601 格式）。

步骤2：根据 task_id 轮询结果

GEThttps://nexusflow.hk/v1/tasks/{task_id}

查询请求

curl

curl https://nexusflow.hk/v1/tasks/task_0385dc79-5ff8-4d82-xxxx \
  -H "Authorization: Bearer $API_KEY"

任务执行成功

json

{
  "id": "task_0385dc79-5ff8-4d82-xxxx",
  "object": "task",
  "status": "succeeded",
  "model": "happyhorse-1.0-t2v",
  "type": "video",
  "progress": 100,
  "output": {
    "video_url": "https://nexusflow.hk/storage/xxx.mp4"
  },
  "created_at": "2026-06-01T10:00:00.000Z",
  "completed_at": "2026-06-01T10:02:36.000Z"
}

任务执行失败

json

{
  "id": "task_0385dc79-5ff8-4d82-xxxx",
  "object": "task",
  "status": "failed",
  "model": "happyhorse-1.0-t2v",
  "type": "video",
  "error": "InvalidParameter: The parameter is invalid.",
  "created_at": "2026-06-01T10:00:00.000Z",
  "completed_at": "2026-06-01T10:00:05.000Z"
}

响应参数

字段	类型	说明
`id`	string	任务 ID。
`status`	string	任务状态：pending（排队中）→ running（处理中）→ succeeded（成功）/ failed（失败）。
`progress`	integer	任务进度百分比 0-100。
`output.video_url`	string	生成的视频 URL（仅 succeeded 时返回）。MP4 格式，链接有效期 24 小时。
`error`	string	失败原因（仅 failed 时返回）。
`created_at`	string	任务创建时间。
`completed_at`	string	任务完成时间（仅终态时返回）。

计费说明

分辨率	单价	说明
happyhorse-1.0（720P）	¥0.9 / 秒	按输出视频时长计费（如 5 秒 = ¥4.5）
happyhorse-1.0（1080P）	¥1.6 / 秒	按输出视频时长计费（如 5 秒 = ¥8.0）
happyhorse-1.1（480P）	¥0.45 / 秒	新一代模型，仅 480P 档，最长 10 秒。提供 happyhorse-1.1-t2v / i2v / r2v。

适用于所有 HappyHorse 模型（t2v / i2v / r2v / video-edit）。仅对成功任务计费，失败任务不扣费。