创建 API Key

API Key 是调用玄州API 的凭证，所有请求都需要携带有效的 API Key。

什么是分组？

在创建 API Key 之前，需要先了解「分组」的概念：

分组代表不同的上游资源渠道
不同分组的模型、稳定性、质量可能有所不同
创建 Key 时需要选择一个分组
分组决定了该 Key 可以访问哪些模型及其价格

如果不确定选择哪个分组，建议选择默认分组，或联系客服获取推荐。

创建步骤

1. 进入密钥管理

登录控制台，点击左侧导航栏的「密钥管理」。

2. 添加令牌

点击页面上的「添加令牌」按钮，弹出设置窗口。

3. 填写令牌信息

在创建窗口中填写以下信息：

参数	说明
令牌名称	自定义名称，方便区分不同用途（如「个人开发」「团队共用」）
分组	选择上游资源渠道，可在模型广场查看各分组可用模型
额度	设置该 Key 的使用额度上限（可选，不设则使用账户总余额）
期限	设置 Key 的有效期限（可选，不设则永久有效）

4. 提交生成

点击「提交」按钮，系统会生成一个 sk- 开头的 API Key。

5. 复制保存

重要：API Key 仅在创建时显示一次！ 请立即复制并保存到安全的位置。

如果丢失 Key，需要重新创建
不要将 Key 分享给他人
不要将 Key 提交到公开的代码仓库

Key 管理

创建完成后，可以在密钥管理页面看到所有 Key：

状态：启用/禁用
余额：该 Key 的剩余额度
分组：所属的分组
操作：编辑、禁用、删除

可以对 Key 进行以下操作：

编辑：修改额度、期限、分组等信息
禁用/启用：临时关闭 Key，不再扣费但保留配置
删除：永久删除 Key，不可恢复

安全建议

使用环境变量：不要将 API Key 硬编码在代码中
bash
```
export XUANZHOU_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
```
1
定期更换：建议每 3-6 个月更换一次 API Key
最小权限：为不同应用创建不同的 Key，设置合理的额度上限
警惕泄露：如果在 GitHub 等公开平台意外泄露，立即在控制台禁用并重新生成

模型广场

点击左侧导航栏的「模型广场」可以查看：

所有分组及其可用模型列表
每个模型的输入/输出/cache 价格
模型的 API 端点地址

点击某个模型名称，可以查看该模型的详细信息，包括对应的 API 端点。

下一步

获取 API Key 后，可以查看以下教程开始使用：

创建 API Key ​

什么是分组？ ​

创建步骤 ​

1. 进入密钥管理 ​

2. 添加令牌 ​

3. 填写令牌信息 ​

4. 提交生成 ​

5. 复制保存 ​

Key 管理 ​

安全建议 ​

模型广场 ​

下一步 ​