前置准备--实时音视频-火山引擎

文档中心

立即注册

实时音视频

请输入

集成实时对话式 AI

前置准备

集成实时对话式 AI 前，需开通相关云服务并配置跨服务授权。

一、开通服务

步骤 1：开通 RTC 服务

参考开通服务，开通 RTC 服务。开通后系统会自动新建一个默认应用，可直接使用且享受赠送额度。如需多个应用可自行创建。

步骤 2：开通 ASR 服务

可使用服务（任选其一）	支持的模型	开通方式
豆包 ASR	（推荐）流式语音识别大模型	登录豆包语音控制台。单击创建应用按钮，按照界面提示填写应用名称和应用简介，并选择左侧任一服务。
豆包 ASR	流式语音识别	登录豆包语音控制台。单击创建应用按钮，按照界面提示填写应用名称和应用简介，并选择左侧任一服务。
自定义 ASR	/	接入自定义 ASR 或 TTS

步骤 3：开通 TTS 服务

可使用服务（任选其一）	可选模型	开通方式
豆包语音 TTS	（推荐）语音合成大模型	登录豆包语音控制台。单击创建应用按钮，按照界面提示填写应用名称和应用简介，并选择左侧任一服务。注意开通后默认为试用版，享有免费试用额度。为保证线上长期正常使用，建议后续请开通正式版并购买资源包。开通正式版后，试用版赠送的免费使用额度将自动清空。
	声音复刻大模型
	语音合成
第三方或自定义 TTS	MiniMax 语音合成	参考 MinMax 官方文档
第三方或自定义 TTS	自定义 TTS	接入自定义 ASR 或 TTS

步骤 4：开通 LLM 服务

可使用服务（任选其一）	开通方式
火山方舟-模型推理	在方舟控制台创建自定义推理接入点，获取 Endpoint ID。仅支持使用自定义推理接入点，不支持使用预置推理接入点。
火山方舟-应用	在方舟应用实验室创建应用，获取应用 ID。仅支持使用自定义推理接入点，不支持使用预置推理接入点。
Coze 平台	在 Coze 平台创建智能体，获取智能体 ID。如何创建 Coze 智能体？
第三方大模型	您需要准备一个符合接口规范的服务 URL。具体要求，请参见如何接入第三方大模型或 Agent？

二、配置跨服务调用权限

为确保实时对话式 AI 服务有权调用 ASR、TTS 及 LLM 服务，必须为其配置 VoiceChatRoleForRTC角色并授予相应权限。

跨服务授权出现报错：“为子账号添加权限失败，超过了设定的配额限制”？

快速测试：使用主账号

生产环境：服务端调用（子账号）

生产环境：客户端调用（子账号）

如果你使用的是主账号操作，可按照以下步骤为主账号授权。

使用主账号调用接口，权限过大、安全性较低，建议用于测试或调试场景。

使用主账号登录实时音视频控制台。
选择实时对话式AI-跨服务授权，点击一键开通跨服务授权配置角色。
配置成功后你可以在角色管理中找到角色 VoiceChatRoleForRTC，该角色拥有SAFullAccess 、 MaaSExperienceAccess 和 RTCFullAccess权限。

如果你需要使用子账号在服务端进行操作，请参考以下步骤为子账号授权。

操作前，请确保你已创建一个子账号。可前往访问控制-用户管理-用户，创建一个新用户。

使用主账号登录实时音视频控制台。
选择实时对话式AI-跨服务授权，点击一键开通跨服务授权配置角色。
点击为子账号添加权限，找到你需要授权的子账号，点击添加权限。

如果你仅需要使用子账号在客户端进行操作，请参考以下步骤授予子账号扮演 VoiceChatRoleForRTC 角色的权限，并通过STS服务获取临时访问凭证。

操作前，请确保你已创建一个子账号。可前往访问控制-用户管理-用户，创建一个新用户。

使用主账号登录实时音视频控制台。
选择实时对话式AI-跨服务授权，点击一键开通跨服务授权配置角色。
点击为子账号添加权限，找到你需要授权的子账号，点击添加权限。

修改角色信任关系。

使用主账号进入访问控制-角色管理。
搜索找到 VoiceChatRoleForRTC 并点击。

点击信任关系，将策略内容修改为以下代码：
其中， {主账号AccountId} 和 {子账号UserName} 需替换为实际信息。

{
   "Statement": [
          {
            "Effect": "Allow",
            "Action": [
               "sts:AssumeRole"
            ],
            "Principal": {
               "Service": [
                  "rtc"
               ],
               "IAM": [
                  "trn:iam::{主账号AccountId}:user/{子账号UserName}"
               ]
            }
      }
   ]
}

为子账号授予AssumeRole权限。
1. 在左侧导航栏选择用户，找到并点击目标用户（即子账号用户名）。
2. 选择 添加权限，添加 STSAssumeRoleAccess 权限。
获取临时凭证。
在后端服务中，调用 AssumeRole 接口获取临时 AK、SK 及 Token。其中，
- RoleSessionName ：必填。自定义的会话名称，标识此次AssumeRole请求。
- RoleTrn：必填。格式为 trn:iam::{AccountId}:role/{RoleName}，例如trn:iam::2100****3232:role/VoiceChatRoleForRTC。
  调用成功后，接口会返回临时的 AK、SK 和 Token。将此临时凭证下发给客户端，可用于调用 StartVoiceChat 等接口。

FAQ

跨服务授权报错：`为子账号添加权限失败，超过了设定的配额限制`？

问题原因
系统预设的子账号可绑定的系统策略数额度为 40，如果超过了该配额，就会导致为子账号添加权限失败。
解决方法
1. 根据需求执行任意以下操作：
  - 删除旧策略：前往访问控制_用户，为子账号删除或合并不需要的旧策略。
  - 提升配额：如果策略无法精简，请至配额中心，产品列表选择访问控制，配额参数选择 SystemPoliciesPerUser，申请提升至您所需要的配额。
2. 重新为子账号进行跨服务授权权限。

最近更新时间：2025.12.11 14:41:14

这个页面对您有帮助吗？

有用

无用