Stable Diffusion秋叶整合包V4独立版Python本地API连接指南

news2025/4/24 22:35:55

秋叶整合包V4独立版Python本地API连接指南

秋叶整合的Stable Diffusion V4独立版支持通过Python调用本地API实现自动化图像生成。以下是具体操作流程及注意事项：

一、启用API服务

启动器配置
• 在秋叶启动器的高级选项中添加以下参数：
```
--api --listen --port 7860  # 默认端口为7860，可自定义
```
• 点击“一键启动”，待控制台显示 Running on local URL: http://0.0.0.0:7860 表示API服务已启用。
端口验证
• 访问 http://127.0.0.1:7860/docs 查看Swagger接口文档，确认 /sdapi/v1/txt2img 等接口可用。

二、Python调用示例

基础代码框架

import json
import base64
import requests

# 配置API地址
API_URL = "http://127.0.0.1:7860/sdapi/v1/txt2img"

# 构建请求参数
payload = {
    "prompt": "1girl, long hair, realistic",
    "negative_prompt": "low quality, blurry",
    "steps": 30,
    "width": 512,
    "height": 768,
    "sampler_index": "Euler a",
    "cfg_scale": 7,
    "seed": -1
}

# 发送POST请求
response = requests.post(API_URL, json=payload)
result = response.json()

# 解码并保存图片
if "images" in result:
    image_data = base64.b64decode(result["images"][0])
    with open("output.png", "wb") as f:
        f.write(image_data)
    print("图片已保存至 output.png")
else:
    print("生成失败:", result.get("error", "未知错误"))

关键参数说明
• prompt：正向提示词（需英文，可用逗号分隔多个关键词）

• sampler_index：采样器类型（可选Euler a、DPM++ 2M Karras等）

• cfg_scale：提示词相关性（7-12为常用范围）

• seed：随机种子（-1为随机，固定数值可复现结果）

三、进阶功能扩展

多模型切换
• 通过 /sdapi/v1/options 接口动态切换模型：

model_payload = {"sd_model_checkpoint": "RealisticVisionV5.safetensors"}
requests.post("http://127.0.0.1:7860/sdapi/v1/options", json=model_payload)

批量生成与异步处理
• 设置 "batch_size": 4 实现单次多图生成

• 使用异步接口 /sdapi/v1/async-task 避免阻塞主线程。

ControlNet插件调用
• 在payload中添加ControlNet参数：

"alwayson_scripts": {
    "controlnet": {
        "args": [{
            "input_image": "base64编码的线稿图",
            "module": "canny",
            "model": "control_v11p_sd15_canny"
        }]
    }
}

四、常见问题排查

连接失败
• 检查防火墙是否放行7860端口

• 确认启动参数包含 --listen（允许本地访问）。
显存不足
• 添加 --medvram 或 --lowvram 参数启动整合包

• 降低生成分辨率（如512×512）。
依赖缺失
• 若提示缺少Python库，通过整合包内置的Python环境安装（路径参考：sd-webui-aki-v4/venv/Scripts/pip install requests）。