方案集成前置准备--实时音视频-火山引擎

文档中心

立即注册

导航

方案集成前置准备

最近更新时间：2025.04.25 15:35:24首次发布时间：2024.07.16 17:04:59

本文提供集成实时对话式 AI 场景的接入准备指南，涵盖服务开通、权限配置等步骤，确保 RTC 具备基础的资源接入能力与调用权限。

操作流程

集成前准备包括开通服务和配置权限 2 步：

开通服务：依次开通 RTC、ASR、LLM、TTS 服务。
配置权限：根据业务需要，配置不同权限的主账号或子账号以调用智能体与真人用户进行对话。

一、开通服务

步骤 1：开通 RTC 服务

参看开通教程，开通 RTC 服务并创建应用。

步骤 2：开通 ASR 和 TTS 服务

登录语音技术控制台。
单击创建应用按钮，在弹出的抽屉栏中填写应用名称和应用简介，并选择服务。和本方案相关的服务、选择要求和建议如下表所示。

类别	服务	服务选择建议	要求
ASR	流式语音识别	响应延迟较小，适用于响应速度要求高的语音控制场景，例如，实时问答、语音控制和会议速记	至少选择 1 项
	流式语音识别大模型	识别准确率更高，适用于内容复杂或背景噪音较多的场景，例如，嘈杂场景对话、专业术语识别、多语种混合	至少选择 1 项
TTS	语音合成	常规语音播报需求，适合短语或标准回复，例如，提醒、系统反馈、数字播报	至少选择 1 项
	语音合成大模型	注重语音自然度与情感表现的交互，适用于对话中需要自然语调与情感表达的场景，例如，客户服务、教育陪练、故事讲述
	声音复刻大模型	可生成近似真人语音，适用于需要构建定制化语音形象时使用，例如，品牌数字人、虚拟主播、游戏角色

点击确定按钮，完成应用创建。

注意

开通后默认为试用版，享有免费使用额度。
为保证线上长期正常使用，建议后续请开通正式版并购买资源包。但注意开通正式版后，试用版赠送的免费使用额度将自动清空。

步骤 3：开通 LLM 服务

火山引擎提供 3 种方式调用大模型服务。

调用方法	服务选择建议
使用火山方舟在线推理	可快速调用火山方舟大模型。详情可参看通过 Endpoint ID 调用模型在火山方舟平台创建并获取自定义推理接入点进行调用。说明仅支持使用自定义推理接入点接入大模型，不支持使用预置推理接入点。
使用火山方舟应用	可通过零代码组合插件、知识库、工作流等功能调用大模型或基于应用 SDK 实现高代码编排方式。详情可参看使用火山方舟应用实验室创建应用并获取应用 ID 进行调用。
使用 Coze 应用	可在零代码或低代码的基础上，组合插件、知识库、工作流等功能调用大模型。详情可参看 Coze 快速开始创建 Coze 智能体并获取 Coze 智能体 ID进行调用。

你也可以接入第三方大模型，但是第三方大模型接口需要符合约定标准规范，详情查看对话式 AI 第三方大模型接口验证。

二、配置不同权限账号调用智能体

你可以根据业务需要选择以下方式调用智能体：

	主账号	子账号
服务端(推荐)	使用主账号在服务端调用操作简单，鉴权仅需获取 AK SK 密钥信息，且密钥信息存储在服务端不易泄漏，但注意主账户具有账户的完全权限。	使用子账号在服务端调用操作相对复杂，但是密钥信息存储在服务端不易泄漏，且子账号只拥有赋予的调用智能体的权限，实现了权限的隔离和管控，操作安全。
客户端	使用主账号在客户端调用操作简单，鉴权仅需获取 AK SK 密钥信息，但注意 AK SK 存储在客户端容易泄漏，且注意主账户具有账户的完全权限，	使用子账号在客户端调用操作复杂，鉴权需要获取临时AK、SK、临时 Token 密钥信息，避免了密钥信息一经泄漏造成重大损失，且子账号只在临时 Token 生效期间拥有调用智能体的权限，实现了权限最小化管控。

使用主账号在服务端调用

使用主账号在客户端调用

使用子账号在服务端调用

使用子账号在客户端调用

你可按照以下步骤实现使用主账号在服务端调用接口。

