主题
创建／修改令牌
💡 介绍
这篇会带你把令牌这一步做完。注册好账号后，先把令牌准备好，后面配置 API 地址和工具会顺很多。
🔐 访问凭证管理
先创建令牌，再配置地址与工具
不确定怎么选时，优先按默认路径操作
你可以把令牌理解成一把“通行钥匙”。后面无论是配客户端、开发工具，还是脚本调用，通常都要把它填到 API Key、API 密钥、apiKey 这类位置。第一次用不用把所有参数都研究透：先建 1 个能正常用的令牌，跑通以后再细调就行。
图 1：令牌管理与创建入口概览
✅ 创建前先知道
需要提前准备什么
你只要先确认两件事：自己能正常登录平台，且大致知道接下来要接哪个工具。如果只是先试试，建一个临时用途的令牌就够了。
第一次使用怎么选最稳妥
不确定怎么选时，先按默认来：先建 1 个 令牌，名称写用途，分组先默认，临时测试把过期时间设短一点。等能正常用起来，再慢慢调整。
创建好后下一步做什么
令牌创建完成后，先去配置 API 基础地址（Base URL），再回到具体工具里填写 API Key / API 密钥 / apiKey，然后发一条简单请求试一下。
现在先做这 4 步
进入令牌管理 → 新建 1 个令牌 → 保存并复制 → 去配置 Base URL
先把最基本的连接跑通，别急着把所有限制都配满。等你确认能正常使用后，再回头细调分组、额度和访问限制。
🔄 如果你这次是来修改旧令牌
这类情况直接改旧令牌
只是改名称、过期时间、额度，或者补一下模型限制 / IP 白名单，直接修改原来的令牌就行。
这类情况直接新建更省心
如果你担心令牌已经泄露，或者想把测试和正式环境、不同工具、不同设备彻底分开，直接新建一把会更清楚，也更安全。
🪜 创建与修改步骤
1
2
新建，或点开你要修改的那一把
还没有令牌，就点创建 Key；已经有令牌，就找到那一把并点进去修改。
进入编辑界面后，就可以开始填参数了。
3
先把最重要的几项填好
先填名称、分组、数量。名称写用途，数量一般填 1，分组不确定就先用默认值。
填完这一步，你至少已经能认出这把令牌是给谁用的。
4
不确定的限制先别加
如果只是先测试，过期时间和额度按需要填就行；模型限制和 IP 白名单，等你很确定要限制哪些内容时再加。
第一次用的重点是先能用，不是一次把所有限制都配满。
5
保存并复制令牌
确认没问题后保存，然后立刻复制令牌。后面工具里看到的 API Key / API 密钥 / apiKey，填的就是这串值。
复制完先保存好，然后直接去下一步：配置 Base URL。
图 2：从控制台进入令牌管理并创建 Key
🔧 参数怎么选
看不懂参数时，就先按这套填
名称写用途，分组先默认，数量填 1。临时测试可以把过期时间设短一点，想控制花费再去设置额度；IP 白名单没有把握时，先不要填。
| 参数 | 第一次怎么填 | 什么时候再改 |
|---|---|---|
| 令牌名称 | 写工具名、设备名或使用场景，方便以后认出来 | 令牌多了，不好区分时 |
| 令牌分组 | 不清楚就先选默认或推荐项 | 想按成本、模型或权限拆分时 |
| 新建数量 | 一般填 1 | 需要同时给多个环境或设备生成时 |
| 过期时间 | 临时测试可以设短一点；长期使用按需设置 | 想控制时效，或准备轮换令牌时 |
| 额度设置 | 想控制花费再设；不急着控预算可先按需 | 需要做预算管理时 |
| 访问限制 | 没把握先留空，尤其是 IP 白名单 | 你已经明确要限制模型或 IP 时 |
图 3：创建令牌时先完成基础参数填写
图 4：限制项用于模型范围与 IP 白名单控制
什么时候修改，什么时候重建？
只是改名称、过期时间、额度这些小设置，直接改旧令牌就行；担心泄露，或者想把测试和正式环境彻底分开时，直接新建一把会更省心。
⚠️ 注意
配置 IP 白名单前，先确认你当前的出口 IP 或网段。白名单填错后，最常见的结果不是“限制失败”，而是你自己先无法继续使用。
🚀 创建成功后如何使用
接下来按这个顺序做
复制令牌 → 打开 Base URL 文档 → 回到工具填写 API Key → 发一条简单请求测试
这些名字说的是同一串值
这里的令牌、Key、API Key、密钥、apiKey，说的都是你刚刚复制的那串东西，只是不同页面叫法不同。
这三项别混淆
令牌是你的访问凭证，Base URL 是接口地址，模型名是你要用的能力。三样通常都要配，但不是同一个东西。
令牌通常填到哪里
大多数客户端或开发工具里，你会看到 API Key、API 密钥、apiKey 或 Key 认证 这类字段，把刚复制的令牌粘贴进去就行。
怎么判断已经通了
先填令牌，再填 Base URL，然后试着获取模型或发一条简单请求。能正常返回结果，就说明这条链路已经跑通了。
创建后的令牌值通常会作为请求头中的身份凭证：
text
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx💡 提示
切换主备地址或更换 Base URL，通常不等于更换 API Key。大多数情况下，你只需要改地址，不需要重新创建令牌。
图 5：保存后请立即复制并妥善保管令牌
🔐 安全建议
⚠️ 重要
- 不要把令牌分享给他人，也不要把完整令牌发到群聊、工单、截图或录屏里。
- 不要把令牌提交到代码仓库，例如 GitHub、Gitee 或任何公开备份。
- 建议把令牌保存到环境变量、密码管理器或私密配置文件中，而不是散落在聊天记录或桌面便签中。
- 临时测试令牌建议设置较短过期时间；长期使用的令牌也别一直不换。
- 一旦怀疑令牌泄露，先停用旧令牌，再新建一把新的。
❓ 常见问题
API Key、令牌、密钥是不是同一个东西？
是。大多数时候它们说的都是同一串值，只是不同工具里的叫法不一样。你在控制台复制到的那串，就是后面要填的 API Key。
填了令牌还是报 401 或 invalid_api_key，怎么办？
先检查四件事：令牌有没有复制完整、前后有没有多空格、Base URL 有没有填错、当前令牌是不是已经过期或被限制了模型 / IP / 额度。
找不到令牌，或者刚创建完就没复制到，怎么办？
先回到令牌管理列表确认有没有保存成功。如果页面只显示一次完整令牌值，之后又找不到了，最省事的做法通常是重新创建一把新的，并立刻保存好。
过期、额度、白名单出了问题，怎么办？
过期时间或额度不合适，可以回到令牌管理直接调整；IP 白名单填错了，就先改回去或移除。要是已经把自己限制住了，直接新建一把不带该限制的令牌会更快。
修改旧令牌后为什么还是不能调用？
先确认修改已经保存，然后重新检查工具里填的是不是旧令牌、旧地址。必要时重新复制一次令牌，刷新工具配置后再试。
切换主备地址后要不要换令牌？
通常不需要。主备地址变化的是访问线路，不是账号体系。大多数情况下，保留原令牌，仅调整 Base URL 即可。
什么时候应该直接新建，而不是修改旧令牌？
当你怀疑令牌泄露、想把测试和正式环境分开，或者想给不同工具单独分配凭证时，直接新建一把通常比继续改旧令牌更省事。
下一步：先配置 Base URL，再回到工具填写 Key
照这个顺序走最省事：先把地址配好，再把刚复制的令牌填进工具里，最后发一条简单请求测试。这样最不容易把“令牌”“地址”“模型”混在一起。