开始前准备好

先在模型广场确认目标模型和分组，在钱包确认账户余额。创建密钥本身不会充值，也不会让账户获得未开放的模型权限。

按表单一步一步填

  1. 打开API 密钥，点击右上方「创建 API 密钥」。
  2. 名称： 填用途，例如「Cherry Studio 测试」。名称用于自己识别，不是最终 API Key。
  3. 分组： 选择目标模型支持的分组。新手可以先选明确分组；如果保留默认 auto，先读auto 顺序与跨分组重试。
  4. 过期时间： 表单有「永不」「1 个月」「1 天」「1 小时」快捷按钮，也可通过日期和时间控件设置。临时测试可先用「1 天」。
  5. 数量： 第一次保留 1。批量创建时名称会添加随机后缀，不必为一次测试批量生成。
  6. 额度设置： 默认「无限配额」开启。希望限制测试消耗时，关闭它，在「额度 (CNY)」填写预算，例如 10；这只是预算示例，不是充值要求或模型报价。
  7. 按需要展开「高级设置」，核对模型限制和 IP 白名单。
  8. 点击表单底部「保存更改」，返回列表后确认新密钥的名称、状态、分组、额度和有效期。

上图为打开表单时的默认状态。如果你采用限额测试方案，还需要关闭下方的「无限配额」。截图采集于 2026-09-18。

高级设置怎么填

字段新手如何理解
无限配额不给这把密钥单独设额度上限，仍然消耗账户余额
额度 (CNY)密钥可用额度，以表单和列表显示为准；增加它不等于充值
模型限制选中后限制这把密钥可使用的模型；留空表示不额外限制，仍受分组和账户权限约束
IP 白名单只在知道客户端真实公网出口 IP 时设置，支持 CIDR；不要填电脑的内网 IP

手机网络、代理或云服务器更换出口后，原 IP 白名单可能阻止调用。测试时不要随意填一个 IP；成功接入后再按实际环境收紧限制。

复制到客户端时填三项

在列表中找到刚创建的那一行，通过密钥区域的复制控件取得完整 API Key。列表里的 sk-… 掩码展示不能手抄代替完整值，也不要把密钥发到聊天里请别人检查。

客户端字段填什么
API Key / API 密钥刚创建的完整密钥，没有首尾空格、引号或换行
Base URL / API 地址对要求 OpenAI Base URL 的应用填写 https://top.qingyuntop.ai/v1
模型从模型广场复制完整模型 ID，并与密钥分组匹配

一般 API Key 输入框只填密钥本身。只有手写 HTTP 请求头时才使用 Authorization: Bearer ...。具体软件是否自动补 /v1，请按客户端入门进入对应教程。

怎么确认真的配置成功

在客户端发送一条短文本，收到回复后，打开使用日志，按发送时间、模型和令牌名称找到记录。仅看到“连接成功”或模型列表，并不等于完整生成已经成功。

失败时先检查复制是否完整、状态是否启用、是否过期、账户与密钥额度是否足够，再核对模型与分组。后续调整和泄露处理见管理与轮换密钥。