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 单价
`seedance-2.0`	Seedance / Volcengine	文生/首帧/首尾帧/多模态	¥0.99 / 秒	¥2.48 / 秒
`seedance-1.5-pro`	Seedance / Volcengine	文生/首帧/首尾帧/样片	¥0.35 有声 / ¥0.17 无声	¥0.78 有声 / ¥0.39 无声
`seedance-1.0-pro-fast`	Seedance / Volcengine	文生/首帧	¥0.09 / 秒	¥0.20 / 秒
`wan2.6-t2v`	Wan / Alibaba	文生视频	¥0.6 / 秒	¥1 / 秒
`wan2.6-i2v`	Wan / Alibaba	图生视频	¥0.6 / 秒	¥1 / 秒
`wan2.7-t2v`	Wan / Alibaba	文生视频	¥0.6 / 秒	—
`wan2.7-i2v`	Wan / Alibaba	图生视频	¥0.6 / 秒	—
`wan2.7-r2v`	Wan / Alibaba	参考生视频	¥0.6 / 秒	—
`wan2.7-videoedit`	Wan / Alibaba	视频编辑	¥0.6 / 秒	—
`wan3.0-video`	Wan / Alibaba	文生视频	480P ¥0.3 / 秒	—
`wan3.0-video-prime`	Wan / Alibaba	文生视频（旗舰）	480P ¥0.45 / 秒	—
`happyhorse-1.0-t2v`	HappyHorse / Alibaba	文生视频	¥0.9 / 秒	¥1.6 / 秒
`happyhorse-1.0-i2v`	HappyHorse / Alibaba	图生视频	¥0.9 / 秒	¥1.6 / 秒
`happyhorse-1.1-t2v`	HappyHorse / Alibaba	文生视频	480P ¥0.45 / 秒	—
`happyhorse-1.1-i2v`	HappyHorse / Alibaba	图生视频	480P ¥0.45 / 秒	—
`happyhorse-1.1-r2v`	HappyHorse / Alibaba	参考生视频	480P ¥0.45 / 秒	—
`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，见上方「支持模型」表。例如 seedance-2.0（旗舰版，4K HDR 多模态参考）、wan2.6-t2v、happyhorse-1.0-i2v、pixverse-v6。Seedance 系列专属参数详见 /docs/api/seedance。
`prompt`	string	*	文本提示词，描述期望生成的视频内容。支持中英文，建议写清主体、动作、镜头与风格。
`resolution`	string	-	分辨率档位：720P（默认）或 1080P。不同档位对应不同计费价格。
`ratio`	string	-	Wan 文生视频支持 16:9（默认）、9:16、1:1；其他视频模型按各自说明。服务端会将 resolution + ratio 转换成精确 size。
`size`	string	-	Wan 可直接传精确尺寸，如 1280*720；兼容 1280x720 写法并自动规范化。与 resolution + ratio 二选一。
`duration`	integer	-	视频时长（秒），取值 [3, 15]，默认 5。具体范围取决于模型。
`img_url`	string	-	首帧参考图 URL（JPG/PNG/WEBP，≤10MB）。图生视频模式下必填。
`watermark`	boolean	-	是否添加水印，默认 true。
`seed`	integer	-	随机种子 [0, 2147483647]，固定 seed 可提升可复现性。

代码示例

text

# 步骤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，用于后续查询。

json

{
  "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

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": "wan2.6-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": "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 模型专属接口文档