文档中心

实时音视频

API 参考

事件和错误码

你可以通过回调机制实现对智能体任务状态和智能体状态进行监控，并获取错误信息，以快速定位问题。

VoiceChat 事件

通过控制台配置 VoiceChat 事件回调接收智能体任务状态及报错信息时，返回的事件信息如下所示。

参数名	类型	描述	示例值
AppId	String	音视频应用的唯一标识。	661e****543cf
BusinessId	String	业务标识。	biz1
RoomId	String	房间 ID，房间的唯一标识。	room1
TaskId	String	智能体任务 ID。	task1
UserID	String	说话人 UserId。	user1
RoundID	Int64	对话轮次。从 0 开始计数。	0
EventTime	Int64	该事件在 RTC 服务器上发生的 Unix 时间戳 (ms)。	1611736812853
EventType	Int64	任务状态类型。 0：智能体任务状态发生变化。 1：智能体任务出现错误。	0
RunStage	String	状态详情。 preParamCheck：参数校验错误。 taskStart：任务开始。 beginAsking：房间用户开始说话。 asrFinish：系统完成判停，判定房间用户本轮说话结束。 llmOutput：大模型已生成并输出首个 token。 answerStart：智能体开始说话。 answerFinish：智能体说话完成。 interrupted：智能体说话被打断。 reasoningStart：大模型开始深度思考。 asr：ASR 处理阶段。 llm：LLM 处理阶段。 tts：TTS 处理阶段。 taskStop：任务结束。 taskUsage：用量统计。此事件在 taskStop 之后发送，用量明细通过 ExtraInfo 字段返回。	llmOutput
ErrorInfo	ErrorInfo	任务错误详细信息。仅在 EventType 为 1 时出现。	-
ExtraInfo	String	额外信息，JSON 字符串格式。当 RunStage 为 taskUsage 时，该字段包含任务的资源用量明细（如TTS、LLM 用量等），具体返回信息取决于您使用的 API 版本。	{"UUID":"..."}

ErrorInfo

参数名	类型	描述	示例值
ErrorCode	Int	错误状态码。详细定义请参见错误码	1001
Reason	String	错误详细原因。	quota exceeded for types [...]：依赖服务配额超限。通常是 ASR、TTS 或 LLM 的免费额度耗尽，或购买的资源包已用完。 requested resource not granted：资源未授权或未开通。RTC 服务没有权限调用配置的 AI 服务，或者该 AI 服务本身未成功开通。

错误码

下表汇总了在执行以下操作时可能返回的错误码，以帮助你定位和解决问题：

通过客户端或服务端接收智能体状态时。

通过控制台配置 VoiceChat 事件回调接收智能体任务状态及报错信息时。

错误码	描述	可能原因及解决方案
1000001	任务初始化失败	原因：系统内部错误，导致任务无法启动。方案：请稍后重试。若问题持续，请联系技术支持。
1000002	未知参数	原因：StartVoiceChat 请求中包含了未定义的参数字段。方案：请仔细核对请求参数是否与 StartVoiceChat 文档一致，移除或修正错误参数。
1003001	ASR 实例化失败	原因：ASR 服务配置不正确或内部错误。方案：检查 ASRConfig 中的 Provider 和 ProviderParams 是否正确填写。
1003002	ASR 请求失败	原因：向 ASR 服务发送请求时失败。方案：检查网络连接。若问题持续，请联系技术支持。
1003003	ASR 响应读取失败	原因：从 ASR 服务接收响应时发生网络错误或超时。方案：检查网络稳定性。
1003004	ASR 响应解析失败	原因：ASR 服务返回的数据格式不符合预期。方案：如果使用自定义 ASR，请检查其返回格式是否符合协议。
1003005	ASR 重连失败次数过多	原因：与 ASR 服务的连接多次中断且无法恢复。方案：检查 ASR 服务的稳定性及网络状况。
1003006	ASR 建联失败	原因：无法与 ASR 服务建立连接。方案：1. 确认 ASR 服务已开通。 2. 检查 ASRConfig.ProviderParams 中的 AppId、AccessToken 等鉴权信息是否正确且有效。 3. 检查网络防火墙策略。
1004001	LLM 实例化失败	原因：LLM 服务配置不正确或内部错误。方案：检查 LLMConfig 中的 Mode、ModelName、APIKey 等参数是否正确。若使用自定义开通的方舟模型，请确认 ModelName 填写的是有效的 Model ID 或接入点 ID。
1004002	LLM 请求失败	原因：向 LLM 服务发送请求时失败。方案：检查网络连接。若问题持续，请联系技术支持。
1004003	LLM 响应读取失败	原因：从 LLM 服务接收响应时发生网络错误或超时。方案：检查网络稳定性。
1004004	LLM 响应处理失败	原因：LLM 服务返回的数据格式不符合预期。方案：如果使用第三方 LLM，请检查其返回格式是否符合接口标准。
1004005	LLM 建立连接失败	原因：无法与 LLM 服务建立连接。方案：1. 确认 LLM 服务已开通。 2. 检查 LLMConfig 中的 URL、APIKey 等鉴权信息是否正确。 3. 检查网络防火墙策略。
1004006	Function Calling 请求失败	原因：调用 FunctionCallingConfig.ServerMessageUrl 配置的业务方 URL 失败。方案：检查业务方服务是否正常，URL 是否可公网访问。
1004007	Function Calling 响应请求失败	原因：业务方服务返回了非 2xx 的 HTTP 状态码。方案：检查业务方服务逻辑，确保对回调请求能正确响应。
1004008	安抚语处理失败	原因：在 Function Calling 过程中，播放安抚语失败。方案：检查 TTS 配置是否正确。
1004009	MCP 获取工具失败	原因：向 MCP Server 请求工具列表失败。方案：检查 MCP Server 地址是否正确，服务是否可用。
1004010	MCP 调用工具失败	原因：调用 MCP 工具时发生错误。方案：检查 MCP Server 内部工具的实现逻辑。
1005001	TTS 实例化失败	原因：TTS 服务配置不正确或内部错误。方案：检查 TTSConfig 中的 Provider 和 ProviderParams 是否正确填写。
1005002	TTS 请求失败	原因：向 TTS 服务发送请求时失败。方案：检查网络连接。若问题持续，请联系技术支持。
1005003	TTS 响应读取失败	原因：从 TTS 服务接收响应时发生网络错误或超时。方案：检查网络稳定性。
1005004	TTS 响应处理失败	原因：TTS 服务返回的数据格式不符合预期。方案：如果使用自定义 TTS，请检查其返回格式是否符合协议。
1005005	TTS 建连失败	原因：无法与 TTS 服务建立连接。方案：1. 确认 TTS 服务已开通。 2. 检查 TTSConfig.ProviderParams 中的 appid、token 等鉴权信息是否正确且有效。 3. 检查网络防火墙策略。
1006001	数字人建联失败	原因：无法与数字人服务建立连接。方案：检查 AvatarConfig 中的 AvatarAppID、AvatarToken 等参数是否正确。
1006002	数字人服务内部错误	原因：数字人服务侧发生未知错误。方案：请联系技术支持。

最近更新时间：2026.09.23 16:19:10

这个页面对您有帮助吗？

有用

无用