# 响应码和错误码 (/zh-CN/api-reference/speech-to-text/restful/api/response-code) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文列出了使用转录翻译 RESTful API 过程中可能遇到的错误码和状态码。若遇到其他错误,请[联系技术支持](https://ticket.shengwang.cn/)。 ### 响应状态码 [#响应状态码] 调用实时转录翻译 RESTful API 时,可能收到以下 HTTP 状态码: - `200` 表示请求成功。 - 非 `200` 表示请求失败。此时请检查响应 Body 中的 `message`、`code` 和 `reason` 字段以确定问题原因。`reason` 字段可能不存在。 ### 响应示例 [#响应示例] 请求失败时,可能收到以下响应: - 仅含 `message`: ```json # 401 Unauthorized # 仅 message 字段 { "message": "无效的认证凭据" } ``` - 仅含 `code` 和 `reason`: ```json # 400 Bad Request # 仅 code 和 reason 字段 { "code": 2, "reason": "Acquire:无效的 resourceExpiredHour 值!" } ``` ### 状态码 [#状态码] | 状态码 | 说明 | |:----|:------------| | `200` | 请求成功。调用 `acquire` 时请记录 `tokenName`;调用 `start` 时请记录 `taskId` 并将其与 `tokenName` 建立映射。 | | `201` | 服务已在运行中。请勿使用相同的 `tokenName` 重复发起 `start` 请求。 | | `206` | 语音转写过程中,频道内无用户发送音频流。 | | `400` | 请求语法错误导致服务器无法处理,或实时转录翻译服务未启用。 | | `401` | 未授权(客户 ID/客户密钥错误)。 | | `404` | 请求的资源不存在。 | | `409` | 任务已启动。 | | `500` | 服务器内部错误。 | | `504` | 内部通信错误。 | ### 错误信息与错误码 [#错误信息与错误码] #### 错误信息(Message) [#错误信息message] - `"产品名称与 builderToken 不匹配"`:获取的 `builderToken` 存在问题,请重新调用 `acquire`。 - `"resourceId 超出允许的时间间隔!"`:`builderToken` 在 5 分钟有效期内已过期。请确保在调用 `acquire` 后的 5 分钟内使用 `tokenName` 启动服务。任务创建成功后,请保存 `tokenName`,后续将用于调用 `query`、`update` 和 `stop`。 - `"无效的 App ID!"`:你的项目未启用实时转录翻译服务。请在控制台启用或联系 [Agora 技术支持](mailto:support@agora.io)。 - `"请求体格式校验失败,..."`:`start` 或 `update` 请求 Body 有误。`"..."` 部分描述了失败原因。通常由参数不匹配或超出范围引起,请重新检查请求 Body。 - `"taskId 与 builderToken 不匹配。"`:请检查 `taskId` 与 `tokenName` 不匹配的原因。 - `"未找到对应任务"`:任务已终止。 - `"任务已启动,当前状态为 STARTED,taskId 为 ..."`:任务已启动,请记录 `taskId` 并与 `tokenName` 建立映射。 #### 错误码(Error code) [#错误码error-code] - `1`:调用 `start` 时发生服务器内部错误。如需支持,请[联系技术支持](https://ticket.shengwang.cn/)。 - `2`:参数无效。可能原因: - 数据类型错误。 - 参数拼写错误(所有参数区分大小写)。 - 参数值超出允许范围。 - 缺少必需参数。 - `6`:调用 `start` 时发生服务器内部错误。如需支持,请[联系技术支持](https://ticket.shengwang.cn/)。 - `20`:处理超时。请采用退避策略在 3 秒和 6 秒后重试相同调用。 - `23`:调用 `start` 时发生服务器内部错误。如需支持,请[联系技术支持](https://ticket.shengwang.cn/)。 - `49`:使用相同 `tokenName` 重复调用 `start`,或使用相同 `tokenName` 和 `taskId` 重复调用 `stop`。 - `53`:`taskid` 与 `buildtoken` 不匹配。 - `62`:若在调用 `acquire` 时收到此错误,表示你的 App ID 未启用实时转录翻译服务。请在控制台启用,或[联系技术支持](https://ticket.shengwang.cn/);若在调用 `start` 时收到此错误,表示因网络问题导致服务未能启动。 - `404`:调用 `query` 或 `stop` 时任务已终止。 - `501`:调用 `start` 时发生服务器内部错误。声网建议你使用退避策略。例如,第一次等待 1 秒后重试、第二次等待 3 秒后重试、第三次等待 6 秒后重试。 - `502`:调用 `start` 时发生服务器内部错误。声网建议你使用退避策略。例如,第一次等待 1 秒后重试、第二次等待 3 秒后重试、第三次等待 6 秒后重试。 - `504`:调用 `start` 时发生服务器内部错误。声网建议你使用退避策略。例如,第一次等待 1 秒后重试、第二次等待 3 秒后重试、第三次等待 6 秒后重试。 - `1001`:解析 `tokenName` 失败,请调用 `acquire` 获取新的 `tokenName`。 - `1003`:App ID 或 `taskId` 与 `tokenName` 不匹配。请确保每个实时转录翻译任务中使用的 App ID 或 `taskId` 与 `tokenName` 匹配。 ### 注意事项 [#注意事项] - `resourceId` 和 `tokenName` 参数含义相同。某些情况下 `builderToken` 也指代 `tokenName`。 - 如遇到本文档未提及的错误,请[联系技术支持](https://ticket.shengwang.cn/)。