先弄清：Automatic1111 的“API Key”到底是什么

Automatic1111 通常指 Stable Diffusion WebUI 的常用开源界面。它本身更像一个本地运行的AI绘画工具，并不强制要求注册官方账号，也没有统一的官方“API Key”。

很多教程里提到的 API Key，实际可能对应三种情况：

• 第一，启动 WebUI API 后设置的访问用户名和口令；
• 第二，调用第三方模型托管、云端推理或图像服务时获得的密钥；
• 第三，某些插件连接外部服务时要求填写的授权令牌。

因此，配置前要先判断自己的使用场景。如果只是让本机脚本调用 Automatic1111 生成图片，重点是开启 API 与设置认证。如果要下载模型、使用云端接口或安装插件，则可能需要在对应平台注册账号并获取密钥。不要把不同平台的密钥混用，也不要把密钥写进公开仓库、截图或群聊记录中。

准备工作：环境、目录与基础检查

环境检查

在配置 API 前，建议先确认 WebUI 能正常启动。常见环境包括 Windows、Linux 或 macOS，显卡环境以 NVIDIA CUDA 最常见。

基础准备

基础准备包括：安装 Python 3.10.x、Git、显卡驱动；准备 WebUI 主目录；放置基础模型文件到 models/Stable-diffusion 目录；首次启动后确认页面可以打开并完成一次出图测试。

如果机器配置较低，可以在启动参数中加入省显存选项，例如 --medvram 或 --lowvram。如果只用于接口调用，也可以保持默认界面运行，不必额外安装大量插件。目录建议不要放在中文路径或权限复杂的系统目录下，避免依赖安装失败、路径转义异常和权限不足。

账号注册：哪些情况才需要注册

本地 Automatic1111 不需要注册账号，但以下场景通常需要账号：

• 下载受限模型资源；
• 调用云端推理接口；
• 使用商业素材管理平台；
• 安装需要授权的插件服务。

注册时应优先选择正规平台，使用独立邮箱，开启登录保护，并记录平台名称、用途、密钥创建时间和权限范围。

注册完成后，不要急着把密钥填到 WebUI。先查看平台控制台中是否支持创建不同权限的密钥，例如“只读”、“推理调用”、“模型下载”等。能限制权限就不要使用全权限密钥；能设置有效期就设置有效期；能绑定来源地址就按实际情况绑定。这样即使密钥误泄露，也能降低损失。

密钥获取：本地 API 认证与第三方 Key 的区别

本地 API 认证

如果你的目标是让程序访问 Automatic1111，本地侧常用方式不是申请 API Key，而是通过启动参数启用 API 并设置访问认证。进入 WebUI 目录，找到启动脚本。Windows 常见为 webui-user.bat，Linux 或 macOS 常见为 webui-user.sh，在 COMMANDLINE_ARGS 中加入参数。

常见写法是开启接口并增加认证：--api --api-auth 用户名:口令。口令应足够复杂，避免使用 123456、admin、test 等弱口令。配置后重新启动 WebUI，控制台出现正常监听信息，即表示 API 服务已开启。默认情况下接口通常运行在本机 127.0.0.1 或 7860 端口，可通过本机程序调用。

第三方平台密钥

如果是第三方平台密钥，一般在平台的“开发者”、“API”、“访问令牌”或“密钥管理”页面创建。创建后只显示一次的密钥必须立即复制到安全位置，例如本机密码管理工具或受控的环境变量。不要直接写进 Python 文件、前端页面或可被多人访问的配置文件中。插件需要填写时，也应确认插件来源可信、更新记录正常、权限说明清楚。

开启 Automatic1111 API 的操作步骤

第一步，确认 WebUI 已能正常打开。先双击或执行启动脚本，等待依赖安装完成，页面能进入并生成一张测试图。

第二步，编辑启动参数。Windows 打开 webui-user.bat，找到 set COMMANDLINE_ARGS=，在等号后添加 --api --api-auth myuser:强口令。Linux 或 macOS 打开 webui-user.sh，在 COMMANDLINE_ARGS 后加入同类参数。

第三步，重启服务。关闭原来的命令行窗口后重新启动，观察是否报错。如果端口被占用，可以增加 --port 7861 等参数更换端口。

