参考生视频

异步接口

步骤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

请求参数

content 元素结构说明：

每个元素必须包含type字段，取值及结构如下：

1. 文本元素：type=text，通过text字段传递文本提示词，正向描述生成视频的内容，一条 content 中至多一个文本元素
2. 图片元素：type=image，需设置role=reference，通过url字段传递参考图片地址
3. 视频元素：type=video，需设置role=reference，通过url字段传递参考视频地址
4. 音频元素：type=audio，需设置role=reference，通过url字段传递参考音频地址，可用于音色匹配

约束：参考资源最多支持 6 张图片 + 2 个视频；content 中至少需要包含一个参考资源（image/video/audio）。

请求样例

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",
    "data": {
        "task_id": "task-g2pyu3-1759150148",
        "task_status": "SUCCESS",
        "content": [
            {
                "url": "xxx"
            }
        ],
        "submit_time": 1759150148,
        "end_time": 1759150172
    }
}

注意：生成视频的 url 链接有效期为 24 小时，请及时下载并保存。submit_time和end_time为 Unix 时间戳，单位为秒。