API 总览

OnprsCodexApi 提供四类标准生成协议。路由决定客户端发送的协议，Key 分组和模型映射决定请求实际由哪个平台处理。

基础信息

控制台：https://cdn.api.onprs.top/
OpenAI / Anthropic Base URL：https://api.onprs.top/v1
Google GenAI Base URL：https://api.onprs.top

推荐认证方式：

Authorization: Bearer sk-your-api-key

Anthropic SDK 可使用 x-api-key，Google SDK 可使用 x-goog-api-key。不要在 URL query、日志或错误截图中暴露 Key。

协议入口

协议	生成入口	典型客户端
OpenAI Chat Completions	POST /v1/chat/completions	通用 OpenAI-compatible 客户端
OpenAI Responses	POST /v1/responses	Codex CLI、新版 OpenAI SDK
Anthropic Messages	POST /v1/messages	Claude Code、Anthropic SDK
Google GenAI	POST /v1beta/models/{model}:generateContent	Gemini CLI、Google GenAI SDK

完整路由见协议与端点。

请求处理

服务会校验 API Key 和额度，根据模型配置路由请求，并按客户端使用的协议返回响应。用量页面可用于核对请求模型、实际模型和费用。

兼容边界

协议可转换不代表所有模型都支持图片、工具调用、结构化输出、超长上下文或同样的采样参数。跨协议遇到不可无损表达的能力时，服务可能返回明确错误，而不是静默丢弃内容。

开始调用前先查看模型与映射和流式、工具与结构化输出。