[{"data":1,"prerenderedAt":373},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fmodels-billing\u002Fbyok":3,"doc-surround-\u002Fdocs\u002Fmodels-billing\u002Fbyok":280,"doc-nav-zh":287},{"id":4,"title":5,"body":6,"description":270,"extension":271,"meta":272,"navigation":273,"order":274,"path":275,"section":276,"seo":277,"stem":278,"__hash__":279},"docs_zh\u002Fdocs\u002F03.models-billing\u002F14.byok.md","自带 API Key（BYOK）",{"type":7,"value":8,"toc":261},"minimark",[9,13,22,27,63,66,157,160,164,171,193,203,218,221,242,245],[10,11,5],"h1",{"id":12},"自带-api-keybyok",[14,15,16,17,21],"p",{},"如果你已经有智谱、DeepSeek、通义千问、Kimi、MiniMax 或火山引擎等厂商的 API Key，可以直接绑定到灵犀指 IDE：请求按",[18,19,20],"strong",{},"厂商官方价格由厂商计费，平台零加价","。自带 Key 与套餐内置额度可以共存，随时切换。",[23,24,26],"h2",{"id":25},"添加-key","添加 Key",[28,29,30,39,47,55],"steps",{},[31,32,33],"step",{},[14,34,35,38],{},[18,36,37],{},"获取厂商 Key","：前往模型厂商控制台创建 API Key（如智谱开放平台、火山引擎方舟等）。",[31,40,41],{},[14,42,43,46],{},[18,44,45],{},"打开设置页","：在 IDE 中进入「设置 → AI 模型」，选择添加厂商配置。",[31,48,49],{},[14,50,51,54],{},[18,52,53],{},"填写配置","：选择厂商渠道（自动带出官方 Base URL），粘贴 API Key，并选择要使用的模型。",[31,56,57],{},[14,58,59,62],{},[18,60,61],{},"保存并选中","：将新配置设为选中项后，AI 对话、内联编辑与 RUSH 任务会立即改用你的 Key 发起请求。",[23,64,65],{"id":65},"支持的渠道",[67,68,69,82],"table",{},[70,71,72],"thead",{},[73,74,75,79],"tr",{},[76,77,78],"th",{},"渠道",[76,80,81],{},"Base URL",[83,84,85,97,107,117,127,137,147],"tbody",{},[73,86,87,91],{},[88,89,90],"td",{},"智谱 GLM 官方",[88,92,93],{},[94,95,96],"code",{},"https:\u002F\u002Fopen.bigmodel.cn\u002Fapi\u002Fpaas\u002Fv4",[73,98,99,102],{},[88,100,101],{},"DeepSeek 官方",[88,103,104],{},[94,105,106],{},"https:\u002F\u002Fapi.deepseek.com",[73,108,109,112],{},[88,110,111],{},"通义千问官方",[88,113,114],{},[94,115,116],{},"https:\u002F\u002Fdashscope.aliyuncs.com\u002Fcompatible-mode\u002Fv1",[73,118,119,122],{},[88,120,121],{},"Kimi 官方",[88,123,124],{},[94,125,126],{},"https:\u002F\u002Fapi.moonshot.cn\u002Fv1",[73,128,129,132],{},[88,130,131],{},"MiniMax 官方",[88,133,134],{},[94,135,136],{},"https:\u002F\u002Fapi.minimaxi.com\u002Fv1",[73,138,139,142],{},[88,140,141],{},"火山引擎",[88,143,144],{},[94,145,146],{},"https:\u002F\u002Fark.cn-beijing.volces.com\u002Fapi\u002Fv3",[73,148,149,152],{},[88,150,151],{},"硅基流动",[88,153,154],{},[94,155,156],{},"https:\u002F\u002Fapi.siliconflow.cn\u002Fv1",[14,158,159],{},"以上渠道均为 OpenAI 兼容协议，粘贴 Key 即可使用，无需额外适配。",[23,161,163],{"id":162},"key-的加密存储","Key 的加密存储",[14,165,166,167,170],{},"Key 在服务端",[18,168,169],{},"不以明文落库","，完整保护链路如下：",[172,173,174,181,187],"ol",{},[175,176,177,180],"li",{},[18,178,179],{},"AES-256-GCM 加密","：主密钥经 SHA-256 派生出 32 字节加密密钥，使用随机 nonce 的 AES-256-GCM 完成加密，密文自带完整性校验。",[175,182,183,186],{},[18,184,185],{},"2-of-3 密钥分片","：加密后的密钥种子经 XOR 拆分为 3 个分片，任意 2 个分片才能还原——两个分片下发本地，第三个分片存于服务端并随密钥有效期自动过期。",[175,188,189,192],{},[18,190,191],{},"归属隔离","：每套配置仅归属当前账号，可同时保存多套厂商配置，但同一时刻只有一个选中配置生效。",[194,195,197],"callout",{"type":196},"warn",[14,198,199,202],{},[18,200,201],{},"安全建议","：建议为灵犀指单独创建 Key，并在厂商控制台设置额度上限。更换设备或怀疑泄露时，先在厂商后台吊销旧 Key，再在设置页删除对应配置。",[194,204,206],{"type":205},"tip",[14,207,208,211,212,217],{},[18,209,210],{},"BYOK 与套餐的关系","：自带 Key 只改变「模型请求走谁的账户」，IDE 功能权益仍跟随套餐。AI 对话、内联编辑与 FIM 补全本就不计 Agent 次数，详见",[213,214,216],"a",{"href":215},"\u002Fdocs\u002Fmodels-billing\u002Fplans-quota","套餐与配额","。",[23,219,220],{"id":220},"管理已绑定的配置",[222,223,224,230,236],"ul",{},[175,225,226,229],{},[18,227,228],{},"修改","：更新渠道、Base URL、模型或 Key 本身。",[175,231,232,235],{},[18,233,234],{},"切换选中","：在多套配置之间一键切换，选中的配置对全部 AI 功能生效。",[175,237,238,241],{},[18,239,240],{},"删除","：删除后立即停止通过该配置发起请求，可随时切回套餐内置额度。",[23,243,244],{"id":244},"下一步",[222,246,247,254],{},[175,248,249,250,217],{},"查看各渠道可绑定的模型：",[213,251,253],{"href":252},"\u002Fdocs\u002Fmodels-billing\u002Fmodels","支持的模型",[175,255,256,257,217],{},"配置完成后开始第一个任务：",[213,258,260],{"href":259},"\u002Fdocs\u002Fguides\u002Frush","RUSH 指南",{"title":262,"searchDepth":263,"depth":263,"links":264},"",2,[265,266,267,268,269],{"id":25,"depth":263,"text":26},{"id":65,"depth":263,"text":65},{"id":162,"depth":263,"text":163},{"id":220,"depth":263,"text":220},{"id":244,"depth":263,"text":244},"在灵犀指 IDE 中绑定自己的模型厂商 API Key：设置页添加、AES-256 加密存储、按厂商计费平台零加价","md",{},true,14,"\u002Fdocs\u002Fmodels-billing\u002Fbyok","模型与计费",{"title":5,"description":270},"docs\u002F03.models-billing\u002F14.byok","arRTqNiOMxslzUf9RbUT6KgzkWZYnPsFKgYxgahHPUo",[281,283],{"title":216,"path":215,"stem":282,"children":-1},"docs\u002F03.models-billing\u002F13.plans-quota",{"title":284,"path":285,"stem":286,"children":-1},"快捷键","\u002Fdocs\u002Freference\u002Fshortcuts","docs\u002F04.reference\u002F15.shortcuts",[288],{"title":289,"path":290,"stem":291,"children":292,"page":314},"Docs","\u002Fdocs","docs",[293,315,347,355],{"title":294,"path":295,"stem":296,"children":297,"page":314},"快速上手","\u002Fdocs\u002Fgetting-started","docs\u002F01.getting-started",[298,302,306,310],{"title":299,"path":300,"stem":301},"安装与下载","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F01.getting-started\u002F01.installation",{"title":303,"path":304,"stem":305},"注册与登录","\u002Fdocs\u002Fgetting-started\u002Fregister-login","docs\u002F01.getting-started\u002F02.register-login",{"title":307,"path":308,"stem":309},"首次配置","\u002Fdocs\u002Fgetting-started\u002Ffirst-setup","docs\u002F01.getting-started\u002F03.first-setup",{"title":311,"path":312,"stem":313},"从 VS Code 迁移","\u002Fdocs\u002Fgetting-started\u002Fmigrate-from-vscode","docs\u002F01.getting-started\u002F04.migrate-from-vscode",false,{"title":316,"path":317,"stem":318,"children":319,"page":314},"功能指南","\u002Fdocs\u002Fguides","docs\u002F02.guides",[320,324,327,331,335,339,343],{"title":321,"path":322,"stem":323},"AI 对话与内联编辑","\u002Fdocs\u002Fguides\u002Fai-chat","docs\u002F02.guides\u002F05.ai-chat",{"title":325,"path":259,"stem":326},"RUSH 深度任务","docs\u002F02.guides\u002F06.rush",{"title":328,"path":329,"stem":330},"FIM 代码补全","\u002Fdocs\u002Fguides\u002Ffim-completion","docs\u002F02.guides\u002F07.fim-completion",{"title":332,"path":333,"stem":334},"语义代码图谱","\u002Fdocs\u002Fguides\u002Fcode-graph","docs\u002F02.guides\u002F08.code-graph",{"title":336,"path":337,"stem":338},"MCP 工具与市场","\u002Fdocs\u002Fguides\u002Fmcp","docs\u002F02.guides\u002F09.mcp",{"title":340,"path":341,"stem":342},"调试与 DAP","\u002Fdocs\u002Fguides\u002Fdebugging","docs\u002F02.guides\u002F10.debugging",{"title":344,"path":345,"stem":346},"集成终端","\u002Fdocs\u002Fguides\u002Fterminal","docs\u002F02.guides\u002F11.terminal",{"title":276,"path":348,"stem":349,"children":350,"page":314},"\u002Fdocs\u002Fmodels-billing","docs\u002F03.models-billing",[351,353,354],{"title":253,"path":252,"stem":352},"docs\u002F03.models-billing\u002F12.models",{"title":216,"path":215,"stem":282},{"title":5,"path":275,"stem":278},{"title":356,"path":357,"stem":358,"children":359,"page":314},"参考与 FAQ","\u002Fdocs\u002Freference","docs\u002F04.reference",[360,361,365,369],{"title":284,"path":285,"stem":286},{"title":362,"path":363,"stem":364},"配置项","\u002Fdocs\u002Freference\u002Fconfiguration","docs\u002F04.reference\u002F16.configuration",{"title":366,"path":367,"stem":368},"内核 API","\u002Fdocs\u002Freference\u002Fkernel-api","docs\u002F04.reference\u002F17.kernel-api",{"title":370,"path":371,"stem":372},"常见问题","\u002Fdocs\u002Freference\u002Ffaq","docs\u002F04.reference\u002F18.faq",1786077825655]