首页 / 接入指南

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

  1. 打开 Cursor 设置中的 API Keys 面板;
  2. 启用 Override OpenAI Base URL,填入企业网关地址;
  3. 粘贴你的虚拟密钥,选择后台模型目录中的模型即可。

说明:自定义端点覆盖对话类模型;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 / ContinueOpenAI 兼容 API,同「通用」两个变量
Dify / FastGPT模型供应商填网关地址与虚拟密钥,可同时作为知识库引擎对接

飞书与钉钉数据同步(管理员操作)

  1. 在启元天枢后台「数据源接入」中选择飞书或钉钉,跳转开放平台完成一次 OAuth2 授权;
  2. 勾选同步范围:云文档、知识库、妙记与 AI 会议纪要、审批流,敏感库可排除;
  3. 平台通过事件订阅实时捕获变更、配合定时增量同步,权限继承原平台设置,文档历史版本保留。

同步后,全员即可在统一检索里跨平台查询,「上周产品评审会定了什么」一问即答。

安全提醒

相关阅读:常见问题从 OneAPI 迁移术语表

接入只要 5 分钟,沉淀从此刻开始

还没有企业账号?预约演示,当场开通试用环境。