火山引擎豆包API密钥复制错误接入修复

密钥末尾存在换行符或空格导致AuthenticationError。需用编辑器显示不可见字符检查并删除末尾非字母数字字符；重新生成密钥后全选复制，粘贴到记事本核对格式；用curl或repr()验证是否含隐藏字符。

在火山引擎控制台创建豆包API密钥后，复制时不小心多选了一个换行符或空格，导致调用时一直返回AuthenticationError: Invalid API key。实际上，密钥格式正确，权限已开通，Endpoint配置也没有问题。这是因为豆包API对Authorization头的格式和空格有严格校验，若Bearer后缺少一个英文半角空格，或API Key中混入不可见字符（如换行符），服务端就会拒绝认证并返回401，且不返回具体失败原因。

确认密钥是否含隐藏字符

使用支持显示不可见字符的编辑器（如VS Code → 打开命令面板 → 输入“Toggle Render Whitespace”）打开你保存密钥的文本文件（如.env或config.py）。重点查看末尾是否有↵（换行）、·（空格）或 （全角空格）。

若发现末尾存在任何非字母数字字符，立即删除——

安全重复制密钥的三步操作

第一步：回到火山引擎控制台 →「API密钥管理」页面 → 找到对应密钥条目 → 点击右侧「重新生成」按钮。

第二步：弹窗中勾选「我已知晓该操作将使原密钥立即失效」→ 点击「确定」→ 页面刷新后出现新密钥。

第三步：鼠标单击密钥文本框 → 按 Ctrl+A 全选 → 按 Ctrl+C 复制 → 立即粘贴到记事本（非微信/QQ/钉钉等富文本环境）中核对：开头是ek-，结尾是字母或数字，长度为64，无换行提示。

验证密钥是否真正可用

方法一：用curl命令行快速验证（不依赖任何SDK）：

curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions"

-H "Authorization: Bearer YOUR_NEW_API_KEY"

-H "Content-Type: application/json"

-d '{"model":"ep-xxxxxxxx","messages":[{"role":"user","content":"你好"}]}'

把YOUR_NEW_API_KEY替换成你刚复制的密钥，把ep-xxxxxxxx替换成你实际的Endpoint ID。如果返回401，说明密钥仍有问题；如果返回400或404，说明密钥已通过鉴权，问题出在模型或参数上。

方法二：在Python中用repr()打印密钥原始值：

print(repr(os.getenv("ARK_API_KEY")))

输出结果若包含'\n'、' '或'\r'，就证实存在隐藏字符。