百度文心大模型平台SDK与API错误码详细解析及示例

一、SDK错误码详细解析及示例

1. 系统内部错误

• 错误码：1 Unknown error
  • 详细描述：这个错误表明服务器内部发生了一个未知的错误，可能由于系统内部的问题导致，与客户端请求无关。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "error_code": 1,
   
   
   
   

      "error_msg": "Unknown error occurred"
   
   
   
   

    }
   
   
  
  

• • 处理建议：由于这是一个服务器内部错误，客户端通常无法直接解决。建议记录错误信息，稍后重试请求，如果问题持续存在，应在百度云控制台提交工单反馈。
• 错误码：2 Service temporarily unavailable
  • 详细描述：这个错误表明服务当前暂时不可用，可能是由于服务器正在维护、升级或其他内部原因。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "error_code": 2,
   
   
   
   

      "error_msg": "Service temporarily unavailable"
   
   
   
   

    }
   
   
  
  

• • 处理建议：客户端应等待一段时间后重试请求。如果问题依旧存在，可以联系技术支持获取帮助。

2. 用户输入错误

• 错误码：336001 Invalid Argument
  • 详细描述：这个错误表示客户端提交的请求参数有误，可能是参数缺失、格式不正确或类型不匹配。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "error_code": 336001,
   
   
   
   

      "error_msg": "Invalid Argument: Missing required parameter 'text'"
   
   
   
   

    }
   
   
  
  

• • 处理建议：检查请求中的所有参数，确保所有必填项都已正确填写且格式符合要求。参考API文档，确认参数的名称、类型和数据结构无误。
• 错误码：336002 Invalid JSON
  • 详细描述：这个错误表示客户端提交的JSON格式不正确，可能是语法错误或结构不符合要求。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "error_code": 336002,
   
   
   
   

      "error_msg": "Invalid JSON: Unexpected token 'o' at position 1"
   
   
   
   

    }
   
   
  
  

• • 处理建议：使用JSON验证工具检查JSON字符串的语法正确性，确保符合JSON标准。如果使用了JSON库或框架，确保其版本与当前需求兼容。

3. 鉴权错误

• 错误码：110 Access token invalid or no longer valid
  • 详细描述：这个错误表明客户端提交的access_token无效或已过期，无法完成鉴权过程。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "error_code": 110,
   
   
   
   

      "error_msg": "Access token invalid or no longer valid"
   
   
   
   

    }
   
   
  
  

• • 处理建议：重新获取有效的access_token，并确保其在有效期内使用。检查IAM权限配置，确保客户端有权获取和使用有效的令牌。

4. 资源与配额限制

• 错误码：17 Open api daily request limit reached
  • 详细描述：这个错误表明客户端的免费接口每日请求量已达到上限，无法继续发送新的请求。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "error_code": 17,
   
   
   
   

      "error_msg": "Open api daily request limit reached"
   
   
   
   

    }
   
   
  
  

• • 处理建议：考虑升级到付费接口以解除请求限制，或者优化请求逻辑，减少不必要的请求调用。如果是测试环境，可以考虑等待请求限额自动重置。

二、API错误码详细解析及示例

1. HTTP状态码错误

• HTTP状态码：400 Bad Request
  • 详细描述：表示客户端请求有语法错误，服务器无法理解该请求。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "Code": "MalformedRequest",
   
   
   
   

      "Message": "The JSON request body could not be parsed correctly."
   
   
   
   

    }
   
   
  
  

• • 处理建议：检查请求的URL、Header和Body，确保所有部分都符合API要求。特别注意JSON格式的正确性和字段的完整性。
• HTTP状态码：403 Forbidden
  • 详细描述：表示服务器理解请求，但拒绝执行它，因为客户端没有足够的权限。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "Code": "AccessDenied",
   
   
   
   

      "Message": "You do not have permission to access this resource."
   
   
   
   

    }
   
   
  
  

• • 处理建议：检查IAM权限配置，确保请求使用的凭证具有访问该资源的权限。如果权限已配置正确，可能是其他安全策略阻止了请求的执行。

2. IAM认证相关错误

• 错误码：400 IAM Certification failed
  • 详细描述：表示IAM认证失败，可能是因为Access Key ID、Secret Access Key错误或签名验证失败。
  • 示例：

  
  

   
   

    {
   
   
   
   

      "Code": "IAMCertificationFailed",
   
   
   
   

      "Message": "Authentication failed due to invalid credentials."
   
   
   
   

    }
   
   
  
  

• • 处理建议：重新检查Access Key ID和Secret Access Key是否正确，确保签名过程符合API文档中的要求。如果是通过SDK或第三方库进行认证，确保库版本与API兼容。

3. 特定功能错误

• 示例：

  
  

   
   

    {
   
   
   
   

      "Code": "ModelNotSupported",
   
   
   
   

      "Message": "The requested operation is not supported by this model."
   
   
   
   

    }
   
   
  
  

• • 处理建议：根据错误消息调整请求参数或操作，确保它们与所选模型的功能和限制相匹配。如果问题依旧存在，可以查阅API文档或联系技术支持获取帮助。

三、总结