接口与兼容性

Axis AI 不发明自己的请求格式 —— 它照搬 OpenAI 和 Anthropic 各自的标准接口，客户端怎么对接官方 API，就怎么对接这里，只需要换 base URL 和 Key。

模型广场里每个模型卡片上的 openai / anthropic 标签，标的就是这个模型支持哪一种（或哪几种）请求格式。

OpenAI 兼容

Base URL：

https://api-ai.onyxaxis.org/v1

Chat Completions

标准 POST /v1/chat/completions，请求体、messages 结构、流式 SSE、tools/tool_calls 均遵循 OpenAI 的 Chat Completions 格式。

Responses

标准 POST /v1/responses，即 OpenAI 较新的 Responses API 格式（input 而非 messages，output 而非 choices）。已通过 Codex CLI 的 wire_api = "responses" 模式验证可正常工作，包括流式响应与工具调用（function calling）。Codex CLI 走的就是这一种或 Chat Completions，二选一，都是 OpenAI 协议。

Anthropic 兼容

标准 POST /v1/messages，遵循 Anthropic Messages API 格式（system 字段、content 块结构、tool_use/tool_result）。Claude Code 走的就是这一种协议。

认证

两种格式统一使用同一个 Header：

Authorization: Bearer sk-你的Key

不需要按 OpenAI 或 Anthropic 官方各自的 Header 习惯（比如 Anthropic 官方用的 x-api-key）区分 —— 都用 Authorization: Bearer。

选哪种格式

跟你的客户端走。如果客户端本身是对接 OpenAI 官方 API 写的（openai SDK、大多数 IDE 插件、大多数 CLI 工具默认档位），就用 OpenAI 兼容接口；如果客户端是对接 Claude 官方 API 写的，就用 /v1/messages。同一个模型往往两种格式都能打（看模型卡片上的标签），选哪个纯粹取决于你手上的客户端认哪种协议，不影响实际调用的模型本身。

推荐搭配：GPT 配 Codex，Claude 配 Claude Code

协议能打通，不代表客户端内部的假设也一致 —— Codex、Claude Code 都对"自家"模型有一套内置行为逻辑，跨厂商配对更容易出现看似诡异、实则是客户端在按错误的家族处理模型的问题。GPT 系列模型建议接 Codex CLI，Claude 系列模型建议接 Claude Code，反过来接容易踩坑，具体原因和例子见常见问题。