地址、协议、Key、分组和模型必须与客户端教程一致。
1. 打开对应客户端教程
2. 核对请求地址和协议
3. 核对 Key、分组和模型
4. 保存、启用并重启客户端
https://api.zhiwei.dpdns.org。手动配置 Codex 时使用内置 OpenAI provider：
openai_base_url = "https://api.zhiwei.dpdns.org"不要添加 /v1、/responses 或 /login。完整说明见 OpenAI Responses / Codex。
常用根地址是 https://api.zhiwei.dpdns.org；OpenAI Compatible 使用 https://api.zhiwei.dpdns.org/v1；手写 Gemini HTTP 请求和 OpenCode 的 Gemini provider 使用 https://api.zhiwei.dpdns.org/v1beta。只填写客户端要求的 Base URL，不要重复拼接 /v1、 /v1beta、/chat/completions 或其他接口路径。
直接卸载 Codex 和 CC Switch，重新下载并安装最新版。安装完成后检查两个软件的版本，再通过“导入 CCS”重新导入并启用 智维；保留 CC Switch 自动映射的模型，完全退出 Codex 后重新打开。完整顺序见卸载并重新安装最新版。
同一状态码可能对应不同原因，请同时查看完整错误文字，尤其要区分两类 429。先返回对应客户端教程，逐项核对协议、请求地址、API Key、分组和模型；确认配置已经保存并启用，再完全退出客户端后重新打开。配置无误时，再关闭或更换 VPN、切换网络。仍持续报错时，可能是模型厂商服务暂时异常。
400 / invalid_request_error原因：请求格式不符合模型厂商接口要求，常见原因是协议、地址或参数没有按教程配置。
处理：返回对应客户端教程，逐项核对协议、Base URL、模型和请求参数。保存并启用配置后，完全重启客户端；Codex 使用 Responses 协议。
重点核对：不要把 Chat Completions 的消息结构发送到 Responses 接口，也不要把完整接口路径填进只需要 Base URL 的输入框。先去掉自定义参数和工具，只保留一个纯文本短请求。
验证：新建短对话发送 hi，确认正常回复，并在使用记录看到这次新请求。
升级：最短请求仍返回同一错误时，打开技术支持页面，提供客户端、模型、完整错误和 Request ID；不要发送完整 API Key。
401 / invalid_api_key / API_KEY_REQUIRED原因：客户端没有提交可用的 API Key，或 Key 缺失、粘贴不完整、已失效、配置未保存生效。
处理：重新复制完整 Key，删除首尾空格，确认 Key 填在对应客户端的 API Key 输入框，保存、启用并完全重启客户端。
重点核对：先到 API 密钥页确认该 Key 仍存在。若已经轮换或重新创建 Key，应删除客户端里的旧值并完整替换，不能只补前后几位；客户端输入框里也不要添加 Bearer 。
验证：发送一次短请求，确认不再返回 401，并在使用记录看到对应的新请求。
升级：确认 Key 有效且已保存后仍返回 401，打开技术支持页面，提供脱敏配置、发生时间和完整错误；不要发送完整 Key。
403 / permission_denied原因：当前 API Key、分组、模型权限或网络出口/VPN 可能不符合模型厂商要求。
处理：确认 Key 所在分组支持当前模型；关闭或更换 VPN，切换稳定网络后重试，再按教程复核配置。
重点核对：用当前 Key 查询最新模型列表。模型列表可用但只有某个模型返回 403 时，保留完整模型名和 Request ID，先换成同分组内明确支持的模型验证，不要连续重建 Key。
验证：使用受支持模型发送短请求，确认正常回复且使用记录出现新请求。
升级：分组、模型和网络均已核对仍返回 403，打开技术支持页面，提供模型、分组名称、发生时间和 Request ID。
404 Not Found原因：请求地址、接口路径或客户端协议配置错误。
处理：按客户端教程原样填写地址。Codex 使用 https://api.zhiwei.dpdns.org，不要添加 /v1、/responses 或 /login；保存后完全重启客户端。
重点核对：区分 Base URL 和完整 Endpoint。OpenAI Compatible 客户端通常填带 /v1 的基础地址，Codex 填根地址；客户端会自动拼接路径时，不要再追加 /chat/completions 或 /responses。
定位方法：先用同一 Key 查询模型列表；模型列表也返回 404 时先修正基础地址，模型列表正常但对话请求 404 时再检查客户端协议和具体接口路径。
验证：重新发送短请求，确认不再出现 Not Found，并在使用记录看到新请求。
升级：地址和协议与教程完全一致仍返回 404，打开技术支持页面，提供客户端、脱敏 Base URL 和完整错误。
model_not_found原因：模型名填写错误、当前 Key 分组不支持该模型，或该模型当前可能暂时不可用。
处理：CC Switch 保留自动映射的模型并通过“导入 CCS”重新导入；手动配置的其他客户端从当前模型列表复制完整模型名。两种情况都要确认 Key 所在分组支持目标模型。
重点核对：从当前 Key 的 /v1/models 结果复制完整模型名，保留大小写和后缀。不要使用旧截图、其他账号或其他分组的模型名，也不要自行缩写版本号。
验证：用当前分组模型列表中的完整模型名发送短请求，确认正常回复。
升级：模型名来自当前列表且分组明确支持仍失败，打开技术支持页面，提供模型、分组和完整错误。
413 / request_too_large / context_length_exceeded原因：请求内容过大，或当前对话上下文超过模型限制。
处理：减少附件、图片、日志和工具定义，或新建对话、清理历史后再试。原样重试、换 Key 或换网络通常无效。
重点核对：先在全新对话发送纯文本 hi；成功后再逐项恢复系统提示、历史消息、工具定义和附件。在哪一步再次出现 413，就缩小或拆分该部分，不要一次恢复全部内容。
验证：新建对话发送不带附件的短消息，确认能够正常回复。
升级：最短纯文本请求仍返回 413，打开技术支持页面，提供客户端、模型和完整错误，不要发送原始敏感附件。
429 / insufficient_quota / USAGE_LIMIT_EXCEEDED原因：当前余额、套餐额度或日、周、月使用窗口已经用完。
处理：查看用量、套餐状态和重置时间，确认客户端使用正确的 Key；需要充值或续费时，按复购后继续使用切换现有 Key 的分组。
重点核对：这是额度不足，不是请求过快。先分别检查账户余额、订阅套餐、有效期和额度重置时间，再决定充值、续费或等待重置；不要仅通过降低并发来处理。
验证：确认余额或套餐已有可用额度，再发送短请求并检查使用记录。
升级：页面显示仍有可用额度却持续返回此错误，打开技术支持页面，提供套餐名称、发生时间和完整错误，不要发送支付凭据。
429 / rate_limit_exceeded / concurrency原因：请求过快、并发过高或客户端重复重试，也可能是模型厂商暂时限流。
处理：停止重复任务，等待 30–60 秒并降低并发后重试；持续出现时，检查是否有多个客户端或进程同时运行。
重点核对：关闭重复的终端、后台任务和其他客户端，并暂停自动重试。先让单客户端、单请求恢复，再逐步增加并发；连续快速重试会延长限流时间，也会掩盖真正的并发来源。
验证：只保留一个客户端和一个短请求，确认等待后能够正常回复。
升级：单客户端、单请求且等待后仍持续限流，打开技术支持页面，提供发生时间、模型和 Request ID。
503 / No available accounts原因：模型厂商当前可能无法受理请求，或所选模型暂时不可用。
处理：先重新核对 API Key、分组和模型配置；配置无误后等待 30–60 秒再试，并关闭或更换 VPN、切换稳定网络。
重点核对：先查询当前模型列表。若列表可用且只有一个模型失败，记录完整模型名并间隔重试，或临时使用同分组内其他可用模型；不要同时更改地址、Key、网络和模型。
验证：等待后发送一个短请求，确认所选模型恢复正常回复。
升级：配置无误且多次间隔重试仍失败，打开技术支持页面，提供模型、发生时间、完整错误和 Request ID。
500 / 502 / 504 / 520 / 522 / 524原因：模型厂商服务可能暂时异常；524 表示响应没有在规定时间内完成。
处理：稍后重试一次；长对话可新建对话或缩短内容。仅当前设备出现时，再关闭或更换 VPN、切换网络。
重点核对：记录第一次失败的时间、状态码和 Request ID，并关闭无限自动重试。用全新短对话做间隔测试，可以区分长上下文超时和临时上游故障，也避免重试堆积成并发问题。
验证：新建短对话重试，确认回复完整且使用记录出现新请求。
升级：多个短请求间隔重试仍返回同一 5xx，打开技术支持页面，提供状态码、模型、发生时间和 Request ID。
499 / client_gone / canceled / stream closed原因：请求在回复完成前结束，可能是用户取消、客户端超时、网络/VPN 中断，或模型厂商响应较慢。
处理：保持客户端运行，不要中途取消；关闭或更换 VPN、切换稳定网络，必要时新建较短对话后重试。
重点核对：检查客户端超时设置、设备休眠和测试期间的网络切换。复测时保持窗口、设备和网络持续在线，不点击停止，也不要在同一次测试中切换供应商或模型。
验证：短对话能够连续输出到结束，并在使用记录看到完整请求。
升级：稳定网络下短请求仍反复中断，打开技术支持页面，提供客户端、发生时间、完整错误和 Request ID。
timeout / network / DNS / TLS / EOF / ECONNRESET原因：域名解析、TLS 握手或连接保持失败，常见原因包括地址填写错误、系统时间、DNS、VPN/代理或网络波动。
处理：核对 Base URL，启用系统自动时间，关闭或更换 VPN/代理，切换稳定网络并重启客户端；仍失败时稍后重试。
重点核对：确认系统日期、时间和时区正确，并用同一网络打开文档站。文档站也无法访问时先修复本地网络或 DNS；只有客户端失败时，再检查客户端代理和 Base URL。
验证：客户端能够建立连接并完整返回短请求，且不再出现 DNS、TLS 或连接重置错误。
升级：换过稳定网络且地址、系统时间均正确仍失败，打开技术支持页面，提供网络类型、客户端和完整错误。
response.failed 表示请求以失败结束。继续查看事件里的 error.code 和 message，再按对应错误处理。
智维 模型列表请求报错时，先按实际错误文字检查地址、协议、API Key 和网络；只是 Codex 菜单里没有最新模型时，按看不到最新模型直接卸载重装 Codex 和 CC Switch。
地址、API Key、分组和模型的逐项检查见 问题排查清单。持续出现同一报错时，请联系技术支持，并提供发生时间、客户端、模型、完整错误文字和 Request ID（如有）。不要发送完整 API Key。
client_gone、流式中断、连接超时 | 现象 | 处理 |
|---|---|
499 / client_gone / canceled / stream closed | 保持客户端运行；关闭或更换 VPN，切换稳定网络，必要时新建较短对话后重试。 |
| 回复到一半停止 | 保持电脑和客户端运行，切换网络后重新发送。 |
timeout / network / DNS / TLS / EOF / ECONNRESET | 核对 Base URL 和系统时间，关闭或更换 VPN/代理，切换稳定网络并重启客户端。 |
本站有两种充值方式，完整规则如下：1、余额充值 1:1，不过期、按量计费，使用余额分组时单次使用消耗更低；2、套餐订阅 1:5，有有效期，使用 VIP 通道；计费规则为“实际消耗 = 官方模型价格 × 所选分组倍率”；本站整体价格低于官方价格的 1 折。
不需要。复购、续费或再次购买后，在 API 密钥页直接切换现有 Key 的分组，客户端里的 Key 不用修改。具体选择和验收步骤见 复购后继续使用。
| 区别 | 说明 |
|---|---|
| 可用模型 | 分组决定 Key 能调用哪些模型。 |
| 扣费来源 | 1 元 1 刀使用余额组；套餐商品使用对应套餐组。 |
| 倍率 | 同一扣费来源有多个可用分组时，倍率越低，消耗越少。 |
先选购买内容对应的分组，再确认它支持目标模型。
使用第三方 API 时不需要登录官方账号。需要共用时，在 CC Switch 分别保存 OpenAI Official 和 智维 AI 聚合平台，按需切换。
直接卸载 Codex 和 CC Switch，重新下载并安装最新版。安装完成后检查两个软件的版本，再通过“导入 CCS”重新导入并启用 智维，完全退出 Codex 后重新打开。下载入口见看不到最新模型。
Codex 必须使用 Responses 协议。按对应客户端教程重新核对配置，保存并启用后完全退出 Codex，再重新打开。
如果 Codex 明显少了插件或工具，或者工作空间运行不正常，打开 设置 → 配置 → 工作空间依赖项，找到 重置并安装工作空间，点击右侧的 重新安装。Codex 会下载新的捆绑包并重新加载工具；完成后完全退出 Codex，再重新打开。
在 Codex 设置中检查语言选项。当前版本没有中文时，更新 Codex，并检查系统语言。
以下是 2026-02-27 的用户实测快照，购买前以官方页面为准。
| 订阅方案 | 5 小时额度 | 周额度 |
|---|---|---|
| Plus | $22.67 | $85.23 |
| Team | $18.36 | $138.43 |
| Pro 5x | $152.23 | $507.43 |
这些数值是实测换算口径，不是可提现余额。