# 接入与集成

来源: https://docs.aicentos.com/enterprise/integration

Language: zh-CN

> 协议兼容、Base URL 与网络层要求

## 协议兼容

| 协议           | Base URL                  | 典型客户端                    |
| ------------ | ------------------------- | ------------------------ |
| OpenAI 兼容    | `https://aicentos.com/v1` | Codex、Cursor 等 OpenAI 生态 |
| Anthropic 兼容 | `https://aicentos.com`    | Claude Code 等            |
| Gemini 原生    | `https://aicentos.com`    | Gemini CLI 等             |

认证统一使用 API 密钥（`Authorization: Bearer <API Key>`；Gemini 原生按其密钥参数传递）。

**这是接入流程里最容易出错的一步**：OpenAI 兼容生态要带 `/v1` 前缀；Anthropic / Gemini 只填根地址，请求路径由客户端自行拼接，不需要手动追加 `/v1/messages`。各客户端的具体填法见[客户端接入](https://docs.aicentos.com/clients/claude-code)。

## 网络要求

* **出站**：你的服务只要能访问 `https://aicentos.com` 即可，无需开放额外端口，也无需配置任何上游厂商地址
* **入站白名单**：API 密钥支持绑定 IP 白名单，只允许指定来源调用
* **内网环境**：可将 aicentos 配置为统一出口，上游连接由平台侧完成，内网只需放通对 `aicentos.com` 的访问

## 私有化部署的接入

采用[私有化部署](https://docs.aicentos.com/enterprise/deployment)时，Base URL 换为你部署的网关地址，协议与认证方式与上表完全一致，客户端配置只需改地址。上游连接方式与网络策略在交付方案中确认。

接入侧有两条相互独立的认证链路，企业客户容易混在一起，这里说清楚：

* **程序调用**走 **API 密钥**，与部署形态无关
* **人员登录控制台**走**账号认证**；私有化部署可对接你自有的身份提供方实现单点登录，见[团队协作与权限](https://docs.aicentos.com/enterprise/organization)

单点登录只作用于人员登录，不改变 API 的调用与鉴权方式——程序侧仍使用密钥，密钥的额度与白名单策略照常生效。

## 多环境建议

* 测试与生产分别签发密钥，独立设置额度与白名单
* 不要把上游地址写进代码——你只需要 aicentos 的地址，上游切换对调用方是透明的