API 参考

异步任务 API

图像、视频等高时延模型统一使用任务接口。提交任务后返回任务状态；视频任务需要轮询，部分图像任务会直接返回 succeeded。

提交

POST /v1/tasks

创建任务；视频返回 running，部分图像直接返回 succeeded。

查询

GET /v1/tasks/{id}

读取任务状态、进度、输出和错误。

列表

GET /v1/tasks

列出当前 API Key 用户的最近任务。

请求参数

model必填图像或视频模型 ID，如 wan2.6-t2i、wan2.6-i2v、pixverse-v6、happyhorse-1.0-t2v。

prompt必填生成提示词。视频建议描述主体、动作、镜头、场景和光线。

size可选图像或视频尺寸，如 1024x1024、1280x720。

duration视频可选视频时长，按模型能力选择 5、8、10、15 等值。

img_url图生视频可选参考图 URL，用于 i2v/r2v 类型任务。

negative_prompt可选不希望出现的元素、风格或动作。

webhook_url暂不支持当前公开任务接口不会触发 webhook；生产系统请使用 GET /v1/tasks/{id} 轮询。

提交任务

curl https://nexusflow.hk/v1/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.6-t2i",
    "prompt": "生成一张科技产品海报",
    "size": "1024x1024"
  }'

查询任务

curl https://nexusflow.hk/v1/tasks/task_xxx \
  -H "Authorization: Bearer $API_KEY"

查看完整 Tasks 文档