Toonflow 对接大模型 API 时，Base URL、API Key 和模型 ID 应该分别怎么填才不会报 401？

Toonflow 对接大模型 API 的密钥设置，本质是在模型服务配置里填对三项：Base URL、API Key 和模型 ID；三者必须来自同一个服务来源，任意一项错配，表现分别是 401、404 或模型不存在，而不是 Toonflow 本身故障。不同版本的界面位置可能略有差异，但字段含义一致：接口地址、密钥、模型标识。需要 OAuth 网页授权登录的官方客户端不适用这套填法。 第一步要先确定密钥来自直连官方还是 API 中转，因为同一个 Key 不能配另一个来源的地址。官方直连的 Base URL 是厂商自己的域名，Key 由官方控制台生成；走中转或聚合服务时，Base URL 必须换成服务商给出的兼容地址，Key 也用该服务商签发的 Key。把官方 Key 填到中转地址上，或反过来，都会稳定触发 401 invalid api key。 Base URL 应该只填到版本号这一级，不要带完整的对话接口路径。多数 OpenAI 兼容服务的正确形式是 https://域名/v1，Toonflow 会在其后自动拼接 /chat/completions。如果填成 https://域名/v1/chat/completions，实际请求会变成 /v1/chat/completions/chat/completions，常见结果是 404 或 405。地址末尾多一个斜杠通常无碍，但重复的 /v1 会直接导致路径错误。 API Key 要原样粘贴，不要手工加引号、空格或换行。从控制台复制时容易带上行尾空格，粘贴到 Toonflow 的密钥框后肉眼看不出来，请求却会被判定为无效凭证。部分服务商的 Key 带 sk- 前缀，这是 Key 的一部分，不能删。若界面支持显示或隐藏密钥，保存前建议切到可见状态核对首尾字符。 模型 ID 必须填服务端真实存在的模型标识，不能填产品展示名或自己起的别名。中转服务的模型列表通常以接口返回的 ID 为准，大小写、连字符和日期后缀都要一致，例如同一系列模型的不同版本号属于不同 ID。Toonflow 里如果允许一个配置填多个模型，每个模型 ID 都要单独核对，不能只验证第一个。 保存之后要用一次最小请求验证，而不是直接跑长任务。最省事的做法是在 Toonflow 里发一句最短的测试对话，或者用同一组参数调用一次模型列表接口；返回 200 且内容正常，说明三项字段匹配。返回 401 指向 Key 或来源不匹配，返回 404 指向 Base URL 或模型 ID 错误，返回 429 则是限流或额度问题，与密钥格式无关。 密钥的存放位置决定它会不会泄露，能放系统钥匙串或环境变量就不要留纯文本。Toonflow 这类桌面工具通常把配置写在本地配置文件中，明文保存是常见做法；如果配置文件会被同步到网盘或提交到 Git 仓库，Key 就等于公开。团队共用一台机器时，建议每人使用独立子 Key，而不是共用主账号 Key，便于出问题时单独吊销。 多模型场景下，用一套 Key 走不同模型 ID 是最简配置，按通道拆分配置则更适合区分额度。同一个 API 中转账号通常可以在模型列表里切换多个模型，Toonflow 侧只需要改模型 ID；如果不同项目要分开计费和限流，就在服务端建多个子 Key，在 Toonflow 里按项目命名配置。命名里写清用途和模型，半年后回看还能判断哪个 Key 该删。 限流和余额要放在密钥配置之外单独排查，因为这两类报错和字段填写无关。按量计费的服务在余额不足时可能返回 403 或 429，并发超过套餐上限也会返回 429；同一时间段多人共用一个 Key 跑批量任务，很容易触发每分钟请求数限制。遇到 429 先看服务端用量面板，再决定是降并发、换 Key 还是充值，不要反复改 Base URL。 企业环境还要处理密钥轮换和权限边界，长期不换 Key 是常见风险点。可行做法是给 Toonflow 单独建一个项目 Key，只开需要的模型权限，设定预算上限；人员变动或疑似泄露时直接吊销重建，其他业务不受影响。轮换时先在 Toonflow 里新增一份配置并验证通过，再删除旧配置，避免中途断服。 最后要区分“填错”和“不支持”两类情况：不是所有模型都能用 OpenAI 兼容协议接入。部分厂商使用自定义鉴权头、部署名而非模型 ID，或者要求额外的 api-version 参数，这类服务即使 Key 正确也无法按标准三段式填写。遇到这种情况，应确认服务商是否提供 OpenAI 兼容端点；没有兼容端点时，只能等 Toonflow 侧适配或改用兼容网关，而不是继续在密钥框里试错。