错误码
更新时间：2025-08-08
整体概述
本文主要介绍百度AI搜索在使用过程中可能遇到的错误码及其描述。请求后，可通过返回的错误码、错误信息和说明等进行问题排查。因百度AI搜索中的大模型服务依赖于千帆ModelBuilder提供的模型服务，故部分错误码为ModelBuilder返回，此类错误需要到ModelBuilder进行解决。
错误码详情列表
千帆 AppBuilder错误码详情
| HTTP状态码 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
| 429 | RATE_LIMIT_TOTAL_QPS | Total API QPS limit exceeded | 请求超出每用户每秒总配额，请降低调用频率 |
| 429 | RATE_LIMIT_SEARCH_TOTAL_QPS | Total request rate for AI Search exceeded | 智能搜索服务超出每秒总配额，请降低调用频率 |
| 429 | RATE_LIMIT_SEARCH_QPS | AI Search QPS limit exceeded | 您的智能搜索服务请求频率超过了 QPS 限制，请降低调用频率或申请扩容 |
| 429 | QUOTA_USER_DAILY_REQUEST | Daily request quota per user for AI Search exceeded | 智能搜索服务每日请求的次数超出限额，申请扩容后可继续使用 |
| 429 | QUOTA_USER_DAILY_FREE | Daily free quota per user for AI Search exceeded | 您已使用完 100 次免费调用额度，未开通后付费功能，请先开通后付费再进行调用 |
| 429 | BILLING_INSUFFICIENT_BALANCE | Your account has insufficient balance | 您的账户已欠费无法继续使用该服务，请及时充值 |
千帆 ModelBuilder错误码详情
| 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 | 请求长度不能超过最大字符限制，即用户输入大模型内容过长，可以尝试以下方法解决： 1.适当缩短输入 2.也可以通过千帆SDK调用避免此问题，当输入内容过长时，SDK会自动截断输入 |
| 400 | invalid_request_error | tokens_too_long | Prompt tokens too long | 【用户输入错误】请求内容超过大模型内部限制，即用户输入大模型内容过长，可以尝试以下方法解决： 1.适当缩短输入 2.也可以通过SDK调用避免此问题，当输入内容过长时，SDK会自动截断输入 |
| 400 | invalid_request_error | invalid_argument | 返回的具体错误信息 | 请参考返回的错误信息 |
| 400 | invalid_request_error | invalid_image_genration_prompt | prompt is invalid, please check parameter | prompt不合法 |
| 400 | invalid_request_error | invalid_image_genration_refer_image | refer image is invalid, plsease check parameter | 传入的参考图不合法 |
| 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超限额，可以尝试以下方式解决： 1.适当控制请求频率，避免失败，请参考速率限制说明 2.通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 3.如果您需要提升更大的RPM/TPM配额，请在千帆ModelBuilder控制台上进行TPM/RPM配额的购买 4.如果仍未解决，请在百度云控制台内提交工单反馈 |
| 429 | rate_limit_exceeded | tpm_rate_limit_exceeded | Rate limit reached for TPM | Cloud ID下TPM超限额，可以尝试以下方式解决： 1.适当控制请求频率，避免失败，请参考速率限制说明 2.通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 3.如果您需要提升更大的RPM/TPM配额，请在千帆ModelBuilder控制台上进行TPM/RPM配额的购买 4.如果仍未解决，请在百度云控制台内提交工单反馈 |
| 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超限额，可以尝试通过以下方法解决： 1.适当控制请求频率，避免失败，请参考速率限制说明 2.通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 3.如果仍未解决，请在百度云控制台内提交工单反馈 |
| 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 | 【系统内部错误】服务内部错误，请稍后重试 |
| 500 | Internal_error | image_genration_interal_error | image generation service interal error | 文生图服务内部错误 |
| 500 | Internal_error | mrc_timeout | call model timeout 30s | 请求模型超时，请稍后再试 |