公开路由

方法路由用途
GET/v1/models查询当前密钥可用的模型列表
POST/v1/chat/completionsOpenAI 兼容的对话补全
POST/v1/responsesResponses 协议（Codex 等客户端）
POST/v1/messagesAnthropic Messages 协议（Claude Code 等客户端）

路由是否可用取决于已配置的渠道与所选模型，调用前先通过 /v1/models 确认。

身份认证

  • OpenAI 兼容路由：Authorization: Bearer <API Key>
  • Anthropic 路由：x-api-key: <API Key>，同时必须携带 anthropic-version: 2023-06-01 请求头

流式输出

需要流式输出时设置 stream=true，客户端需支持 SSE 解析。不要在中间代理层缓冲整个响应，否则会出现“首字很慢”或流中断。

协议一致性

  • 不要把 Anthropic Messages 客户端指向 /v1/chat/completions。
  • 不是所有模型都支持 Responses 协议，接入 Codex 前先直接测试 /v1/responses。
  • 协议不匹配通常表现为 400 错误、工具调用缺失或用量统计异常。

请求凭据

每个请求的响应中带有 request id。出现问题时，记录请求时间、模型、路由、状态码与 request id，管理员可据此在日志中定位。