创建 API 令牌
令牌（在控制台中显示为 API 密钥，形如 sk-xxxx）是调用 API 的唯一凭证。无论是在代码里调用，还是在 Cherry Studio、NextChat 等客户端里使用，都需要先创建一个 API 密钥并填入。
本页带你一步步在控制台里创建第一个 API 密钥。
适用场景
- 你刚注册完账号，准备第一次调用模型。
- 你想为某个新应用、新脚本单独创建一个密钥，方便分别管理或单独吊销。
开始前准备
- 一个已注册并可正常登录的账号。还没有账号？请先完成 快速开始 的注册与登录。
- 一个浏览器即可，无需安装任何工具。
创建密钥本身不收费，也不需要先充值。但用密钥实际调用模型会消耗账户额度，详见 充值与额度。
操作步骤
第 1 步：进入「API 密钥」页面
登录后进入控制台，在左侧菜单的 常规 分组下点击 API 密钥。
首次进入时列表是空的，会提示「没有可用的 API 密钥。创建您的第一个 API 密钥即可开始使用。」
你应该看到：页面标题为 API 密钥，右上角有一个 ＋ 创建 API 密钥 按钮。
第 2 步：打开创建窗口并填写基本信息
点击右上角的 创建 API 密钥，右侧会滑出「创建 API 密钥」面板。在 基本信息 区域填写：
- 名称：给密钥起一个方便区分用途的名字，例如
我的第一个密钥、生产环境、测试。 - 分组：保持默认分组即可。如果平台提供了多个分组（对应不同价格或可用模型范围），按需选择。不清楚怎么选见 认识分组。
- 过期时间：默认 永不过期。也可以点击 1 个月 / 1 天 / 1 小时 快捷设置，或自己选择一个具体的到期时间；到期后该密钥会自动失效。
- 数量：默认
1，即创建一个密钥。如需一次性创建多个，可调大数字，系统会在名称后自动添加随机后缀。
你应该看到：名称 已填好，分组 已选中，其余项保持默认。对大多数人来说，到这一步就可以直接保存了。
第 3 步（可选）：设置额度上限和访问限制
如果你想控制单个密钥的风险，可以展开下面两个区域按需设置；不需要可以跳过。
- 额度设置：默认开启 无限配额（表示该密钥不单独设额度上限）。关掉 无限配额 后，会出现 总额度 输入框，可填写该密钥最多能消费的额度；还可设置 额度重置周期（每天 / 每周 / 每月），让额度按周期自动重置。
- 高级设置（点击展开）：
- 模型限制：限制该密钥只能调用选定的模型，留空表示允许所有模型。
- IP 白名单：限制只有指定 IP 才能用该密钥，每行一个，支持 CIDR 写法，留空表示不限制。
提示
无限配额 指的是这个密钥本身不设单独上限，并不代表调用免费。实际调用仍会从你的账户余额扣费。为单个密钥设置 总额度，可以避免某个应用或脚本意外耗尽全部余额。
第 4 步：保存并复制密钥
点击面板底部的 保存更改。保存成功后面板关闭，新密钥会出现在列表里，状态显示为 已启用。
列表中的 API 密钥 一列默认是打码状态（如 sk-ULTH**********4Xnc）。复制完整密钥有两种方式：
- 点击密钥右侧的 复制图标，直接复制完整密钥到剪贴板；
- 点击打码的密钥文本，会弹出 完整 API 密钥，可查看完整内容后再手动复制。
请妥善保管
完整密钥可以随时在此列表中查看和复制，但它等同于账户的调用权限。请把它当作密码对待：不要发给他人，不要放进公开仓库、前端代码、截图或聊天记录。怀疑泄露时，立即删除该密钥并重新创建。
如何确认已成功
- 列表中出现了你刚创建的密钥，名称正确，状态为 已启用。
- 复制出的密钥以
sk-开头。 - 把它填入客户端或代码后能正常发起调用（参考 调用 API）。
使用令牌
调用时在请求头中以 Bearer 方式携带密钥：
Authorization: Bearer sk-xxxxxxxxxxxxxxxx在第三方客户端中，则把它填到 API Key 一栏，Base URL 填 https://api.jmds.dev/v1。详见 在客户端中使用。
常见问题
保存时提示需要填写名称？ 请确认 名称 不为空，填写后再次点击 保存更改。
调用返回 401 / 未授权？ 通常是密钥填错或已过期。确认请求头格式为 Bearer sk-xxxx，密钥完整无多余空格，且未被删除或过期。更多排查见 常见问题。
调用返回额度不足（insufficient quota）？ 账户或该密钥的额度已耗尽。前往 充值与额度 充值，或检查该密钥是否设置了过低的 总额度。
想停用或删除密钥？ 在列表中找到对应密钥，使用行末的菜单进行 禁用 或 删除。删除不可恢复，删除后用该密钥的调用会立即失效。
安全建议
- 为不同用途创建不同密钥，便于单独吊销。
- 通过 总额度 和 过期时间 控制单个密钥的风险敞口。
- 需要更严格的访问控制时，使用 模型限制 和 IP 白名单。
- 怀疑泄露时，立即删除该密钥并重新创建。