创建与保护 API Key
先完成账户
在注册与登录完成邮箱验证码、登录密码与账户信息。QQ / 支付宝授权后的未完善账户也需要完成这些步骤,才能调用模型和充值。
创建调用密钥
- 打开密钥管理,选择创建密钥。
- 名称写明用途,例如「个人 Cherry Studio」或「项目开发环境」。
- 根据页面实际选项设置有效期、可用额度和模型限制;使用默认分组时不需要自行寻找隐藏线路。
- 保存后复制密钥到自己的密码管理器或客户端。不要使用网页登录密码、后台管理令牌代替它。
- 用快速开始中的一条简短请求验证。实际生成会消费余额。
每个用途分开一把钥匙
电脑客户端、服务器项目和临时实验分别创建密钥,方便在日志里区分用途,也能单独撤销。模型限制只是可调用范围,不会增加账户余额;密钥额度与账户剩余额度都应足够。
密钥泄露时
立即在密钥管理撤销旧密钥,再创建新密钥、更新客户端并检查近期消费记录。只删除公开截图或 Git 文件不能撤销已经泄露的密钥。不要把完整密钥发给客服;提供错误码、时间和已脱敏的请求信息。
地址核对
Base URL 为 https://api.baiyun.si/v1。完整 Chat 地址为 https://api.baiyun.si/v1/chat/completions;完整 Responses 地址为 https://api.baiyun.si/v1/responses。填写哪一种取决于客户端字段含义,不要拼出 /v1/v1。