API 返回码

2026-02-05

公共返回码

返回码	说明	处理建议
0	成功	-
100000000	请求头部中的 Host 错误。	请确认请求头部 Host 地址是否正确。
100000001	AppId 字段格式错误。	请填写正确的 AppId。
100000002	Timestamp 字段为空。	请填写 Timestamp。
100000003	Timestamp 字段格式错误。	请填写正确 Unix 时间戳（单位秒）。
100000004	签名过期。	请重新生成签名。
100000005	签名错误。	请确认生成签名的参数是否正确。
100000006	Action 为空。	请指定 Action。
100000007	不支持的 Action。	请填写正确的 Action。
100000008	SignatureNonce 字段为空。	请填写 SignatureNonce。
100000009	Signature 字段为空。	请填写 Signature。
100000010	获取 ServerSecret 失败。	请确认 AppId 是否正确。
100000011	获取 App 配置失败。	请确认 AppId 是否正确，或联系 ZEGO 技术支持处理。
100000012	读取 HTTP 包体失败。	请联系 ZEGO 技术支持处理。
100000013	SignatureVersion 字段为空。	请填写 SignatureVersion。
100000014	不支持的 SignatureVersion。	SignatureVersion 仅支持 2.0。
100000015	网关内部错误。	请联系 ZEGO 技术支持处理。
100000017	App 未开通该服务。	请联系 ZEGO 技术支持处理。

业务返回码

返回码	说明	处理建议
410000001	系统错误。	请联系 ZEGO 技术支持处理。
410000002	AppID 无效。	请检查 AppID 是否正确。
410000003	参数无效。	请依据 Message 提示，检查不合法的输入参数。
410000004	JSON 解析失败	请检查请求参数是否是合法的 JSON。
410000005	网关鉴权失败。	请联系 ZEGO 技术支持处理。
410000006	App 未开通该服务。	请联系 ZEGO 技术支持处理。
410000009	服务内部调用失败。	请联系 ZEGO 技术支持处理。
410000010	服务资源不足。	请联系 ZEGO 技术支持处理。
410000011	APP在线实例并发数量限制。	请检查并发是否达到限制，扩容请联系 ZEGO 技术支持处理。
410001002	未找到智能体实例。	请检查智能体实例是否已被删除。
410001003	智能体实例创建失败。	请联系 ZEGO 技术支持处理。
410001004	智能体实例修改失败。	请联系 ZEGO 技术支持处理。
410001005	智能体实例删除失败。	请联系 ZEGO 技术支持处理。
410001006	主动调用 LLM 失败。	请联系 ZEGO 技术支持处理。
410001007	主动调用 TTS 失败。	请联系 ZEGO 技术支持处理。
410001008	智能体已存在。	请勿重复创建
410001009	智能体未找到。	请检查是否已创建该智能体。
410001010	加载历史消息失败。	请联系 ZEGO 技术支持处理。
410001011	智能体实例更新失败。	请联系 ZEGO 技术支持处理。
410001016	用户不存在。	请检查用户是否已登录 Agent 实例所在房间。
410001013	智能体正在聆听。	智能体处于聆听状态时，不支持主动调用 LLM 或 TTS。
410001022	获取智能体实例上下文失败。	请联系 ZEGO 技术支持处理。
410001023	重置智能体实例上下文失败。	请联系 ZEGO 技术支持处理。
410001024	打断智能体实例失败。	请联系 ZEGO 技术支持处理。
410001025	数字人服务资源不足	请联系 ZEGO 技术支持处理。
410001026	数字人 ConfigId 不支持	请联系 ZEGO 技术支持确认该形象是否支持对应的 ConfigId。
410001027	数字人 DigitalHumanId 不正确。	请确认使用的 DigitalHumanId 是否正确。
410001028	数字人智能体实例创建失败。	请联系 ZEGO 技术支持处理。
410001029	数字人接口限频。	请联系 ZEGO 技术支持处理。
410001030	数字人流 ID 重复。	请检查数字人流 ID 是否重复。
410001031	数字人并发已达上限。	请检查数字人并发是否达到限制，扩容请联系 ZEGO 技术支持处理。
410001032	数字人服务系统错误。	请联系 ZEGO 技术支持处理。
410001033	LLM 测试账号已过期	请联系 ZEGO 技术支持处理。
410001034	TTS 测试账号已过期	请联系 ZEGO 技术支持处理。
410001035	App 测试账号已过期	请联系 ZEGO 技术支持处理。
410001041	Agent 实例正在处于优雅销毁状态	Agent 实例正在处于优雅销毁状态，不支持继续操作智能体实例。
410001042	Agent 实例的互动模式不是对讲机模式	Agent 实例的互动模式不是对讲机模式，禁止调用“开始/结束聆听”API。
410001043	API 请求携带的 Sequence 校验失败。	API 请求携带的 Sequence 落后，忽略处理该请求。
410001044	对讲机模式，开启聆听失败	请联系 ZEGO 技术支持处理。
410001045	对讲机模式，结束聆听失败	请联系 ZEGO 技术支持处理。
410001046	用户还没有开始推流	用户没有开始推流，对讲机模式，开启聆听失败