配置 API 渠道与默认模型

开始前准备

准备服务商提供的 API Base URL、API Key 和准确的模型名称。文字、图片、视频和音频可以使用不同渠道；先配置当前需要的能力即可。

操作步骤

1 打开配置并填写渠道

点击顶部配置图标，进入“配置与用户偏好”。在“本地模型渠道”点击“新增渠道”。这里的“本地”指当前浏览器直连 API，不要求安装本地 GPU 模型。

填写渠道名称，选择对应协议，再输入 Base URL 和 API Key。Base URL 是模型接口地址，不能填写画布地址 http://localhost:4420。

2 测试连接并选择模型

点击“测试连接”，查看渠道下方的返回信息。测试不提交媒体生成。点击渠道右侧“选择”管理可用模型；也可使用“拉取全部渠道”刷新列表。有特定渠道时，按钮可能显示“拉取可用渠道模型”。

服务商不提供列表接口时，按其说明添加准确模型名。模型名称出现在列表中，不代表账号已有调用权限。

3 分别设置四类默认模型

依次核对“默认生图模型”“默认视频模型”“默认文本模型”“默认音频模型”。不用的能力可稍后配置。最后点击“完成”。

回到图片或视频节点，检查当前模型和路线。Agent 选择的文字模型与图片节点使用的生成服务是分开的。

确认完成

重新打开配置，渠道和默认模型仍保留；节点能够选择对应模型。用一个小任务验证实际能力后，再制作正式素材。

遇到问题

• 模型列表为空：检查协议、接口地址与鉴权，确认该渠道是否支持查询模型。
• 测试通过但生成失败：检查模型权限、额度、参数和媒体支持，并读取具体错误。
• 能聊天但不能生图：文字模型不自动提供生图服务。检查图片节点类型和对应渠道。

选择 API 还是本地服务

完整版保留三条独立路线：API 渠道负责云端模型请求，Agent 负责规划与画布操作，ComfyUI 负责连接你自己的工作流。能在 Agent 中聊天，不代表云端生图或本地 ComfyUI 都已配置完成。

使用本地模型时，继续阅读连接 ComfyUI。服务测试只确认连接，模型和自定义节点仍需在 ComfyUI 上安装并跑通。