图片编辑
同步接口
请求 URL
POST https://wanqing.streamlakeapi.com/api/gateway/v1/images/generations
请求头
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
请求参数
字段 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
model | string | 必填 | 无 | 推理点 ID |
images | list | 必填 | 无 | 参考图片的url数组，支持1-3张图片 |
prompt | string | 必填 | 无 | 正向文本提示词 |
negative_prompt | string | 可选 | 无 | 负向文本提示词 |
size | string | 可选 | 1024*1024 | 生成图片的分辨率，格式为“宽*高” qwen-image-edit-2509的枚举值是：1024*1024，1152*864，864*1152，1280*720，720*1280 |
num_inference_steps | int | 可选 | 模型默认值 | 去噪步数，越大效果越好，延迟线性增长，取值范围：[1,100] |
seed | int | 可选 | 随机 | 随机数种子，使用相同的seed，生成结果会更加接近或者一致 |
guidance_scale | float | 可选 | 模型默认值 | 控制prompt的强度，数值越大，越贴近prompt |
请求样例
curl 'https://wanqing.streamlakeapi.com/api/gateway/v1/images/generations' \
-H "Authorization: Bearer $WQ_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "ep-xxx",
"images": ["https://h2.static.yximgs.com/kcdn/cdn-kcdn112682/table.png", "https://h2.static.yximgs.com/kcdn/cdn-kcdn112682/cactus.png"],
"prompt": "将输入图片1中的白色马克杯，精确地替换成输入图片2中的盆栽仙人掌。保持办公桌背景不变，确保仙人掌的阴影和光照与周围环境自然融合",
"negative_prompt": "漂浮, 拼接痕迹, 不自然的阴影, 模糊的边缘, 两个物体同时出现, 原始的马克杯"
}'
响应格式
{
"request_id": "req-xxx", //请求ID，系统生成
"data": {
"content": [ // 生成图片的url链接列表，链接有效期为24小时，请及时下载并保存
{
"url": "xxx"
}
]
}
}
异步接口
步骤1：创建任务获取任务ID
请求 URL
POST https://wanqing.streamlakeapi.com/api/gateway/v1/images/generations
请求头
Authorization: Bearer YOUR_API_KEY
X-Ks-Wq-Async: enable
Content-Type: application/json
请求参数
字段 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
model | string | 必填 | 无 | 推理点 ID |
images | list | 必填 | 无 | 参考图片的url数组，支持1-3张图片 |
prompt | string | 必填 | 无 | 正向文本提示词 |
negative_prompt | string | 可选 | 无 | 负向文本提示词 |
size | string | 可选 | 1024*1024 | 生成图片的分辨率，格式为“宽*高” qwen-image-edit-2509的枚举值是：1024*1024，1152*864，864*1152，1280*720，720*1280 |
n | int | 可选 | 1 | 生成图片数量，取值范围：[1,4] |
num_inference_steps | int | 可选 | 模型默认值 | 去噪步数，越大效果越好，延迟线性增长，取值范围：[1,100] |
seed | int | 可选 | 随机 | 随机数种子，使用相同的seed，生成结果会更加接近或者一致 |
guidance_scale | float | 可选 | 模型默认值 | 控制prompt的强度，数值越大，越贴近prompt |
请求样例
curl 'https://wanqing.streamlakeapi.com/api/gateway/v1/images/generations' \
-H "Authorization: Bearer $WQ_API_KEY" \
-H "X-Ks-Wq-Async: enable" \
-H 'Content-Type: application/json' \
-d '{
"model": "ep-xxx",
"images": ["https://h2.static.yximgs.com/kcdn/cdn-kcdn112682/table.png", "https://h2.static.yximgs.com/kcdn/cdn-kcdn112682/cactus.png"],
"prompt": "将输入图片1中的白色马克杯，精确地替换成输入图片2中的盆栽仙人掌。保持办公桌背景不变，确保仙人掌的阴影和光照与周围环境自然融合",
"negative_prompt": "漂浮, 拼接痕迹, 不自然的阴影, 模糊的边缘, 两个物体同时出现, 原始的马克杯"
}'
响应格式
{
"data": {
"task_status": "PENDING", //任务状态，枚举值：PENDING、RUNNING、SUCCESS、FAILED、CANCELED、RISK_CONTROLLED
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx" //任务ID，系统生成
},
"request_id": "xxx" //请求ID，系统生成
}
步骤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、RISK_CONTROLLED
"content": [ // 生成图片的url链接列表，链接有效期为24小时，请及时下载并保存
{
"url": "xxx"
}
],
"submit_time": 1759150148, //任务提交时间，Unix时间戳、单位s
"end_time": 1759150172 //任务完成时间，Unix时间戳、单位s
}
}