响应状态码

在调用声网对话式 AI 引擎 RESTful API 过程中，你可能收到如下 HTTP 状态码：

• 如果状态码为 200 表示请求成功。

• 如果状态码不为 200，则请求失败。响应 Body 中包含 detail 或 reason 字段，用于描述失败的具体原因。

例如，当请求参数异常导致返回 400 时，你可能收到如下响应：

JSON

{
    "detail": "create agent failed, code: 400, msg: properties: channel not found",
    "reason": "InvalidRequest"
}

下面展示请求失败时所有可能的 HTTP 响应状态码、描述和建议措施：

响应状态码	描述	建议措施
400	请求参数异常	针对 detail 字段提示进行检查。
401	认证失败	检查 Authorization 请求头、凭证或 token 后重试。
403	当前账号不允许使用该服务	解决账号或计费问题，或联系技术支持开通服务。
404	Agent 未找到或者已经销毁	确认任务是否启动成功或者已经退出。
409	Agent 冲突	使用服务返回的任务信息继续后续操作，或改用其他智能体名称重试。
422	访问超限	联系技术支持提升配额。
429	请求频率超限	使用退避策略重试。
500	服务器内部错误	如果问题持续存在，请联系技术支持。
502	网关异常	联系技术支持。
503	Agent 启动错误	使用退避策略重试。
504	请求超时	使用退避策略重试。

下面展示请求失败时所有可能的 reason 值和描述，可结合状态码与 detail 字段排查问题：

reason	描述
ServiceNotEnabled	当前项目未启用该服务。
AccountSuspended	账号已被停用，无法使用该服务。
InternalError	服务端内部错误。
InvalidPermission	未开通服务。
InvalidRequestBody	请求 Body 不是合法的 JSON。
MissingRequiredField	请求中缺少必填字段。
InvalidFieldValue	请求字段存在非法取值。
ResourceQuotaLimitExceeded	并发请求过多，超出配额限制。
ConcurrencyLimitExceeded	并发请求过多，超出配额限制。
ServiceUnavailable	服务暂时不可用。
ResourceAllocationFailed	当前无法分配所需资源，请求暂时无法完成。
TaskConflict	已存在同名智能体，或当前已有冲突中的任务在执行。
TaskNotFound	并未成功启动智能体、或者启动智能体后中途退出、或者已经销毁智能体。
TaskOperationTimeout	服务端内部错误。
NotImplemented	服务端内部错误。