第四步，测试接口。打开本机接口文档地址，通常为 http://127.0.0.1:7860/docs。若设置了认证，访问或调用时需要带上对应用户名和口令。脚本调用时推荐在本机环境变量中读取认证信息，而不是硬编码。

第五步，确认基础接口可用。常见接口包括生成图片、获取模型列表、切换模型、读取进度等。测试时先使用低分辨率和少步数参数，避免一次请求占满显存导致服务卡死。

国内网络设置：提高安装与下载成功率

在国内网络环境下，依赖安装、模型下载和插件更新可能会遇到连接慢或中断。更稳妥的做法是使用国内常见软件源、提前下载模型文件、减少启动时在线拉取依赖。Python 依赖可配置为可信的国内镜像源，Git 项目可选择稳定网络时段更新，模型资源可优先使用平台提供的直链、网盘或国内社区镜像。

安装依赖时建议固定版本，不要频繁混装不同教程里的命令。若 requirements 安装失败，可先升级 pip，再分批安装缺失包。对于 PyTorch，需要根据显卡驱动和 CUDA 版本选择匹配安装命令，不能盲目复制。模型文件体积较大，下载后应校验文件大小与格式，常见格式包括 safetensors 和 ckpt，优先选择 safetensors 格式并来源可靠的文件。

如果公司或校园网络对端口访问有管理要求，应遵守所在环境规定。不要把 WebUI 服务随意暴露到公网。确需局域网访问时，可使用 --listen 让同一内网设备访问，但必须同时设置 --api-auth，并配合防火墙限制访问范围。家庭或个人用户通常建议保持本机访问即可。

常见问题与处理办法

问题一：打开 /docs 没反应。 先确认启动参数里确实有 --api，再看控制台是否显示服务地址。若端口被占用，换端口重启；若被安全软件拦截，允许本机访问即可。

问题二：接口返回 401 或认证失败。 检查用户名、口令是否和 --api-auth 完全一致，冒号两侧不要加多余空格。脚本调用时注意 Basic Auth 格式，不要把用户名和口令当作普通参数传错位置。

问题三：插件提示缺少 Key。 确认该插件连接的是哪个外部服务，再去对应平台创建密钥。不要把 WebUI 的认证口令填到第三方 Key 输入框中，两者不是同一种东西。

问题四：生成任务卡住。 降低分辨率、采样步数和批量数量，检查显存占用。必要时重启 WebUI，避免多个请求同时排队造成显存不足。

问题五：安装依赖反复失败。 优先检查 Python 版本、路径权限、网络连通性和 pip 源设置。不要在同一目录里混用多个虚拟环境，必要时备份模型和配置后重新拉取干净版本。

安全边界：别把本地工具变成风险入口

Automatic1111 的 API 能直接触发显卡计算、读取部分配置并管理模型。如果没有认证或暴露到不可信网络，可能被他人占用资源，甚至造成文件与配置风险。

最低限度应做到：

• 开启认证；
• 使用强口令；
• 只在本机或受控内网访问；
• 不公开端口；
• 不在日志和截图中展示密钥。

第三方密钥要按用途分开创建。下载模型的密钥、云端推理的密钥、插件服务的密钥不要共用。发现泄露后第一时间在平台后台停用旧密钥并新建。多人协作时，优先使用环境变量、配置模板和权限分级，不要把真实密钥放进共享文档。

实用建议：稳定比追新更重要

AI绘画工具更新很快，但生产环境不建议每天追最新版。已经稳定运行的版本，可以先记录当前 Git 提交、插件版本、启动参数和模型清单，再升级测试。升级前备份 webui-user 脚本、config.json、styles.csv、extensions 目录和常用模型索引。出现故障时，先回退插件，再回退主程序，不要同时改动太多变量。

对于个人创作，本机 API 足够完成批量出图、提示词实验和工作流自动化。对于团队场景，应增加任务队列、访问控制和日志审计，避免多人同时请求导致服务崩溃。合理配置账号、密钥与网络环境后，Automatic1111 可以成为稳定的本地AI绘画接口，而不是只能手动点按钮的界面工具。