必须使用Access Key与Secret Key构造V4签名请求头,含host、x-content-sha256、x-date(RFC3339格式且UTC误差≤15分钟),region为cn-north-1、service为mls,再发送JSON请求体至https://mls.cn-north-1.volcengineapi.com/api/v1/chat/completions。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想绕过火山引擎官方SDK,直接用HTTP请求调用其大模型服务(如Skywork、Doubao系列),必须手动构造符合鉴权规范的请求头与JSON体,否则401或403错误会立即返回。
获取Access Key与Secret Key
登录火山引擎控制台→进入「访问密钥」页面→点击「创建AccessKey」→复制保存Access Key ID和Access Key Secret。这一步不可跳过,【没有这对密钥,后续所有签名都会失败】。
注意:Secret Key仅在创建时显示一次,关闭页面后无法再次查看,务必立刻存入安全位置。
构造Authorization签名头
火山引擎使用V4签名机制,需按顺序拼接:HTTP方法 + 换行 + URI路径 + 换行 + 查询字符串(无则留空)+ 换行 + 标准化Header字符串(小写+冒号+单空格+值+换行,按key字典序)+ 换行 + 已哈希的signedHeaders + 换行 + payload的SHA256哈希值。
标准化Header必须包含:host、x-content-sha256、x-date;其中x-date格式为RFC3339,如2024-06-12T10:25:30Z,且必须与系统当前UTC时间误差在15分钟内,否则签名被拒。
最终Authorization头格式为:HMAC-SHA256 Credential=<ak>/<date>/<region>/<service>/request, SignedHeaders=host;x-content-sha256;x-date, Signature=<hex-signature></hex-signature></service></region></date></ak>。region固定为cn-north-1,service固定为mls。
组装并发送POST请求
请求地址为:https://mls.cn-north-1.volcengineapi.com/api/v1/chat/completions(以chat接口为例)。
设置请求头:
- Content-Type: application/json
- Host: mls.cn-north-1.volcengineapi.com
- x-content-sha256: 【必须是请求体原始字节的SHA256十六进制小写字符串,不是JSON字符串化后的】
- x-date: 当前UTC时间(精确到秒,带Z)
- Authorization: 上一步生成的完整签名串
请求体示例(纯JSON,不缩进不换行):
{"model":"skt-1.5-pro","messages":[{"role":"user","content":"你好"}],"max_tokens":128}用curl发送(将
-H "Content-Type: application/json" \
-H "Host: mls.cn-north-1.volcengineapi.com" \
-H "x-content-sha256: 4a7f36b3e5d9c8a1f2b4e6d9c8a1f2b4e6d9c8a1f2b4e6d9c8a1f2b4e6d9c8a1" \
-H "x-date: 2024-06-12T10:25:30Z" \
-H "Authorization: HMAC-SHA256 Credential=AKLTxxx/20240612/cn-north-1/mls/request, SignedHeaders=host;x-content-sha256;x-date, Signature=xxx" \
-d '{"model":"skt-1.5-pro","messages":[{"role":"user","content":"你好"}],"max_tokens":128}'


















