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 查阅接口文档。