火山引擎不用SDK怎么发送模型请求_火山引擎HTTP接口调用示例

冬枫姑娘_9169

冬枫姑娘_9169

2026-10-27

243人浏览

原创

必须使用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接口调用示例

想绕过火山引擎官方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。

火山引擎
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

组装并发送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发送(将替换为真实签名):

curl -X POST "https://mls.cn-north-1.volcengineapi.com/api/v1/chat/completions" \
  -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}'

相关专题

更多
Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

80

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

40

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

40

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

2026.10.22

20

10

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

2026.10.22

40

25

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

2026.10.22

20

15

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

2026.10.22

40

15

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

2026.10.22

240

12

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理,讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

2026.10.22

20

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程