比如 ChatBox 的 Base URL 填 https://api.zhiwei.dpdns.org/v1,软件会自己拼 /chat/completions。
地址与鉴权
选择客户端
按客户端选择地址
按软件复制对应 Base URL,不要自己拼路径。
Codex / CC Switch:https://api.zhiwei.dpdns.org
OpenAI Compatible:https://api.zhiwei.dpdns.org/v1
Claude / Anthropic:https://api.zhiwei.dpdns.org
Gemini CLI:https://api.zhiwei.dpdns.org
Gemini HTTP / OpenCode Gemini:https://api.zhiwei.dpdns.org/v1beta
Antigravity Claude / Gemini CLI:https://api.zhiwei.dpdns.org/antigravity
Antigravity OpenAI:https://api.zhiwei.dpdns.org/antigravity/v1
Antigravity Gemini HTTP / OpenCode Gemini:https://api.zhiwei.dpdns.org/antigravity/v1beta
先按客户端实际支持的协议选地址,再复制对应的 Base URL。Codex / CC Switch 使用根地址; 普通 OpenAI Compatible 客户端通常使用带 /v1 的地址;Gemini CLI 使用根地址,而手写 Gemini HTTP 或 OpenCode Gemini provider 使用 /v1beta。地址填写后先保存并完全重启 客户端,再用一个短请求验证。出现 404 时优先检查是否重复追加了接口路径;出现 401 时再检查 Key 是否完整有效。排查时一次只改一项,避免同时改地址、Key 和模型后无法定位。
复制地址
| 场景 | 软件里常见字段名 | 填写地址 | 备注 |
|---|---|---|---|
| Codex / CC Switch | API Request URL / Base URL | https://api.zhiwei.dpdns.org | 不带 /v1。 |
| ChatBox / Cherry Studio / Cursor / Cline / Continue | OpenAI Base URL / API Base URL | https://api.zhiwei.dpdns.org/v1 | OpenAI Compatible 客户端通常要带 /v1。 |
| OpenAI Chat Completions | Endpoint 前缀 | https://api.zhiwei.dpdns.org/v1 | 实际路径是 /chat/completions。 |
| OpenAI Responses / SDK | Endpoint 前缀 | https://api.zhiwei.dpdns.org/v1 | 实际路径是 /responses。 |
| Claude Desktop / Claude Code / Anthropic Messages | Base URL / 请求地址 | https://api.zhiwei.dpdns.org | 客户端会请求 /v1/messages;地址末尾别加 /。 |
| Gemini CLI | Base URL | https://api.zhiwei.dpdns.org | CLI 场景用根地址,CLI 会拼 /v1beta。 |
| OpenCode 的 Gemini Provider | Base URL | https://api.zhiwei.dpdns.org/v1beta | 走 Gemini v1beta 兼容地址。 |
| Antigravity Claude | Base URL | https://api.zhiwei.dpdns.org/antigravity | Antigravity 专用 Claude 入口。 |
| Antigravity OpenAI Compatible | Base URL | https://api.zhiwei.dpdns.org/antigravity/v1 | Antigravity 专用 OpenAI 兼容前缀。 |
| Antigravity Gemini HTTP / OpenCode Gemini | Base URL | https://api.zhiwei.dpdns.org/antigravity/v1beta | Antigravity 专用 Gemini 前缀。 |
| Embeddings | Endpoint 前缀 | https://api.zhiwei.dpdns.org/v1 | 实际路径是 /embeddings。 |
OpenAI 路线按场景选地址
普通 OpenAI 兼容客户端(ChatBox、Cherry Studio、Cursor 等)填 https://api.zhiwei.dpdns.org/v1。Codex / CC Switch 填根地址 https://api.zhiwei.dpdns.org;Antigravity OpenAI Compatible 单独填 https://api.zhiwei.dpdns.org/antigravity/v1。
区分 Base URL 和接口路径
比如 curl 请求模型列表写 https://api.zhiwei.dpdns.org/v1/models,别把 /models 写进客户端 Base URL。
填写 Key
多数客户端有 API Key 输入框,直接粘贴完整 Key,不加引号,也不加 Bearer 前缀。只有自己写 HTTP 请求头时才写 Bearer。
| 场景 | Key 写法 | 别这样写 |
|---|---|---|
| 软件 API Key 输入框 | 完整 Key 原文 | 添加 Bearer 、引号或其他字符 |
| OpenAI / Anthropic curl 请求 | Authorization: Bearer sk-... | 少写 Bearer 或把 Key 放进 URL |
| Gemini curl 请求 | x-goog-api-key: sk-... | 把 Key 写到公开截图里 |
自己写 HTTP 请求:
bash
curl https://api.zhiwei.dpdns.org/v1/models \
-H "Authorization: Bearer $智维_API_KEY"手写 Gemini v1beta 请求用 x-goog-api-key:
bash
curl "https://api.zhiwei.dpdns.org/v1beta/models" \
-H "x-goog-api-key: $智维_API_KEY"检查斜杠
| 你看到的字段 | 填 | 别填 |
|---|---|---|
| Base URL / API Base | 基础地址;一般末尾别加 / | 完整接口路径,例如 /chat/completions |
| Endpoint / URL | 文档给出的完整接口 | 少一段路径或多一段路径 |
| API Key | 完整 Key | 缺少字符或带有额外文字 |
发送测试请求
模型先从当前分组复制;下面的固定模型名仅作兜底示例。
OpenAI Compatible:
bash
curl https://api.zhiwei.dpdns.org/v1/chat/completions \
-H "Authorization: Bearer $智维_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.5","messages":[{"role":"user","content":"请只回复 OK"}]}'Codex 配置好后不用写 curl,直接在对话里发送:
text
请只回复 OK