需先创建新API Key并等待30秒同步，再通过灰度切流或双写配置实现双密钥并行验证，确认无401/403错误后，分步停用并删除旧Key。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
线上服务正在调用腾讯混元 API，但当前 API Key 已接近配额上限或存在泄露风险，需在不中断请求的前提下完成密钥切换——这要求新旧密钥必须存在重叠生效期，且所有客户端配置同步更新不能早于新密钥创建完成。
创建新 API Key 并确认状态
登录腾讯云控制台 → 进入 混元大模型控制台 → 左侧导航栏点击「接入管理」→ 在「API Key 管理」页点击「创建 API Key」。
填写描述（例如“prod-202610-replace-v2”），勾选所需权限范围（务必与旧 Key 权限一致，【权限不一致会导致部分接口 403 报错】）→ 点击「确定」。
新 Key 创建后立即显示为「启用」状态，但需等待约 30 秒全网同步完成。此时不要关闭页面，直接复制新 Key 的值——该值仅显示一次，关闭后不可再次查看。
双密钥并行验证阶段
方法一：服务端灰度切流（推荐）
在负载均衡或网关层，将 5% 流量路由至使用新 Key 的实例；观察 10 分钟内日志中是否出现 401/403 错误。若无异常，逐步提升至 100%。
方法二：客户端双写配置（适用于 LobeChat、CherryStudio 等桌面客户端）
先在设置中填入新 Key 和原地址 https://api.hunyuan.cloud.tencent.com/v1/ → 点击「检查」确认连接成功 → 不要立即删除旧 Key，保持两个 Key 同时可用至少 2 小时。
注意：OpenAI 兼容模式下，部分 SDK 缓存了 auth header，重启应用进程才能加载新 Key。这一步跳过会导致后续切换失败。
分批次撤下旧 Key
第一步：确认所有服务实例已完成新 Key 配置且稳定运行满 2 小时；
第二步：登录控制台 → 「API Key 管理」页 → 找到旧 Key 行 → 点击「停用」；
第三步：观察核心业务指标（如响应成功率、延迟 P95）是否波动；
第四步：若 15 分钟内无异常，返回页面 → 对同一旧 Key 点击「删除」。
删除操作不可逆，且删除后该 Key 立即失效。请确保第三步监控已覆盖全部调用链路，包括定时任务、离线脚本等易遗漏的调用方。
