售前咨询
快手万擎(Vanchin)
文生视频
更新时间：2026-07-13 19:43:39
异步接口
步骤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 |
prompt | string | 必填 | 无 | 正向文本提示词 |
negative_prompt | string | 可选 | 无 | 负向文本提示词 |
size | string | 可选 | 480*832 | 生成视频的分辨率，格式为“宽*高” wan2.2-t2v-a14b的枚举值： 480P: 480*832 832*480 720P: 1280*720 720*1280 |
duration | int | 可选 | 3 | 视频时长，取值范围：[3, 10] |
fps | int | 可选 | 20 | 每秒帧数，取值范围：[4, 32] wan2.2-t2v-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",
"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
}
}