错误码
更新时间：2025-01-09
错误码说明
本文主要介绍推理服务API V2对应的错误码及其错误描述。在调用API请求后，可以通过返回的错误码、错误信息及排查建议等进行问题排查。
错误码格式
若请求错误，服务器将以JSON格式返回错误信息，错误信息包含：
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 错误码 |
| message | String | 错误描述信息，帮助理解和解决发生的错误。 |
| type | String | 错误描述类型 |
{
"error":
{
"code":"malformed_json",
"message":"Invalid Argument",
"type":"invalid_request_error"
},
"id":"as-t2z8xi6mm8"
}错误码列表
| HTTP状态码 | 类型 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|---|
| 400 | invalid_request_error | malformed_json | Invalid Argument | 入参格式有误，不是标准json格式 |
| 400 | invalid_request_error | invalid_model | model is empty | 未指定model参数 |
| 400 | invalid_request_error | invalid_messages | 返回的具体错误信息 | message格式不符合规范，message中有详细说明 |
| 400 | invalid_request_error | characters_too_long | the max input characters is xxx | 请求长度不能超过最大字符限制，即用户输入大模型内容过长，可以尝试以下方法解决： · 适当缩短输入 · 也可以通过千帆SDK调用避免此问题，当输入内容过长时，SDK会自动截断输入 |
| 400 | invalid_request_error | tokens_too_long | Prompt tokens too long | 【用户输入错误】请求内容超过大模型内部限制，即用户输入大模型内容过长，可以尝试以下方法解决： · 适当缩短输入 · 也可以通过SDK调用避免此问题，当输入内容过长时，SDK会自动截断输入 |
| 400 | invalid_request_error | invalid_argument | 返回的具体错误信息 | 请参考返回的错误信息 |
| 400 | invalid_request_error | invalid_image_url | unable to retrieve the image via image_url | 图片url地址不合法 |
| 401 | access_denied | no_parameter_permission | 返回的具体错误信息 | 请参考返回的错误信息 |
| 401 | invalid_request_error | invalid_model | No permission to use the model | model鉴权失败，该用户没有使用这个model的权限 |
| 401 | invalid_request_error | invalid_appid | No permission to use the appid | appid鉴权失败，该用户没有使用这个appid的权限 |
| 401 | invalid_request_error | invalid_iam_token | IAM Certification failed | iam鉴权失败，bearer token无效或过期，或者请求的Authorization没加Bearer |
| 403 | unsafe_request | system_unsafe | the content of system field is invalid | system字段内容不安全 |
| 403 | unsafe_request | user_setting_unsafe | the content of user field is invalid | user_setting内容不合法 |
| 403 | unsafe_request | functions_unsafe | the content of functions field is invalid | function内容不合法 |
| 405 | invalid_request_error | method_not_supported | Only POST requests are accepted | 此接口只支持POST请求 |
| 429 | rate_limit_exceeded | rpm_rate_limit_exceeded | Rate limit reached for RPM | Cloud ID下RPM超限额，可以尝试以下方式解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果您需要提升更大的RPM/TPM配额，请在控制台上进行TPM/RPM配额的购买 · 如果仍未解决，请在百度云控制台内提交工单反馈 |
| 429 | rate_limit_exceeded | tpm_rate_limit_exceeded | Rate limit reached for TPM | Cloud ID下TPM超限额，可以尝试以下方式解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果您需要提升更大的RPM/TPM配额，请在控制台上进行TPM/RPM配额的购买 · 如果仍未解决，请在百度云控制台内提交工单反馈 |
| 429 | rate_limit_exceeded | preemptible_rate_limit_exceeded | Rate limit reached for preemptible resource | 混抢资源qps超限，包含可抢占接口、离线推理、离线评估请求 |
| 429 | rate_limit_exceeded | user_rate_limit_exceeded | qps request limit by APP ID reached | 【用户配额超限】QPS超限额，可以尝试通过以下方法解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果仍未解决，请在百度云控制台内提交工单反馈 |
| 429 | rate_limit_exceeded | cluster_rate_limit_exceeded | request limit by resouce cluster reached | 集群QPS超限额，请再次请求，如果持续出现此类错误，请在百度云控制台内提交工单反馈 |
| 429 | rate_limit_exceeded | cluster_rpm_rate_limit_exceeded | Rate limit reached for Cluster RPM | 集群RPM超限额，请在百度云控制台内提交工单反馈 |
| 429 | rate_limit_exceeded | cluster_tpm_rate_limit_exceeded | Rate limit reached for Cluster TPM | 集群TPM超限额，请在百度云控制台内提交工单反馈 |
| 500 | Internal_error | internal_error | Internal error | 【系统内部错误】服务内部错误，请稍后重试 |
| 500 | Internal_error | dispatch_internal_error | Internal error | 【系统内部错误】服务内部错误，请稍后重试 |