火山引擎豆包大模型API鉴权头正确设置方式

调用火山引擎豆包大模型API时，需按新版单密钥体系配置请求头：X-Api-Key（控制台生成的ak-开头密钥）、Content-Type为application/json、X-Api-Request-Id为标准UUID，三者大小写与格式必须准确无误，否则将返回401错误。

调用火山引擎豆包大模型API时，HTTP请求头中鉴权字段填错一个字符就会触发401 Unauthorized错误，导致接口完全不可用。

新版控制台API Key鉴权方式

新版控制台已统一简化为单密钥体系，仅需配置X-Api-Key即可完成鉴权，无需再管理APP ID与Access Token的组合。

第一步：在火山引擎控制台「API Key管理」页面，选择对应项目，点击「创建API Key」生成新密钥。

第二步：复制生成的API Key字符串（形如ak-xxxxxxxxxxxxxxxxxxxxxxxx），注意不要复制前后空格或换行符。

第三步：构造请求头，确保包含以下三项且大小写完全一致：

这一步操作起来很简单，直接把文件拖进去就行。但若X-Api-Request-Id不是标准UUID（例如写成纯数字或带中文括号），服务端会直接拒绝请求，不返回任何有效错误提示。

旧版控制台兼容配置（不推荐）

如果你仍在使用旧版控制台，或对接遗留系统，必须同时提供三元组鉴权参数，缺一不可。

方法一：手动拼接headers字典

填写X-Api-App-Key（控制台显示为“APP ID”，是纯数字字符串）、X-Api-Access-Key（即Access Token，含大小写字母与数字）、X-Api-Request-Id（同新版要求，必须是UUID）。

方法二：从控制台导出配置片段

进入「控制台使用FAQ-Q1」页面，点击「一键复制旧版鉴权模板」，粘贴后替换其中的占位符即可。注意该模板不含Content-Type，需手动补上。

关键Header字段校验要点

Content-Type：固定写死为"application/json"，不能加空格、引号或分号，也不能写成"json"或"application/x-json"。

X-Api-Key / X-Api-App-Key：值中不能含中文字符、全角符号、制表符；若从网页复制，请先粘贴到记事本过滤隐藏格式。

X-Api-Request-Id：可用Python生成——import uuid; print(str(uuid.uuid4()))，也可用在线UUID生成器，但禁止手写或使用时间戳代替。

所有Header Key名称严格区分大小写，X-Api-Key不能写成x-api-key或X-API-KEY，否则视为无效字段。