售前咨询
快手万擎(Vanchin)
图生视频
更新时间：2026-07-13 19:43:40
异步接口
步骤1：创建任务获取任务ID
请求 URL
POST https://wanqing.streamlakeapi.com/api/gateway/v1/videos/generations
请求头
Authorization: Bearer YOUR_API_KEY
X-Ks-Wq-Async: enable
Content-Type: application/json
请求参数
字段 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
model | string | 必填 | 无 | 推理点 ID |
first_frame | string | 必填 | 无 | 首帧图片的url |
prompt | string | 必填 | 无 | 正向文本提示词 |
negative_prompt | string | 可选 | 无 | 负向文本提示词 |
resolution | string | 可选 | 480P | 生成视频的分辨率 wan2.2-i2v-a14b的枚举值：480P，720P |
duration | int | 可选 | 3 | 视频时长，取值范围：[3, 10] |
fps | int | 可选 | 20 | 每秒帧数，取值范围：[4, 32] wan2.2-i2v-a14b要求总帧数（fps × duration）需要是4的倍数 |
num_inference_steps | int | 可选 | 模型默认值 | 去噪步数，越大效果越好，延迟线性增长，取值范围：[1,100] |
seed | int | 可选 | 随机 | 随机数种子，使用相同的seed，生成结果会更加接近或者一致 |
guidance_scale | float | 可选 | 模型默认值 | 控制prompt的强度，数值越大，越贴近prompt |
请求样例
curl 'https://wanqing.streamlakeapi.com/api/gateway/v1/videos/generations' \
-H "Authorization: Bearer $WQ_API_KEY" \
-H "X-Ks-Wq-Async: enable" \
-H 'Content-Type: application/json' \
-d '{
"model": "ep-xxx",
"first_frame": "https://h2.static.yximgs.com/kcdn/cdn-kcdn112682/coffee.png",
"prompt": "咖啡杯中冒出袅袅的热气，缓缓上升并消散在空气中，咖啡液面有轻微的波光",
"negative_prompt": "没有动态，蒸汽效果夸张，杯子移动，画面抖动"
}'
响应格式
{
"data": {
"task_status": "PENDING", //任务状态，枚举值：PENDING、RUNNING、SUCCESS、FAILED、CANCELED
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx" //任务ID，系统生成
},
"request_id": "xxx" //请求ID，系统生成
}
status 枚举值定义：
- PENDING：任务等待调度中
- RUNNING：任务执行中
- SUCCESS：任务执行成功
- FAILED：任务执行失败
- CANCELED：任务取消
步骤2：根据任务ID查询结果
请求 URL
GET https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints/{endpointId}/tasks/{taskId}
请求头
Authorization: Bearer YOUR_API_KEY
请求样例
curl 'https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints/{endpointId}/tasks/{taskId}' \
-H "Authorization: Bearer $WQ_API_KEY"
响应格式
{
"request_id": "req-xxx", //请求ID，系统生成
"data": {
"task_id": "task-g2pyu3-1759150148", //任务ID，系统生成
"task_status": "SUCCESS", //任务状态，枚举值：PENDING、RUNNING、SUCCESS、FAILED、CANCELED
"content": [ // 生成视频的url链接列表，链接有效期为24小时，请及时下载并保存
{
"url": "xxx"
}
],
"submit_time": 1759150148, //任务提交时间，Unix时间戳、单位s
"end_time": 1759150172 //任务完成时间，Unix时间戳、单位s
}
}
该篇文档内容是否对您有帮助？
有帮助没帮助