硅基流动(SiliconFlow)的 API 密钥在官方控制台里自助生成,不需要提交工单或等审核。整个过程就三步:登录控制台、进 API 密钥页、点新建。下面把每一步的入口和容易漏掉的地方说清楚,顺便讲明白拿到密钥后怎么接进代码。
一、获取前的准备
| |
|---|
| 打开 cloud.siliconflow.cn,支持手机号验证码或邮箱登录,首次登录即自动完成注册。 |
| 自 2026 年 5 月起,未实名账号的平台功能会受限。建议在拿密钥前先在控制台完成实名,避免建好密钥却调不通。 |
| 注册后通常会赠送体验额度(具体面值以控制台实时显示为准),足够先跑通一次调用。 |
二、新建 API 密钥(核心步骤)
- 登录 cloud.siliconflow.cn,进入控制台首页。
- 在左侧菜单找到「API 密钥」(部分页面也叫「API 管理」或「账户管理」),点进去。
- 右上角点「新建 API 密钥」(英文界面写作 Create API Key)。
- 给密钥起个名字做区分,比如「本地测试」「生产环境」「Cline 专用」,方便以后管理。
- 点确认后系统生成一串 sk- 开头的密钥。它只在生成这一刻完整显示一次,马上点复制存到本地密码管理器,关掉页面就再也看不到全文了。
密钥只显示一次。这是最容易翻车的地方:很多人关掉弹窗才想起来没复制,只能删掉重建。养成习惯——先复制保存,再关窗口。另外密钥等同于你账号的完整调用权限,别贴到论坛、仓库或客服对话里。
三、拿到密钥后怎么接
硅基流动提供 OpenAI 兼容接口,大多数现成工具改个地址和密钥就能用。国内站调用端点为 https://api.siliconflow.cn/v1,国际站为 https://api.siliconflow.com/v1。
| | |
|---|
| base_url=https://api.siliconflow.cn/v1,api_key=你的密钥 | |
| 请求头 Authorization: Bearer 你的密钥,POST 到 /chat/completions | |
| 填 API Provider 为 OpenAI Compatible,Base URL 同上 | |
验证是否生效,最简单的办法是进官方「体验中心(playground)」先用界面跑一次,再用同一密钥在代码里调同样的模型,两边结果一致就说明配置没问题。
四、密钥的日常管理
四点提醒:
1. 密钥只显示一次,先存再用。
2. 未实名账号从 2026 年 5 月起功能受限,调不通先查实名状态。
3. 密钥等同于账号权限,泄露后第一时间回控制台删除并重发。
4. 调用按量计费,具体单价以 docs.siliconflow.cn 的定价页实时显示为准,别用第三方攻略里的旧数字。
常见问题
1. 密钥在哪看?入口叫什么?
在 cloud.siliconflow.cn 控制台左侧菜单,叫「API 密钥」,有的版本归在「账户管理」下。
2. 密钥生成后还能看到全文吗?
不能。完整密钥只在创建那一刻显示,之后列表里只露头尾几位,所以要当场复制保存。
3. 国内站和国际站密钥通用吗?
账户体系不同,cloud.siliconflow.cn 和 cloud.siliconflow.com 是两套,密钥不互通,用哪个站注册的就在对应站的端点调用。
4. 调接口报 401 怎么办?
多半是密钥复制漏字符、或用了带 www 的错误控制台地址。确认密钥完整,且端点域名主体为 siliconflow.cn 或 siliconflow.com。
5. 一定要实名才能拿密钥吗?
注册和建密钥本身不强制,但 2026 年 5 月后未实名账号调用会受限,实际用起来还是建议先实名。
6. 密钥能多人共用吗?
技术上能,但不好追溯谁在调用。按项目或人员各建一个,出事好定位、好止损。
7. 一个账号能建几个密钥?
可建多个,官方没在公开文档里写死上限,以控制台实际显示为准。
8. 模型名怎么填?
在控制台「模型广场」或 siliconflow.cn/models 查,比如 DeepSeek、Qwen 系列都有各自的模型 ID,填错会报模型不存在。 9. 删除密钥后正在跑的任务会怎样?
立即失效,使用该密钥的调用会报错,需换上新密钥重新发起。
把硅基流动 API 密钥怎么获取这件事拆开看,其实就是「进官方控制台 cloud.siliconflow.cn、在 API 密钥页新建、当场复制保存」三句话。难点不在步骤,而在两个容易被忽略的点:密钥只显示一次所以要抢先存,以及未实名会导致调不通。配好之后,把端点改成 api.siliconflow.cn/v1、密钥填进去,就能用 OpenAI 兼容的方式跑通第一次调用了。