必须将腾讯混元API Key按Bearer格式填入Authorization请求头，即“Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx”，且Key需启用、未过期、无空格换行；curl用单引号-H参数、Python requests需设headers字典并含Content-Type、OpenAI SDK自动处理Bearer封装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在HTTP请求中正确使用腾讯混元API Key完成身份认证，必须将密钥按规范格式填入Authorization请求头，否则服务器会返回401 Unauthorized错误。
确认API Key有效性
登录TokenHub控制台→进入「API密钥管理」→检查目标Key状态为「启用中」且未过期。已禁用或创建超过90天的Key无法用于鉴权。
复制Key时注意不要带前后空格或换行符——【粘贴后建议在代码编辑器中用光标左右移动确认首尾无不可见字符】。
构造Authorization请求头值
混元API不接受原始密钥字符串直接填入，必须使用Bearer方案前缀。
标准格式为：Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx。
其中sk-开头的字符串是你从控制台复制的完整API Key，中间不能插入任何空格、冒号或额外文本；Bearer和Key之间用单个空格分隔。
错误示例：Authorization: Bearer: sk-xxx（多了冒号）、Authorization: "Bearer sk-xxx"（加了引号）、Authorization: Bearer sk-xxx\n（末尾有换行）都会导致认证失败。
不同调用方式下的填写位置
方法一：curl命令行
在-curl命令中用-H参数添加请求头：-H 'Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx'。单引号可防止Shell解析$符号或空格，必须使用单引号包裹整个头字段。
方法二：Python requests库
在headers字典中写入：{"Authorization": "Bearer " + API_KEY, "Content-Type": "application/json"}。注意不要漏掉"Content-Type"，否则部分接口会拒绝处理。
方法三：OpenAI SDK初始化
初始化client时传入base_url和api_key两个参数：client = OpenAI(api_key="sk-xxx", base_url="https://tokenhub.tencentmaas.com/v1")。SDK内部会自动将key组装为Bearer格式注入Authorization头，无需手动拼接。
