创建／修改令牌 Key

💡 简介

注册登录后，你可以在控制台创建令牌 Key，用于调用站内 API。

创建步骤

1. 登录「爱次元」平台。
2. 进入 控制台。
3. 点击「创建 Key」按钮。
4. 按需配置参数（见下方“参数说明”）。
5. 保存并复制生成的 Key。

📝 注意

创建后的令牌可在后期登录爱次元的令牌管理进行修改。

图 1：创建 Key 入口

参数说明

令牌名称

用于区分不同用途的 Key，建议设置为你容易识别的名字，例如：prod-web​、dev-local​、临时测试。

图 2：填写令牌名称

令牌分组（倍率）

用于区分不同分组/倍率规则。一般选择默认或较低倍率即可；如需按成本拆分或使用特定规则，请按需选择。

图 3：选择令牌分组

过期时间

按需设置 Key 的失效时间；到点后该 Key 将不可再使用。

例如：设置为 2026-02-05 00:00:00，则在该时间点后请求会被拒绝。

图 4：设置过期时间

💡 提示

建议为临时/测试 Key 设置较短过期时间，降低泄露风险。

新建数量

一次性生成多个 Key（每个 Key 都不同）。例如：数量设置为 10，将生成 10 个 Key。

图 5：设置新建数量

额度设置

限制该 Key 可消耗的余额额度。达到上限后，该 Key 将无法继续调用；也可以设置为无限额度。

例如：额度设置为 10 元，则当累计消耗达到 10 元后该 Key 将被限制继续使用。

图 6：设置额度限制

访问限制

可设置该 Key 的模型限制列表与 IP 白名单（支持 CIDR 表达式）。

• 模型限制列表：限制该 Key 只能调用指定模型，例如仅允许 GPT-5.2。
• IP 白名单：限制只有指定 IP/网段可使用，例如 127.0.0.1​ 或 192.168.0.0/24。

图 7：访问限制设置

⚠️ 注意

配置 IP 白名单前，先确认你的出口 IP/网段；配置错误可能导致自己无法使用。

安全建议

⚠️ 重要

• 不要将 Key 分享给他人。
• 不要将 Key 提交到代码仓库（如 GitHub/Gitee）。
• 不要在截图、录屏或公开场合展示完整 Key。
• 推荐使用环境变量或私密配置文件存储 Key。
• 定期轮换 Key；怀疑泄露时立即停用并重新生成。

保存与使用

创建成功后，请立即复制并妥善保存你的 Key。

图 8：复制 Key

示例（请替换为你的实际 Key）：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

常见问题

Key 过期/额度用完了怎么办？

重新创建一个新的 Key，并按需设置过期时间与额度限制。

Key 泄露了怎么办？

立即停用/删除旧 Key，重新创建新 Key，并检查是否存在异常调用。