API 总览
按客户端协议选入口:Codex 填根地址,OpenAI Compatible 填 /v1,Claude 填根地址,Gemini v1beta 填专用前缀。Antigravity 按子协议选 /antigravity、/antigravity/v1 或 /antigravity/v1beta。
配置客户端
配置 Codex、Claude Code 或 OpenClaw(小龙虾),打开 用 CC Switch 配置 Codex。SDK 和服务端程序按下表选择地址。
Base URL 是客户端或 SDK 要填的基础地址,典型路径 是程序请求时追加的接口路径。CC Switch 里这个字段叫 API 请求地址。
404 通常先查路径,401 先查 Key, model_not_found 先查模型名和分组,别一次把所有配置都换掉。
选择入口
| 协议 / 场景 | 基础地址(Base URL) | 典型路径 |
|---|---|---|
| OpenAI Compatible / SDK | https://portdan.com/v1 | /chat/completions、/models、/responses、/embeddings |
| GPT Image | https://portdan.com/v1 | /responses |
| Codex / CC Switch | https://portdan.com | Codex 自动请求 /responses |
| Anthropic Messages | https://portdan.com | /v1/messages |
| Gemini v1beta | https://portdan.com/v1beta | /models、/models/{model}:generateContent |
| Gemini CLI | https://portdan.com | CLI 自动拼 /v1beta |
| Antigravity Claude | https://portdan.com/antigravity | /v1/messages |
| Antigravity OpenAI Compatible | https://portdan.com/antigravity/v1 | /chat/completions 等 |
| Antigravity Gemini | https://portdan.com/antigravity/v1beta | /models/{model}:generateContent |
地址与鉴权Key 写法、基础地址和斜杠规则。Chat CompletionsOpenAI Compatible 对话接口。Responses / CodexCodex 和新版 OpenAI Responses 接口。GPT Imagegpt-image-2 生图接口和 Codex Skill。Anthropic MessagesClaude Code 与 Anthropic SDK。Gemini v1betaGemini CLI、SDK 与手写 HTTP。AntigravityClaude / OpenAI / Gemini 专用路径。
测试模型列表
在终端或 PowerShell 中执行以下命令,把 sk-your-api-key 换成完整 Key。
bash
curl https://portdan.com/v1/models \
-H "Authorization: Bearer sk-your-api-key"能拿到模型列表,说明 /models 请求的域名和 Key 都没问题。测试请求走的是 /v1/models,Codex / CC Switch 仍然填根地址 https://portdan.com。
联系技术支持前往技术支持页面扫码联系,带上协议类型、填写的基础地址和状态码。完整 API Key 别发。