aicentos企业级
接入与集成
协议兼容、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://aicentos.com即可，无需开放额外端口，也无需配置任何上游厂商地址 - 入站白名单：API 密钥支持绑定 IP 白名单，只允许指定来源调用
- 内网环境：可将 aicentos 配置为统一出口，上游连接由平台侧完成，内网只需放通对
aicentos.com的访问
私有化部署的接入
采用私有化部署时，Base URL 换为你部署的网关地址，协议与认证方式与上表完全一致，客户端配置只需改地址。上游连接方式与网络策略在交付方案中确认。
接入侧有两条相互独立的认证链路，企业客户容易混在一起，这里说清楚：
- 程序调用走 API 密钥，与部署形态无关
- 人员登录控制台走账号认证；私有化部署可对接你自有的身份提供方实现单点登录，见团队协作与权限
单点登录只作用于人员登录，不改变 API 的调用与鉴权方式——程序侧仍使用密钥，密钥的额度与白名单策略照常生效。
多环境建议
- 测试与生产分别签发密钥，独立设置额度与白名单
- 不要把上游地址写进代码——你只需要 aicentos 的地址，上游切换对调用方是透明的