OpenToken 文档
OpenToken 是一个统一的大模型网关,提供稳定的接入点和一致的鉴权方式,帮助你在同一套工程中接入 OpenAI、Claude、Gemini 等不同模型服务,并通过企业 API 管理企业账号与网关资源。
你可以使用 OpenToken 降低多供应商接入成本:应用侧只需要维护统一的 API Key、网关地址和请求入口,再按需选择不同服务商或模型。它适合用于聊天助手、代码工具、内容生成、图片生成、多模态理解等需要灵活切换模型的场景。
本区域提供接入流程、基础概念和常见配置说明。如果你需要查看模型接口的请求参数、响应结构和示例,请前往 API 参考;如果需要管理企业账号、密钥和用量,请前往 企业 API。
企业 API
企业 API 提供账号、密钥、审核、部门、反馈、Key、日志、模型、项目、人员、安全策略与用量统计等企业级管理能力。每个企业使用对应的 opentoken.io 子域名作为 API 地址,并通过企业开放 API Key 进行 Bearer Token 鉴权。
在 企业 API 页面中,可以直接查看各接口的请求参数、响应结构和示例,也可以配置企业网关地址后发起请求。
飞书应用接入
如果企业使用飞书作为组织内的协作平台,可以通过创建飞书自建应用,为 OpenToken 启用飞书扫码登录和组织架构自动同步能力。员工使用飞书身份扫码即可登录,无需再维护独立的用户名和密码。
更重要的是,部门与人员的组织架构可以统一在飞书中维护。管理员在飞书中新增、修改或删除部门和人员后,OpenToken 通过已订阅的变更事件实时同步部门层级、人员信息、工号、部门归 属及在职状态,无需在 OpenToken 后台再维护一套组织架构,避免两套系统重复录入和数据不一致。飞书负责身份认证与组织架构数据源,OpenToken 负责账号登录与业务权限,角色分配和权限调整仍在 OpenToken 中完成。
配置工作由租户管理员在飞书开放平台后台完成,涉及创建自建应用、获取事件加密凭证、申请权限、配置回调地址、订阅变更事件和发布应用等步骤。完整流程请参见 飞书应用接入。
MCP
MCP 是企业 API 的 AI 工具接入方式。连接后,AI 助手可以根据当前账号权限查询或管理企业账号、密钥、审核、部门、反馈、Key、日志、模型、项目、人员、安全策略和用量统计,无需离开当前客户端,适合通过自然语言查询企业数据或执行企业管理操作。
这是由 OpenToken 托管的远程 MCP 服务,本地无需安装。你只需在 MCP 客户端中添加“企业专属 URL + /mcp”作为服务地址,再到浏览器中完成一次 OAuth 授权。Claude Code、Codex CLI、Cursor CLI、Claude Desktop、OpenCode 和 CC Switch 的配置方式请参见 MCP。
可调用范围与企业 API 保持一致,并受当前企业账号、角色和授权权限限制。其中新建、编辑、删除、审批、状态变更等写操作会修改企业数据,执行前应确认目标对象和影响范围。
你可以在这里完成什么
- 了解 OpenToken 的网关地址、鉴权方式和基础调用流程。
- 快速接入 OpenAI 兼容接口,并按需切换到 Claude 或 Gemini 接口。
- 将 OpenToken 配置到常用开发工具和自动化工作流中。
- 通过飞书自建应用启用扫码登录,并让部门和人员组织架构自动同步。
- 通过 MCP 把企业管理能力接入 AI 工具,用自然语言查询和管理企业资源。
- 根据网络环境选择全球网关或国内加速网关。
快速开始
- 准备 API Key,存入环境变量
OPEN_TOKEN_KEY。 - 选择目标接口(如 OpenAI 兼容的 Chat Completions)。
- 将请求发往
https://gw.opentoken.io,在Authorization头携带 Key。
更多内容陆续补充中。