文档中心

实时音视频

FAQ

AI 未进房或未正常工作？

HTTP Code 返回 200

问题描述

调用 StartVoiceChat 返回 200，但是出现以下任一异常情况：

AI 加入房间后无响应，例如没有欢迎语。

AI 加入房间后有欢迎语，但后续语音沟通无反应。

AI 加入房间后，听不到 AI 的声音。

可能原因

若你首次接入遇到该问题：

导致上述现象的可能原因如下：

音频设备问题：比如本地麦克风或扬声器配置不当或故障。

服务配置问题：ASR、TTS、LLM 等服务未开通或参数配置错误。

接口参数设置问题：StartVoiceChat 接口缺少必填参数、填写错误或参数大小写错误。

权限问题：跨服务授权未开启，RTC 没有权限调用其他 AI 服务。

若之前运行正常，你再次调用 StartVoiceChat 接口时遇到该问题：

请查看 ASR、TTS、LLM 等服务试用或购买额度是否已用完，或已达限额。

问题排查

若你首次接入遇到该问题，可以参考以下步骤进行排查：

步骤1：检查音频设备

进入与 AI 对话：

如果无法和 AI 进行正常对话，则可能是音频输入设备问题，可按照如下方法排查：

Web 端：请参看 Web 排查无声问题。

Native 端：请参看 Native 排查无声问题。

如果可以和 AI 进行正常对话，则可能是接口设置问题，请继续执行后续排查步骤。

步骤2：检查跨服务授权

前往跨服务授权查看是否已开通跨服务授权。若显示未开通可按照提示一键开通。

步骤3：检查 StartVoiceChat 配置

你可以通过监听任务状态和错误回调来定位发生错误的阶段，并获得任务错误详细信息。

如何实现监听任务状态和错误回调，请参见获取 AI 对话任务事件。

请确保账号已开通 ASR、TTS、LLM 服务，并正确获取并配置了对应核心参数。

注意

若 ASR、TTS 或 LLM 使用的是火山引擎的服务，请检查是否在使用免费版。如在使用免费版请前往控制台确认免费版额度是否用完。如已开通正式版，请确认是否购买资源包。

可使用无代码跑通 Demo 快速检验以下核心参数是否正确填写。如无代码跑通 Demo 无法正常运行，则证明参数填写错误，请对参数值进行逐一排查。

详细参数说明，请参考 StartVoiceChat。

服务名称			核心参数
ASR	火山引擎流式语音识别	AppId：开通火山引擎流式语音识别服务后获取的 App ID，用于标识应用。你可登录豆包语音控制台获取。 Cluster：开通的流式语音识别服务对应的集群标识（Cluster ID）。你可登录豆包语音控制台开通服务后获取。
ASR		火山引擎流式语音识别大模型	AppId：开通火山引擎流式语音识别大模型服务后获取的 App ID，用于标识应用。你可登录豆包语音控制台获取。 AccessToken：与开通流式语音识别大模型服务 App ID 对应的 AccessToken，用于身份认证。你可登录豆包语音控制台获取。
TTS	火山引擎语音合成	appid：开通火山引擎语音合成服务后获取的 App ID，用于标识应用。你可登录豆包语音控制台获取。 cluster：开通的语音合成服务对应的集群标识（Cluster ID）。你可登录豆包语音控制台开通服务后获取。 voice_type：已开通音色对应的音色种类（Voice_type）。你可登录豆包语音控制台购买音色后获取。
		火山引擎语音合成大模型流式输入流式输出	appid：开通火山引擎语音合成大模型服务后获取的 App ID，用于标识应用。你可登录豆包语音控制台获取。 token：与开通流式语音识别大模型服务 App ID 对应的 AccessToken，用于身份认证。你可登录豆包语音控制台获取。 voice_type：已开通音色对应的音色种类（Voice_type）。你可登录豆包语音控制台购买音色后获取。
		火山引擎声音复刻大模型非流式输入流式输出	appid：开通火山引擎声音复刻大模型服务后获取的 App ID，用于标识应用。你可登录豆包语音控制台获取。 cluster：开通的声音复刻大模型服务对应的集群标识（Cluster ID）。你可登录豆包语音控制台开通服务后获取。 voice_type：声音复刻声音 ID。你可登录豆包语音控制台获取。
		火山引擎声音复刻大模型流式输入流式输出	appid：开通火山引擎声音复刻大模型服务后获取的 App ID，用于标识应用。你可登录豆包语音控制台获取。 cluster：开通的声音复刻大模型服务对应的集群标识（Cluster ID）。你可登录豆包语音控制台开通服务后获取。 voice_type：声音复刻声音 ID。你可登录豆包语音控制台获取。
		MiniMax	Authorization：API 密钥。前往 Minimax 账户管理-接口密钥获取。 Groupid：用户所属组 ID。前往 Minimax 账号信息-基本信息获取。
LLM	火山方舟平台	自定义推理点 EndPointID 或应用 ID。前往火山方舟控制台获取。仅支持自定义推理接入点，不支持预置推理接入点。创建应用时仅支持使用自定义推理接入点，不支持预置推理接入点。
		Coze 平台	BotId：Coze 智能体 ID。可前往你需要调用的智能体开发页面获取。开发页面 URL 中 bot 参数后的数字即智能体ID。例如开发页面 URL 为：https://www.coze.cn/space/341/bot/73428668，则 BotId 为 73428668。智能体必须已发布为 API。 APIKey：Coze 访问密钥。你可以生成个人访问令牌以供测试。线上环境注意替换为 OAuth 访问密钥。你可根据不同的使用场景，选择不同的 OAuth 授权方式，详情参考OAuth 应用管理。
		第三方大模型	URL：第三方大模型 URL。

检查 StartVoiceChat 接口请求参数是否正确并完整填写。

确保所有必填参数是否填写。

检查以下参数的规范性：

RoomId、TaskId、TargetUserId、UserId：是否按照参数赋值规范填写，不得出现中文字符。

RoomId：是否与房间内客户端 SDK 进房时的使用的 RoomId 保持一致

TargetUserId：是否与房间内客户端 SDK 进房时使用的 UserId 保持一致。

如参数均正确，但仍无法正常运行，请前往使用的在线推理点模型限流是否设置为 0。

若按照以上步骤排查后依然无法正常工作，请联系技术支持提供 OpenAPI 接口请求的 RequestId 进行排查。

HTTP Code 返回！200

调用 StartVoiceChat 返回！200 状态码时，如 401，请查看对应报错进行处理。

例如报错信息提示 InvalidAuthorization，则证明使用 Token 无效。可前往控制台 Token 校验检查 Token 是否有效。

最近更新时间：2026.10.08 11:23:36

这个页面对您有帮助吗？

有用

无用