首页 / 接入指南
5 分钟接入指南
本指南面向开发者与 IT 管理员:如何把常用工具的模型请求指向启元天枢企业级 AI 综合治理平台的统一接入网关,以及如何授权飞书、钉钉的数据同步。核心动作只有一个:改 Base URL、换虚拟密钥,业务代码零改造。
准备:获取你的虚拟密钥
由企业管理员在启元天枢后台为你签发,形如 ck-****。每人一把、每个项目一把,可单独限额、限模型、随时吊销。不要把密钥提交进代码仓库。
通用:任何 OpenAI 兼容工具与 SDK
启元天枢平台的统一接入层(AI 聚合网关能力)兼容 OpenAI API 协议,两个环境变量即完成接入:
# 网关地址以你企业后台「开发者配置」页为准,下方为示例
export OPENAI_BASE_URL=https://gateway.apiget.store/v1
export OPENAI_API_KEY=ck-你的虚拟密钥
Python SDK 示例:
from openai import OpenAI
client = OpenAI() # 自动读取上面的环境变量
resp = client.chat.completions.create(
model="deepseek-v3", # 模型名按后台模型目录填写
messages=[{"role": "user", "content": "你好"}],
)
Cursor
- 打开 Cursor 设置中的 API Keys 面板;
- 启用 Override OpenAI Base URL,填入企业网关地址;
- 粘贴你的虚拟密钥,选择后台模型目录中的模型即可。
说明:自定义端点覆盖对话类模型;Tab 补全等部分功能不走自定义端点。企业版可由管理员统一下发配置并禁用员工自带密钥。
Claude Code
Claude Code 使用 Anthropic Messages 协议端点(启元天枢网关提供协议兼容端点,地址以后台为准):
export ANTHROPIC_BASE_URL=https://gateway.apiget.store/anthropic
export ANTHROPIC_API_KEY=ck-你的虚拟密钥
其他工具速查
| 工具 | 接入方式 |
|---|---|
| WorkBuddy(腾讯) | 模型配置中选择自定义模式,填入网关 URL、虚拟密钥与模型名,默认走标准 /chat/completions 路径 |
| Trae(字节跳动) | 模型设置中添加自定义模型:填请求地址与鉴权信息,OpenAI 与 Anthropic 两种协议均支持 |
| Qoder(阿里,原通义灵码) | 目前仅支持接入指定模型供应商(阿里云百炼、智谱、Kimi 等),暂不支持任意自定义网关地址;建议经企业版渠道咨询 |
| GitHub Copilot | 企业版经网关代理接入,需联系 GitHub 商务开通 |
| JetBrains AI | 配置自定义 LLM Provider,指向网关地址 |
| Cline / Continue | OpenAI 兼容 API,同「通用」两个变量 |
| Dify / FastGPT | 模型供应商填网关地址与虚拟密钥,可同时作为知识库引擎对接 |
飞书与钉钉数据同步(管理员操作)
- 在启元天枢后台「数据源接入」中选择飞书或钉钉,跳转开放平台完成一次 OAuth2 授权;
- 勾选同步范围:云文档、知识库、妙记与 AI 会议纪要、审批流,敏感库可排除;
- 平台通过事件订阅实时捕获变更、配合定时增量同步,权限继承原平台设置,文档历史版本保留。
同步后,全员即可在统一检索里跨平台查询,「上周产品评审会定了什么」一问即答。
安全提醒
- 虚拟密钥等同个人凭证:勿提交进代码仓库,勿转借他人;
- 密钥可在后台随时吊销重发,离职回收自动完成;
- 所有调用计入所属项目配额,触达阈值会预警或熔断,属正常治理行为。
相关阅读:常见问题、从 OneAPI 迁移、术语表