帮你快速理解、总结文档立即下载
文档中心>模型路由>操作指南>创建模型路由访问密钥

创建模型路由访问密钥

最近更新时间:2026-09-15 15:34:31
本文档已由 AI 辅助审校
我的收藏
本文介绍如何创建和使用模型路由访问密钥(API Key)。模型路由根据 API Key 获取身份凭证,以完成模型全链路管控与调度。

简介

模型路由产品形态包括两种类型的密钥:模型路由访问密钥 BYOK 密钥
模型路由访问密钥(API Key):调用方访问模型路由实例时使用的身份凭证。模型路由根据 API Key 完成请求鉴权,并执行模型访问、用量统计、限流和预算控制。
BYOK 密钥:用户在第三方模型服务提供商处持有的自有密钥,用于模型路由连接原厂模型、第三方代理模型或用户自建模型。
模型路由访问密钥(API Key)属于实例级资源。在一个模型路由实例中创建或导入的 API Key,只能用于访问当前实例,不支持跨实例使用。
一个模型路由实例可以创建多个 API Key。新建或导入的 API Key 默认归属系统内置的未分组 API Key 用户组。后续可根据管理需求,将 API Key 分配至其他用户组。关于用户组的详细介绍,请参见 用户组介绍
说明:
模型路由实例、用户组和 API Key 均可配置积分预算及速率限制。当多个层级同时配置限制时,以最先达到的额度或速率限制为准。
BYOK 模型产生的模型调用费用由相应模型服务提供商收取。模型路由不会重复收取模型调用费用,仅收取模型路由处理费,详见 计费概述

前提条件

1. 建议提前阅读 使用约束支持模型了解相关信息。
2. 已创建模型路由实例,详细操作指导请参见 创建模型路由实例

操作步骤

步骤1:创建 API Key

1. 登录 模型路由 控制台,在实例管理页面,单击目标实例 ID

2. 在实例详情页,选择用户组页签
3. 用户组页签中,单击新建 Key

4. 新建 Key 界面中配置 Key 名称等参数,并单击确定
5. API Key 创建成功后,会在创建成功的弹窗中展示 API Key 信息,请您妥善保管。您也可以单击下载到本地,进行保存。

说明:
1. 关闭弹窗后将无法再次查看完整的 Key,请谨慎操作并妥善保管。
2. 新建 API Key 默认归属至未分组 API Key 用户组,后续可根据业务需要分配至其他用户组。

步骤2:批量创建或导入 API Key

1. 如果需要批量创建密钥,在用户组页签中,单击批量新建 Key

2. 批量新建 Key 界面中,可以选择自动生成 Key 导入已有 Key。

按照弹窗中的格式要求输入配置信息,单击确定,即可批量创建或导入 Key。
自动生成 Key:输入要批量生成的 Key 名称,可用中英文逗号、换行分隔多值,支持批量粘贴。
导入已有 Key:每行输入一个要导入的 Key,格式为:Key 名称,Key 内容(中英文逗号隔开)。
说明:
导入已有 Key 用于导入访问模型路由实例的凭证,不用于导入模型服务提供商的 API Key。
3. 批量创建或导入 API Key 完成后,系统将在创建成功的弹窗中展示 API Key 信息,请您妥善保管。您也可以单击下载到本地,进行保存。
说明:
1. 关闭弹窗后将无法再次查看完整的 Key,请谨慎操作并妥善保管。
2. 批量创建或导入的 API Key 默认归属至未分组 API Key 用户组。

后续操作

1. 将 API Key 分配至相应用户组。详细操作指导请参见 分配路由访问密钥
2. 新增 BYOK 模型,详细操作指导请参见 创建 BYOK 实例
3. 关联模型并配置模型路由策略,详细操作指导请参见 配置模型调度管理