火山引擎方舟API的Authorization头必须严格为“Bearer sk-xxx”格式,即Bearer后跟一个半角空格再接API Key,任何大小写错误、多余字符、缺失空格或使用冒号等均导致400错误且无明确提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

调用火山引擎方舟API时,API Key必须以Bearersk-xxx格式写在Authorization请求头中,漏掉Bearer前缀、拼错大小写、多加空格或混用Access Key签名方式都会导致400错误且无明确提示。
Authorization头中Bearer的正确写法
第一步:在HTTP请求头中添加Authorization字段;
第二步:字段值严格写成Bearer 后跟一个英文半角空格,再紧接你的API Key字符串;
第三步:确认整个值形如Bearer sk-abc123def456,不能是Bearer:sk-abc123、Bearer(sk-abc123)或Bearer sk-abc123 (末尾带空格)。
这一步极其关键——火山引擎网关校验时对Bearer前缀和空格做精确匹配,少一个空格就直接拒绝,返回400且错误信息里只显示“invalid request”,不指出具体哪错了。
常见错误写法及后果
方法一:写成Authorization: sk-abc123 → 服务端无法识别凭证类型,返回400;
方法二:写成Authorization: Bearer:sk-abc123 → 冒号破坏标准Bearer Scheme格式,返回400;
方法三:写成Authorization: Bearer sk-abc123\n(含换行或制表符)→ 请求头解析失败,返回400。
注意:所有错误都统一返回400,不会告诉你缺空格、多冒号或含不可见字符——必须人工逐字核对。
如何验证Bearer格式是否生效
用curl发起最简GET请求:curl -H "Authorization: Bearer sk-xxx" https://ark.cn-beijing.volces.com/api/v1/models;
若返回200及JSON模型列表,说明Bearer格式+Key本身均正确;
若返回404,说明Endpoint路径或地域标识错误,与Bearer无关;
若返回400,99%是Bearer格式问题,立即检查空格和拼写。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











