API 接入文档

使用以下地址接入 CPA，模型与密钥在客户端中配置。

接口地址https://gpt.vincentz.dev/v1

快速接入

填写地址

选择兼容 OpenAI 的接口类型，Base URL 填上方地址。不要重复拼接 /v1。

填写调用密钥

API Key 填 CPA 分配的调用密钥，不是管理密码或 OpenAI 登录信息。

选择模型

获取模型列表，选择原生模型或带 -basispoints 后缀的插件线路。

模型与线路

后缀区分的是调用线路，并不是另外一个基础模型。下面是已配置的常用名称。

模型名称 调用线路 上游模型
gpt-6-astra CPA 原生 gpt-6-astra
gpt-6-astra-basispoints Basispoints 插件 gpt-6-astra
gpt-5.6-sol-basispoints Basispoints 插件 gpt-5.6-sol

完整模型列表以 GET /v1/models 为准。不同线路的效果和工具支持可能不同。

调用示例

将占位符替换为你的 CPA API Key，在自己的终端运行。

GET /v1/models 
export CPA_API_KEY="替换为你的 CPA API Key"

curl --fail-with-body https://gpt.vincentz.dev/v1/models \
  -H "Authorization: Bearer $CPA_API_KEY"
GET/v1/models获取当前可见的模型名称。
POST/v1/responses提交模型请求；stream: true 使用 SSE 流式返回。
POST/v1/chat/completions兼容 Chat Completions 的客户端可使用；具体模型兼容性以调用结果为准。

使用须知

文档在线，不代表 API 在线

文档由 Cloudflare 提供，不依赖本机。API 则需要 CPA 和 Tunnel 都运行；本机关机、休眠或断网会影响调用。

管理后台不会从这里开放

此域名仅提供接入文档与模型 API。管理页面、账号池及管理接口不向公网开放。

工具能力由客户端与线路共同决定

兼容接口不代表自动拥有 ChatGPT 网页端的全部工具。网页搜索等能力，需要客户端与所选线路实际支持。

调用密钥就是使用权限

持有 Key 的人可以调用接口并消耗上游账号额度。仅分享给可信设备，不用于公共下载、视频传输或大流量服务。

401：检查 Key 和认证头。  404：检查路径；管理地址返回 404 是预期行为。
429：检查调用频率及上游额度。  502 / 530：检查 CPA、Tunnel 与本机网络。