VIDEO / 视频生成

视频生成 API

统一视频生成接口，支持 Wan、HappyHorse、PixVerse 等多模型。API 采用异步调用方式：先创建任务获取 task_id，再轮询查询结果。视频生成通常需要 1-5 分钟。

HTTP 调用流程

创建任务获取 task_id

POSThttps://nexusflow.hk/v1/tasks

根据 task_id 轮询结果

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

支持模型

模型 ID	供应商	模式	720P 单价	1080P 单价
`wan2.6-t2v`	Wan / Alibaba	文生视频	¥0.6 / 秒	¥1 / 秒
`wan2.6-i2v`	Wan / Alibaba	图生视频	¥0.6 / 秒	¥1 / 秒
`happyhorse-1.0-t2v`	HappyHorse / Alibaba	文生视频	¥0.9 / 秒	¥1.6 / 秒
`happyhorse-1.0-i2v`	HappyHorse / Alibaba	图生视频	¥0.9 / 秒	¥1.6 / 秒
`pixverse-v6`	PixVerse	文生视频	¥0.36 有声 / ¥0.27 无声	¥0.68 有声 / ¥0.53 无声

按输出视频时长计费（如 720P 5 秒 = 单价 x 5）。仅对成功任务计费，失败任务不扣费。

注意事项：

视频生成仅支持异步调用，不提供同步接口。创建任务后请使用 id（即 task_id）轮询结果，请勿重复创建任务。
轮询建议间隔 10-15 秒，并对失败重试使用指数退避。
task_id 查询有效期 24 小时，超时后无法查询。
视频 URL 有效期 24 小时，获取后请立即下载保存。

请求参数

参数	类型	必选	说明
`model`	string	*	视频模型 ID，见上方「支持模型」表。例如 wan2.6-t2v、happyhorse-1.0-i2v、pixverse-v6。
`prompt`	string	*	文本提示词，描述期望生成的视频内容。支持中英文，建议写清主体、动作、镜头与风格。
`resolution`	string	-	分辨率档位：720P（默认）或 1080P。不同档位对应不同计费价格。
`ratio`	string	-	宽高比。可选值：16:9（默认）、9:16、1:1、4:3、3:4。部分模型可能仅支持子集。
`duration`	integer	-	视频时长（秒），取值 [3, 15]，默认 5。具体范围取决于模型。
`img_url`	string	-	首帧参考图 URL（JPG/PNG/WEBP，≤10MB）。图生视频模式下必填。
`watermark`	boolean	-	是否添加水印，默认 true。
`seed`	integer	-	随机种子 [0, 2147483647]，固定 seed 可提升可复现性。

代码示例

# 步骤1：创建文生视频任务
curl -X POST 'https://nexusflow.hk/v1/tasks' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.6-t2v",
    "prompt": "黄昏城市海岸线，镜头缓慢推进，电影感自然光，细腻真实风格",
    "resolution": "1080P",
    "ratio": "16:9",
    "duration": 5
  }'

# 返回 → { "id": "task_abc123...", "status": "running", ... }

# 步骤2：轮询查询结果（建议间隔 10-15 秒）
curl https://nexusflow.hk/v1/tasks/task_abc123 \
  -H "Authorization: Bearer $API_KEY"

# 返回 → { "status": "succeeded", "output": { "video_url": "https://..." }, ... }

步骤1 响应：获取 task_id

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

{
  "id": "task_0385dc79-5ff8-4d82-xxxx",
  "object": "task",
  "status": "running",
  "model": "wan2.6-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 https://nexusflow.hk/v1/tasks/task_0385dc79-5ff8-4d82-xxxx \
  -H "Authorization: Bearer $API_KEY"

任务执行成功

{
  "id": "task_0385dc79-5ff8-4d82-xxxx",
  "object": "task",
  "status": "succeeded",
  "model": "wan2.6-t2v",
  "type": "video",
  "progress": 100,
  "output": {
    "video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx.mp4"
  },
  "created_at": "2026-06-01T10:00:00.000Z",
  "completed_at": "2026-06-01T10:02:36.000Z"
}

任务执行失败

{
  "id": "task_0385dc79-5ff8-4d82-xxxx",
  "object": "task",
  "status": "failed",
  "model": "wan2.6-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 API

查看 HappyHorse 模型专属接口文档