必须将腾讯混元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（末尾有换行）都会导致认证失败。

腾讯混元

腾讯混元是由腾讯公司推出的通用大语言模型与AI助手产品，基于自研的混元大模型体系打造，提供智能问答、内容生成、代码辅助、办公写作、知识检索等能力。用户可以通过网页端、移动端等方式使用，用于学习、工作和内容创作等多种场景。

下载

不同调用方式下的填写位置

方法一：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头，无需手动拼接。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！