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

---

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

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

---

一、启用API服务

1. 启动器配置

   • 在秋叶启动器的 高级选项 中添加以下参数：

   --api --listen --port 7860  # 默认端口为7860，可自定义

   • 点击"一键启动"，待控制台显示 Running on local URL: http://0.0.0.0:7860 表示API服务已启用。

2. 端口验证

   • 访问 http://127.0.0.1:7860/docs 查看Swagger接口文档，确认 /sdapi/v1/txt2img 等接口可用。

---

二、Python调用示例

1. 基础代码框架

   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", "未知错误"))

2. 关键参数说明

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

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

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

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

---

三、进阶功能扩展

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)

2. 批量生成与异步处理

   • 设置 "batch_size": 4 实现单次多图生成

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

3. ControlNet插件调用

   • 在payload中添加ControlNet参数：

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

---

四、常见问题排查

1. 连接失败

   • 检查防火墙是否放行7860端口

   • 确认启动参数包含 --listen（允许本地访问）。

2. 显存不足

   • 添加 --medvram 或 --lowvram 参数启动整合包

   • 降低生成分辨率（如512×512）。

3. 依赖缺失

   • 若提示缺少Python库，通过整合包内置的Python环境安装（路径参考：sd-webui-aki-v4/venv/Scripts/pip install requests）。

---

五、性能优化建议

• 启用xFormers加速：启动参数添加 --xformers 提升生成速度并降低显存占用。

• 硬件适配：NVIDIA显卡建议安装CUDA 11.8+驱动，40系显卡启用FP8优化。

---

通过上述方法，可高效实现秋叶整合包的本地API调用。如需更详细参数说明，可访问 http://127.0.0.1:7860/docs 查阅接口文档。