调用火山引擎豆包大模型API时，必须严格按新版单密钥体系配置请求头：X-Api-Key（控制台生成的ak-开头密钥）、Content-Type为application/json、X-Api-Request-Id为标准UUID，三者大小写与格式缺一不可，否则返回401错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用火山引擎豆包大模型API时，HTTP请求头中鉴权字段填错一个字符就会触发401 Unauthorized错误，导致接口完全不可用。
新版控制台API Key鉴权方式
新版控制台已统一简化为单密钥体系，仅需配置X-Api-Key即可完成鉴权，无需再管理APP ID与Access Token的组合。
第一步：在火山引擎控制台「API Key管理」页面，选择对应项目，点击「创建API Key」生成新密钥。
第二步：复制生成的API Key字符串（形如ak-xxxxxxxxxxxxxxxxxxxxxxxx），注意不要复制前后空格或换行符。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
第三步：构造请求头，确保包含以下三项且大小写完全一致：【Content-Type必须为application/json，X-Api-Key值必须与控制台生成的一致，X-Api-Request-Id必须是合法UUID格式】
这一步操作起来很简单，直接把文件拖进去就行。但若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，需手动补上。
【旧版鉴权已逐步下线，2026年9月起部分区域节点将停止响应X-Api-App-Key类请求】
关键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，否则视为无效字段。
