模型与计费 / 自带 API Key(BYOK)

自带 API Key(BYOK)

如果你已经有智谱、DeepSeek、通义千问、Kimi、MiniMax 或火山引擎等厂商的 API Key,可以直接绑定到灵犀指 IDE:请求按厂商官方价格由厂商计费,平台零加价。自带 Key 与套餐内置额度可以共存,随时切换。

添加 Key

1

获取厂商 Key:前往模型厂商控制台创建 API Key(如智谱开放平台、火山引擎方舟等)。

2

打开设置页:在 IDE 中进入「设置 → AI 模型」,选择添加厂商配置。

3

填写配置:选择厂商渠道(自动带出官方 Base URL),粘贴 API Key,并选择要使用的模型。

4

保存并选中:将新配置设为选中项后,AI 对话、内联编辑与 RUSH 任务会立即改用你的 Key 发起请求。

支持的渠道

渠道Base URL
智谱 GLM 官方https://open.bigmodel.cn/api/paas/v4
DeepSeek 官方https://api.deepseek.com
通义千问官方https://dashscope.aliyuncs.com/compatible-mode/v1
Kimi 官方https://api.moonshot.cn/v1
MiniMax 官方https://api.minimaxi.com/v1
火山引擎https://ark.cn-beijing.volces.com/api/v3
硅基流动https://api.siliconflow.cn/v1

以上渠道均为 OpenAI 兼容协议,粘贴 Key 即可使用,无需额外适配。

Key 的加密存储

Key 在服务端不以明文落库,完整保护链路如下:

  1. AES-256-GCM 加密:主密钥经 SHA-256 派生出 32 字节加密密钥,使用随机 nonce 的 AES-256-GCM 完成加密,密文自带完整性校验。
  2. 2-of-3 密钥分片:加密后的密钥种子经 XOR 拆分为 3 个分片,任意 2 个分片才能还原——两个分片下发本地,第三个分片存于服务端并随密钥有效期自动过期。
  3. 归属隔离:每套配置仅归属当前账号,可同时保存多套厂商配置,但同一时刻只有一个选中配置生效。
!

安全建议:建议为灵犀指单独创建 Key,并在厂商控制台设置额度上限。更换设备或怀疑泄露时,先在厂商后台吊销旧 Key,再在设置页删除对应配置。

BYOK 与套餐的关系:自带 Key 只改变「模型请求走谁的账户」,IDE 功能权益仍跟随套餐。AI 对话、内联编辑与 FIM 补全本就不计 Agent 次数,详见套餐与配额

管理已绑定的配置

  • 修改:更新渠道、Base URL、模型或 Key 本身。
  • 切换选中:在多套配置之间一键切换,选中的配置对全部 AI 功能生效。
  • 删除:删除后立即停止通过该配置发起请求,可随时切回套餐内置额度。

下一步