跳到正文

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 / SDKhttps://portdan.com/v1/chat/completions/models/responses/embeddings
GPT Imagehttps://portdan.com/v1/responses
Codex / CC Switchhttps://portdan.comCodex 自动请求 /responses
Anthropic Messageshttps://portdan.com/v1/messages
Gemini v1betahttps://portdan.com/v1beta/models/models/{model}:generateContent
Gemini CLIhttps://portdan.comCLI 自动拼 /v1beta
Antigravity Claudehttps://portdan.com/antigravity/v1/messages
Antigravity OpenAI Compatiblehttps://portdan.com/antigravity/v1/chat/completions
Antigravity Geminihttps://portdan.com/antigravity/v1beta/models/{model}:generateContent

测试模型列表

在终端或 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 别发。

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