接上以后，确认真的能用。
第一次配置，从安装和接入教程开始。已经遇到报错，直接选择下面的现象。每项都有下一步，也可以点击右下角「问 APIGate」描述问题。
先认清这几个配置项
- API Key
- 在 APIGate 账户中创建的密钥；只粘贴到指定凭据入口，不放进普通聊天。
- Base URL
- OpenAI 兼容入口为
https://api.apigate.biz/v1；其他协议请按对应客户端教程填写，不把完整请求路径当成 Base URL。 - Model ID
- 从实时模型目录复制精确名称，不能凭展示名称猜测。
- env_key
- Codex 配置中填写变量名
APIGATE_API_KEY，不是密钥本身。 - wire_api
- Codex 的 APIGate 示例使用
responses；聊天接口可用不代表所有工具都兼容。
命令与配置的复制按钮、Mac／Windows 分步操作见接入教程。Codex 配置字段依据 OpenAI 官方配置参考核对。
Key 不分模型，具体用哪个模型在哪里选？
API Key 是调用凭证，Base URL 决定发到哪个平台，Model ID（请求里的 model 字段）决定本次使用哪个模型。通常同一把 Key 可调用多个已授权模型；能用哪些，还受组织／项目权限与限额限制。Key 的备注名称不决定模型或价格，把 Key 改名为“K3”不会切换模型。通过 APIGate 时，用 APIGate Key、对应协议的 APIGate 地址和站内目录中的 Model ID；厂商直连则用该厂商的 Key 与地址，不能混用。费用看实际平台、模型及用量，网页会员也不等于 API 余额。
下一步：先阅读接入课前面的四项设置对照和四道理解题，无需充值或发送请求；实际换模型前核对目录、权限与价格。
打开相关操作页面 →安装后，怎样接入并确认成功？
请按四步验收：① 在接入教程选择您的客户端及 Mac／Windows 路线，准备 APIGate Key、对应协议的 Base URL 和实时目录中的精确 Model ID。② 保存设置，完全退出并重新打开客户端，新建任务要求只回复 APIGATE_OK。③ 在练习文件夹放入一份不含敏感资料的文本，让智能体读取并概括，核对工具执行记录与结果。④ 回 APIGate 控制台核对同一时间、对应 Key／模型的新用量记录。只收到 APIGATE_OK，或模型自称身份，都不能单独证明已走 APIGate；CLI 成功也不等于桌面端成功。
下一步：每一步成功后再继续；找不到对应记录，先检查当前供应商和生效配置。
打开相关操作页面 →401：Key 无效或认证失败
401 表示认证未通过，不等于网络完全不通。先核对 Base URL 与 Key 是否属于同一平台：APIGate 接口使用 APIGate 的 ats_ Key，不能混用厂商官网 Key。检查是否漏贴、多了空格、Key 已停用，以及当前客户端是否读到了正确凭据。若是上游返回的认证错误，重新创建 APIGate Key 未必有用，需要客服核查渠道。请勿发送完整 Key。
下一步：修正后只发一次最小测试，并在控制台核对；仍失败，提交已脱敏的报错与时间。
打开相关操作页面 →402／quota／支出上限：先区分是哪一层
额度错误应先区分 APIGate 与上游渠道。APIGate 的 402 中，insufficient_balance 是余额不足，monthly_budget_exceeded 是月预算上限，api_key_limit_exceeded 是单 Key 上限；请先核对再决定充值或调整限额。上游也可能返回 quota／组织支出上限错误，给 APIGate 充值不一定能解决。官网能打开不代表该模型的 API 渠道可用；备用线路也可能受独立的上游额度限制，不能据此断定共用同一账单。助手看不到个人账单；请通过私人工单让客服按失败时间、模型和脱敏错误核查。
下一步：确认限制来源、处理后，做一次新请求；不要反复重试或盲目充值。
打开相关操作页面 →429：限流、过载和额度不足不是一回事
429 不能只按“请求太快”处理，要看 error.type、code 和 message。rate_limit_exceeded／rate_limit_reached_error：降低频率和并发，按 Retry-After 等待；quota／支出上限：核对额度及限制来源，持续重试无效；engine_overloaded_error：上游容量紧张，稍后再试，充值不能直接消除过载。APIGate 自身限流返回 Retry-After: 60；上游错误可能不同，以实际响应为准。仍失败请提交时间、模型、状态码及脱敏报错，不要提交完整 Key。
下一步：只根据这一笔请求的完整错误判断，不要仅凭 429 决定充值。
打开相关操作页面 →403／404／unsupported_model：模型、权限还是地址？
先看完整错误。APIGate 的 400 unsupported_model 表示模型不在当前可用价目中，应从实时模型目录复制精确 Model ID。上游的模型不存在／无权限错误，可能是名称写错、该渠道未提供或账号未获授权，不能仅凭 404 判定模型下线。若是 404 /v1/responses，检查 Base URL、是否重复拼接 /v1，以及所选渠道是否支持 Responses；不要把完整请求路径当 Base URL。403 还可能涉及接口权限或访问策略。目录中的模型名称不能保证每个渠道、每种工具都支持；仍失败交由客服核查。
下一步：修正名称或地址后发一次最小请求；不要猜模型别名，也不要自动更换付费模型。
打开相关操作页面 →改了配置没生效／env_key 应该填什么？
Codex 的 env_key 应填环境变量名，例如 APIGATE_API_KEY，不是完整 ats_ 密钥；密钥应按教程设置到环境中。APIGate 示例的 base_url 是 https://api.apigate.biz/v1，wire_api 是 responses。修改前备份配置，同名字段保留一份；检查当前供应商、启动 profile、项目配置，以及 CC Switch 是否覆盖设置。完全退出后重开客户端并新建任务，再核对控制台调用记录。终端环境变量不一定被已打开的桌面程序继承；CLI 测试成功不能代替桌面端验收。
下一步：Mac／Windows 使用各自的接入步骤，不要复制另一系统的环境命令。
打开相关操作页面 →400：参数或上下文不受支持
400 通常需要核对请求参数，而非反复重试。同样是 400，unsupported_model 应检查模型目录；unsupported_endpoint 应核对该模型的专用入口；search_context_size 等参数不支持，应按该渠道文档关闭对应选项或更新客户端配置；上下文超限应缩短输入或输出上限。聊天可用不代表网页搜索、文件和工具调用都兼容，不要盲目增大上下文配置。
下一步：保留脱敏的 error.type／message，修改一个相关选项后再测试。
打开相关操作页面 →超时／500／502／503／504：请求没有完成
先区分 DNS／网络连接失败与已经收到的 HTTP 错误。500／502／503／504 可能来自网关或上游，仅凭状态码不能确定故障位置。先等待再做一次短请求，避免连续提交长任务；必要时缩短输入并检查客户端网络或代理。网页能打开只证明网页可访问，不证明模型 API 正常。记录失败时间、时区、客户端、模型、状态码和 request_id（如有），脱敏后交给客服核查。
下一步：不要凭超时认定请求从未执行；涉及付费任务时先核对用量，再决定重试。
打开相关操作页面 →仍未解决，准备这几项再联系支持
记录时间与时区、客户端及版本、所选模型、HTTP 状态码、脱敏的 error.type／code／message，以及 request_id（如有）。通过登录后的私人网页工单提交。不要提供完整 Key、密码或验证码；截图也要遮盖。
本页说明一般排查方法，不代表已检查您的个人账户或某条上游线路。更新：2026-09-30.2。