API 接入文档
使用以下地址接入 CPA,模型与密钥在客户端中配置。
https://gpt.vincentz.dev/v1
快速接入
填写地址
选择兼容 OpenAI 的接口类型,Base URL 填上方地址。不要重复拼接
/v1。
填写调用密钥
API Key 填 CPA 分配的调用密钥,不是管理密码或 OpenAI 登录信息。
选择模型
获取模型列表,选择原生模型或带
-basispoints 后缀的插件线路。
模型与线路
当前 CPA 的 28 个模型,长度单位为 tokens。上下文取本机返回的客户端目录,最大输出取 CPA 的模型注册信息。
| 模型名称 | 默认上下文 | 最大上下文 | 最大输出 |
|---|---|---|---|
| Codex 原生 | |||
gpt-6.1-sol |
272,000 | 872,000 | 128,000 |
gpt-6-astra |
272,000 | 872,000 | 128,000 |
gpt-6-sol |
272,000 | 872,000 | 128,000 |
gpt-6-luna |
272,000 | 872,000 | 128,000 |
gpt-5.6-sol |
272,000 | 872,000 | 128,000 |
gpt-5.6-terra |
272,000 | 872,000 | 128,000 |
gpt-5.6-luna |
272,000 | 872,000 | 128,000 |
gpt-5.5 |
272,000 | 272,000 | 128,000 |
codex-auto-review |
272,000 | 872,000 | 128,000 |
| Basispoints 插件 | |||
gpt-6-astra-basispoints |
272,000 | 872,000 | 未声明 |
gpt-5.6-sol-basispoints |
272,000 | 872,000 | 未声明 |
| Antigravity | |||
claude-opus-4-6-thinking |
200,000 | 200,000 | 64,000 |
claude-sonnet-4-6 |
200,000 | 200,000 | 64,000 |
gemini-pro-agent |
1,048,576 | 1,048,576 | 65,535 |
gemini-3.1-pro-low |
1,048,576 | 1,048,576 | 65,535 |
gemini-3-flash |
1,048,576 | 1,048,576 | 65,536 |
gemini-3.6-flash-high |
1,048,576 | 1,048,576 | 65,536 |
gemini-3.7-flash-high |
1,048,576 | 1,048,576 | 65,536 |
gemini-3.8-flash-high |
1,048,576 | 1,048,576 | 65,536 |
gemini-3.1-flash-lite |
1,048,576 | 1,048,576 | 65,535 |
gemini-3.5-flash-lite |
1,048,576 | 1,048,576 | 65,535 |
gpt-oss-120b-medium |
114,000 | 114,000 | 32,768 |
gemini-3.1-flash-image |
未声明 | 未声明 | 未声明 |
| 图像模型 · Codex | |||
gpt-image-1.5 |
未声明 | 未声明 | 未声明 |
gpt-image-2 |
未声明 | 未声明 | 未声明 |
gpt-image-2.5 |
未声明 | 未声明 | 未声明 |
gpt-image-2.5-flare |
未声明 | 未声明 | 未声明 |
gpt-image-2.5-sunburst |
未声明 | 未声明 | 未声明 |
这些是代理目录的声明值,未做极限压测。GPT-5.6 的 CPA 注册窗口为 921,000,但客户端目录的最大窗口为 872,000,本表展示后者。客户端是否使用较大窗口,也取决于客户端配置。
BPS
别名继承对应原生模型的客户端窗口,插件未独立声明最大输出。图像模型没有专属长度参数,不采用客户端目录里的通用模板值。当前可用模型以
GET /v1/models 为准。
参数来源:本机 CPA 8.0.0 的模型目录、模型注册接口与 BPS 插件目录处理。
调用示例
将占位符替换为你的 CPA API Key,在自己的终端运行。
export CPA_API_KEY="替换为你的 CPA API Key"
curl --fail-with-body https://gpt.vincentz.dev/v1/models \
-H "Authorization: Bearer $CPA_API_KEY"
/v1/models获取当前可见的模型名称。
/v1/responses提交模型请求;stream: true 使用 SSE
流式返回。
/v1/chat/completions兼容 Chat Completions
的客户端可使用;具体模型兼容性以调用结果为准。
使用须知
文档在线,不代表 API 在线
文档由 Cloudflare 提供,不依赖本机。API 则需要 CPA 和 Tunnel 都运行;本机关机、休眠或断网会影响调用。
管理后台不会从这里开放
此域名仅提供接入文档与模型 API。管理页面、账号池及管理接口不向公网开放。
工具能力由客户端与线路共同决定
兼容接口不代表自动拥有 ChatGPT 网页端的全部工具。网页搜索等能力,需要客户端与所选线路实际支持。
调用密钥就是使用权限
持有 Key 的人可以调用接口并消耗上游账号额度。仅分享给可信设备,不用于公共下载、视频传输或大流量服务。
401:检查 Key 和认证头。
404:检查路径;管理地址返回 404 是预期行为。429:检查调用频率及上游额度。 502 / 530:检查
CPA、Tunnel 与本机网络。