API 协议与请求地址对照

更新于 2026-10-08

适用范围：区分客户端协议、SDK Base URL、完整接口 URL 和 CC Switch 本地转换；先按工具教程选定一种接法。

版本与验证：2026-09-11 核对协议字段及现有教程地址。API 能力取决于模型、分组与平台适配，不将上游全部功能视为已支持。

配置速查

配置项	填写内容	注意事项
Chat Completions 完整请求	`https://api.apizt.com/v1/chat/completions`	常见 messages 输入；WorkBuddy 此字段需要完整地址。
Responses 完整请求	`https://api.apizt.com/v1/responses`	Codex 直连用 Responses；请求结构与 Chat 不同。
Messages 完整请求	`https://api.apizt.com/v1/messages`	Claude Code 直连使用 Messages 兼容。
OpenAI SDK base_url	`https://api.apizt.com/v1`	SDK 追加接口路径，不在这里填完整请求 URL。
Claude Code ANTHROPIC_BASE_URL	`https://api.apizt.com`	SDK 处理 Messages 路径，不机械追加 /v1。

为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。

选择接口前，先看客户端接受哪种请求和响应格式。模型品牌不决定协议：同一个模型可能经由不同兼容接口提供，但不代表各接口功能完全相同。

Chat 常见输入为 messages；Responses 使用 input，输出及流式事件结构也不同。不能只更换 URL 就原样复用请求和解析代码。

Codex CLI 直连自定义提供商使用 wire_api = "responses"。只有 Chat 的上游需要合适的协议转换服务，不能把 wire_api 写成 Chat 来代替转换。

Claude Code 直连要求 Messages 兼容接口。本文的 ANTHROPIC_BASE_URL 填服务根地址，由客户端处理接口路径；不要与 OpenAI SDK 的 base_url 混用。

客户端先请求本地路由，本地路由再按设置访问上游。CC Switch 的“上游格式”不等于客户端原生协议；启用路由后必须保持本地服务运行。图文步骤见 CC Switch 三端配置。

基础聊天成功不代表工具调用、图片输入、内置搜索或上下文续接都已支持。使用当前账号支持的模型，逐项对照请求、响应和错误体验证。上游官方能力不等同 apizt 每个分组的适配范围。

型号	Chat	建议入口
gpt-6.1-sol	基础文本与图片理解；不带 tools；reasoning_effort 为 low/medium/high/xhigh/max	Chat/Responses 选择
gpt-6-sol / gpt-6-luna	Chat 函数调用需 reasoning_effort: none；推理加工具使用 Responses	Responses 工具调用
claude-sonnet-5-5	目录列有 Chat 兼容；thinking/output_config 的明确控制使用原生 Messages	Sonnet 5.5 原生迁移
gemini-3.8-flash	目录列有 Chat 兼容；原生使用 contents + generationConfig；输出文本	Gemini 文本与理解

当前型号入口：Chat 与原生型号、Responses 型号。目录提供协议标记；具体能力需要按账号、分组和请求参数确认。

现象	检查与处理
Chat 成功但 Codex 失败	Chat 与 Responses 是不同接口；还需确认 Responses 及代理工具能力。
404	区分错误路径和不存在的模型；对照实际 URL 和服务端错误体，不仅凭状态码判断。
200 但客户端解析失败	响应格式可能不匹配，例如把 Chat JSON 返回给 Messages 客户端；检查路由转换。
功能字段在上游可用、平台不可用	查看平台当前适配范围，不通过改协议名称假定支持；逐项测试可选能力。

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。