鉴权失败通常因api key未正确注入或authorization请求头格式不合规。需校验密钥有效性、确认bearer格式规范（如“bearer sk-xxx”）、确保密钥绑定到对应模型实例，并通过curl直连验证基础链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在配置WorkBuddy自定义模型时遭遇鉴权失败，通常表现为HTTP 401错误、日志中出现“invalid credentials”或“Unauthorized”提示，则极可能源于API Key未正确注入或Authorization请求头格式不合规。以下是解决此问题的步骤：
一、校验API Key来源与有效性
WorkBuddy调用自定义模型前需使用平台签发的有效API Key进行身份识别，该密钥必须来自对应模型服务商的正式控制台，且未过期、未被手动禁用。
1、登录模型服务提供商的官方控制台（如Minimax、千帆、Ollama或私有部署的vLLM管理界面）。
2、进入「API密钥管理」或「安全凭证」页面，确认当前密钥状态为“启用”，并记录其创建时间与有效期。
3、若密钥已超过90天有效期，或近期存在重置操作，点击「重新生成」获取新密钥，并立即作废旧密钥。
4、复制新密钥时，**务必使用鼠标拖选整段字符，避免触碰键盘导致光标偏移而漏选末尾字符**。
二、检查Authorization请求头构造规范
WorkBuddy将API Key嵌入HTTP请求头的Authorization字段，服务端对该字段执行严格正则匹配，仅接受形如Bearer后紧跟单个空格及原始密钥字符串的格式，任何额外符号、换行或编码均会导致校验失败。
1、在WorkBuddy配置文件（如config.yaml或.env）中定位model_provider.auth.header字段，确认其值为"Authorization"。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、检查model_provider.auth.value字段是否采用标准Bearer模式，例如：Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx，而非"Token sk-..."、"API-Key: sk-..."或带引号的"\"Bearer sk-...\""。
3、若通过环境变量注入（如MODEL_AUTH_VALUE），在终端执行echo $MODEL_AUTH_VALUE | cat -A，确认输出末尾无$符号或^M换行符。
4、在WorkBuddy日志中搜索"req.headers.Authorization"，比对实际发出的请求头原始值与配置值是否完全一致。
三、验证密钥注入路径与作用域隔离
WorkBuddy支持多模型并行调用，不同模型的API Key需绑定至对应provider实例，若全局复用或跨环境混用，将因作用域不匹配触发鉴权拒绝。
1、打开WorkBuddy集成中心，进入【模型管理】→【自定义模型配置】，核对每个模型条目的「认证凭证」是否独立填写，不可留空或引用其他模型ID。
2、若使用YAML配置，确认各model节点下auth块为嵌套结构，而非顶层共用；示例中不得出现两个provider共享同一auth.value。
3、检查是否存在CI/CD流水线自动覆盖行为：构建时是否从K8s Secret或Vault动态注入密钥，且注入目标容器内路径与WorkBuddy读取路径（如/config/auth.json）一致。
4、临时将密钥硬编码至测试脚本中发起curl直连，命令示例：curl -H "Authorization: Bearer sk-abc123" https://your-model-endpoint.com/v1/chat/completions，验证基础链路是否通畅。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
