API 兼容协议

AIGoCode 提供 OpenAI、Anthropic 和 Gemini 兼容接口，方便接入编程工具、SDK 和业务应用。选择对应的接入分组，配置 API Key 与服务地址，即可使用现有代码调用模型。

支持的 API 入口

协议	请求路径	主要输入字段
OpenAI Responses	`POST /v1/responses`	`input`
OpenAI Chat Completions	`POST /v1/chat/completions`	`messages`
Anthropic Messages	`POST /v1/messages`	`messages`
Gemini 原生接口	`POST /v1beta/models/{model}:generateContent`	`contents`

AIGoCode 所有支持 OpenAI 协议的模型，都同时支持 Responses API 和 Chat Completions API。 根据现有客户端或代码使用的格式选择即可。

Responses 使用 input 发送内容，从 output 中读取回复；Chat Completions 使用 messages，从 choices 中读取回复。

在 AIGoCode 中，三个配置项分别决定不同的内容：

配置项	作用
接口协议	决定请求参数、认证字段和响应格式
API Key 分组	决定可调用的模型、适用工具、接入线路和计费价格
模型 ID	指定实际调用的模型，例如 `gpt-6-astra`、`claude-opus-5-5`、`gemini-4-argon`

每把 API Key 绑定一个分组。 你可以在模型广场查看各分组的模型、价格和适用工具，再选择对应的接入方式。

专用分组用于指定的编程工具，可外接分组用于 SDK、REST API 和第三方应用集成。

以下是三种接口格式的模型与分组示例：

模型	调用格式	分组示例
`gpt-6-astra`	OpenAI Responses 或 Chat Completions	Codex（可外接）
`claude-opus-5-5`	Anthropic Messages	Claude Code（可外接）
`gemini-4-argon`	Gemini 原生接口	Gemini

不同工具和项目可以使用独立的 Key。所有 Key 共用账户的套餐额度和灵活额度，调用按各自绑定分组的价格计费。

API 服务根地址为：

https://api.aigocode.dev

根据使用方式填写地址：

使用方式	地址填写
OpenAI 官方 SDK	`base_url` / `baseURL` 填 `https://api.aigocode.dev/v1`
Anthropic 官方 SDK	填写 `https://api.aigocode.dev`
Gemini 客户端	按客户端配置要求填写根地址或 `/v1beta` 前缀
直接发送 HTTP 请求	服务根地址加上完整请求路径

例如，Responses API 的完整请求地址为：

https://api.aigocode.dev/v1/responses

配置 Claude Code、Codex 等工具时，按照对应接入教程填写地址，客户端会按自身规则拼接接口路径。

协议	认证字段
OpenAI 兼容	`Authorization: Bearer YOUR_API_KEY`
Anthropic Messages	`x-api-key: YOUR_API_KEY`
Gemini 原生接口	`x-goog-api-key: YOUR_API_KEY`

将对应分组的 API Key 填入认证字段，即可发送请求。环境变量设置与完整示例见鉴权和快速开始。