在主账号配置VoiceChatRoleForRTC 角色。
你需要在主账号配置 VoiceChatRoleForRTC 角色，以便 RTC 能够调用 ASR 、TTS 和 LLM 服务来实现与智能体实时对话，实现房间内智能体与真人用户互动。
1. 登录主账号 RTC 控制台。
2. 前往跨服务授权，点击一键开通跨服务授权配置角色。
配置成功后你可以在角色管理中找到该角色，该角色拥有SAFullAccess 、 MaaSExperienceAccess 和 RTCFullAccess权限。
调用接口。

此时使用主账号的 AK、SK 即可调用 StartVoiceChat 接口，实现房间内智能体与真人用户互动。

你可按照以下步骤实现使用主账号在客户端调用接口。

在主账号配置VoiceChatRoleForRTC 角色。
你需要在主账号配置 VoiceChatRoleForRTC 角色，以便 RTC 能够调用 ASR 、TTS 和 LLM 服务来实现与智能体实时对话，实现房间内智能体与真人用户互动。
1. 登录主账号 RTC 控制台。
2. 前往跨服务授权，点击一键开通跨服务授权配置角色。
配置成功后你可以在角色管理中找到该角色，该角色拥有SAFullAccess 、 MaaSExperienceAccess 和 RTCFullAccess权限。
调用接口。

此时使用主账号的 AK、SK 即可调用 StartVoiceChat 接口，实现房间内智能体与真人用户互动。

你可按照以下步骤实现使用子账号在服务端调用接口。

在主账号配置VoiceChatRoleForRTC 角色。
你需要在主账号配置 VoiceChatRoleForRTC 角色，以便 RTC 能够调用 ASR 、TTS 和 LLM 服务来实现与智能体实时对话，实现房间内智能体与真人用户互动。
1. 登录主账号 RTC 控制台。
2. 前往跨服务授权，点击一键开通跨服务授权配置角色。
配置成功后你可以在角色管理中找到该角色，该角色拥有SAFullAccess 、 MaaSExperienceAccess 和 RTCFullAccess权限。
为子账号添加调用实时对话式 AI 接口权限。
1. 登录主账号 RTC 控制台。
2. 前往跨服务授权，点击**为子账号添加权限，**找到你需要授权的子账号，点击添加权限。

调用接口。

此时使用子账号的 AK、SK 即可调用 StartVoiceChat 接口，实现房间内智能体与真人用户互动。

你可按照以下步骤实现使用子账号在客户端调用接口。

在主账号配置VoiceChatRoleForRTC 角色。
你需要在主账号配置 VoiceChatRoleForRTC 角色，以便 RTC 能够调用 ASR 、TTS 和 LLM 服务来实现与智能体实时对话，实现房间内智能体与真人用户互动。
1. 登录主账号 RTC 控制台。
2. 前往跨服务授权，点击一键开通跨服务授权配置角色。
配置成功后你可以在角色管理中找到该角色，该角色拥有SAFullAccess 、 MaaSExperienceAccess 和 RTCFullAccess权限。
为子账号赋予获取临时密钥权限。
子账号获取临时密钥权限后，即可在密钥有效期内调用实时对话式 AI 接口。
1. 登录主账号 RTC 控制台。
2. 点击用户头像选择访问控制。
1. 在左侧导航栏选择角色点击VoiceChatRoleForRTC。
1. 点击信任关系，填入以下代码为子账号添加信任关系。
将信任关系中的代码修改为如下代码，以便子账号拥有使用VoiceChatRoleForRTC角色的权限。
```
{
   "Statement": [
      {
            "Effect": "Allow",
            "Action": [
               "sts:AssumeRole"
            ],
            "Principal": {
               "Service": [
                  "rtc"
               ],
               "IAM": [
                  "trn:iam::2100********:user/cody" //格式为：trn:iam::${主账号AccountId}:user/${子账号UserName}
               ]
            }
      }
   ]
}
```
1. 在左侧导航栏选择用户，点击待授权用户，即子账号用户名。
1. 点击权限，选择 添加权限，，添加 STSAssumeRoleAccess 权限。
调用接口

使用子账号调用 AssumeRole OpenAPI 接口获取临时 AK、SK 及 Token。获取成功后，即可在密钥有效期内通过临时 AK、SK 及 Token 调用 StartVoiceChat 接口实现房间内智能体与真人用户互动。
调用AssumeRole接口时 RoleSessionName 和 RoleTrn为必填项。RoleSessionName可自定义，用来标志此次AssumeRole请求。RoleTrn填写规则为 trn:iam::${AccountId}:role/${RoleName}，例如trn:iam::2100****3232:user/cody。