实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开发指南
配置 ASR/LLM/TTS 服务
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频硬件对话智能体服务端 API调用方法
复制全文
下载 pdf调用方法
文档反馈
问问助手目前硬件对话智能体的 OpenAPI 仅支持手动构造请求，并自行完成签名计算。
完整请求结构
一个有效的 OpenAPI 请求必须包含：请求行 + 请求头（含签名）+ 请求体。完整结构如下：
# -------------------- Part 1: 请求行 --------------------
[Method] https://[Host]/?Action=[Action]&Version=[Version]
# -------------------- Part 2: 请求头（需携带鉴权签名） --------------------
Host: [参考下方说明]
Content-Type: [参考下方说明]
X-Date: [动态生成的当前 UTC 时间]
X-Content-Sha256: [根据 Part 3 请求体计算出的SHA256哈希值]
Authorization: [必须进行签名，用于鉴权]
# -------------------- Part 3: 请求体 --------------------
# 对于 POST 请求，这里是“接口特有参数”
{
"Parameter1": "Value1",
"Parameter2": "Value2",
...
}
各部分说明
请求行
- [Method]、[Action]、[Version] ：可在对应接口文档获取。以 AibotCreate 接口为例，如下图所示：
-
- [Host]：固定为 rtc.volcengineapi.com。
请求头（需携带鉴权签名）
参数 | 如何获取 / 构造 |
参数 | 如何获取 / 构造 |
[Host] | 服务接入点，与请求行中的保持一致。 |
[Content-Type] | 资源的 MIME 类型。对于 POST 请求，固定为 application/json；Get 请求中，该值可为空。 |
[X-Date] | 请求时间， UTC 格式（ISO 8601），精确到秒，例如 20201230T081805Z。 |
[X-Content-Sha256] | 请求体的 SHA256 哈希值。若请求体为空，则使用一个固定的哈希值。 |
[Authorization] |
请求体
附录
签名方法和示例
签名需要遵循一套严格的加密和规范化流程，你参考签名机制自行计算，或参考示例代码实现。
- 自行计算：请参见签名机制。
- 上述示例是一个通用的框架，在使用时需要根据具体需求修改文件中的配置变量信息和接口调用参数。
- 替换配置变量：
- AK、SK：访问 API访问密钥 页面创建并获取。
- Service：固定为 rtc。
- Region：固定为 cn-north-1。
- Host：固定为 rtc.volcengineapi.com。
- 设置接口参数：
- Action / Version：来自具体 API 文档。
- Body 或 Query：业务参数，参考具体的 API 文档。
事件和错误码
最近更新时间：2025.11.27 21:29:31
这个页面对您有帮助吗？
有用
有用
无用
无用