文生图
同步接口
请求 URL
POST https://wanqing.streamlakeapi.com/api/gateway/v1/images/generations
请求头
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
请求参数
字段 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
model | string | 必填 | 无 | 推理点 ID |
prompt | string | 必填 | 无 | 正向文本提示词 |
negative_prompt | string | 可选 | 无 | 负向文本提示词 |
size | string | 可选 | 1328*1328 | 生成图片的分辨率，格式为“宽*高”。支持自定义输出图片分辨率 qwen-image：总像素取值范围 [512*512，2048*2048] z-image-turbo：总像素取值范围 [352*352，2048*2048] |
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 'Content-Type: application/json' \
-d '{
"model": "ep-xxx",
"prompt": "一碗热气腾腾的日式豚骨拉面，放在深色的陶瓷碗里。汤汁浓郁，上面有完美的溏心蛋、几片肥瘦相间的叉烧肉、新鲜的葱花和笋片。背景是简约的木质餐桌，有柔和的侧光。风格：美食摄影，特写，景深效果，高细节，看起来很美味",
"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 |
prompt | string | 必填 | 无 | 正向文本提示词 |
negative_prompt | string | 可选 | 无 | 负向文本提示词 |
size | string | 可选 | 1328*1328 | 生成图片的分辨率，格式为“宽*高”。支持自定义输出图片分辨率 qwen-image：总像素取值范围 [512*512，2048*2048] z-image-turbo：总像素取值范围 [352*352，2048*2048] |
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",
"prompt": "一碗热气腾腾的日式豚骨拉面，放在深色的陶瓷碗里。汤汁浓郁，上面有完美的溏心蛋、几片肥瘦相间的叉烧肉、新鲜的葱花和笋片。背景是简约的木质餐桌，有柔和的侧光。风格：美食摄影，特写，景深效果，高细节，看起来很美味",
"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
}
}