跳到正文

地址与鉴权

选择客户端

按客户端选择地址

按软件复制对应 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 SwitchAPI Request URL / Base URLhttps://api.zhiwei.dpdns.org不带 /v1
ChatBox / Cherry Studio / Cursor / Cline / ContinueOpenAI Base URL / API Base URLhttps://api.zhiwei.dpdns.org/v1OpenAI Compatible 客户端通常要带 /v1
OpenAI Chat CompletionsEndpoint 前缀https://api.zhiwei.dpdns.org/v1实际路径是 /chat/completions
OpenAI Responses / SDKEndpoint 前缀https://api.zhiwei.dpdns.org/v1实际路径是 /responses
Claude Desktop / Claude Code / Anthropic MessagesBase URL / 请求地址https://api.zhiwei.dpdns.org客户端会请求 /v1/messages;地址末尾别加 /
Gemini CLIBase URLhttps://api.zhiwei.dpdns.orgCLI 场景用根地址,CLI 会拼 /v1beta
OpenCode 的 Gemini ProviderBase URLhttps://api.zhiwei.dpdns.org/v1beta走 Gemini v1beta 兼容地址。
Antigravity ClaudeBase URLhttps://api.zhiwei.dpdns.org/antigravityAntigravity 专用 Claude 入口。
Antigravity OpenAI CompatibleBase URLhttps://api.zhiwei.dpdns.org/antigravity/v1Antigravity 专用 OpenAI 兼容前缀。
Antigravity Gemini HTTP / OpenCode GeminiBase URLhttps://api.zhiwei.dpdns.org/antigravity/v1betaAntigravity 专用 Gemini 前缀。
EmbeddingsEndpoint 前缀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 和接口路径

客户端配置页填写 Base URL

比如 ChatBox 的 Base URL 填 https://api.zhiwei.dpdns.org/v1,软件会自己拼 /chat/completions

自己写 curl / SDK填写完整路径

比如 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

请求失败时,先看 常见报错解释,再按 问题排查清单 逐项检查。

智维 API 接入、配置与排查指南。