调用 MrKop One API 时，以下为平台返回的标准错误码及处理建议。
HTTP 状态码
错误类型
含义
处理方式
400
invalid_request请求格式错误（参数缺失、类型错误、上下文过长等）
检查请求体格式，对照 API 接入 文档修正
401
auth_errorAPI Key 无效、格式错误或已过期
在 Key 管理 页面检查 Key 是否正确，必要时重新生成
402
payment_required账户余额不足或套餐已用尽
购买套餐或前往 钱包 充值
403
access_denied账户被限制访问（违规终止、未在白名单等）
联系管理员处理
404
not_found请求的模型或资源不存在
检查
model 参数是否正确，参考 模型说明
429
rate_limit请求速率超限（并发数或 TPM 超限）
降低并发或请求频率，等待窗口恢复
429
quota_exhausted套餐配额或钱包余额用尽
购买套餐或充值钱包
500
server_error平台内部错误
稍后重试，持续出现请联系管理员
503
service_unavailable上游模型服务暂时不可用
稍后重试，系统会自动切换备用资源
平台使用 OpenAI 兼容的错误响应格式：
{
"error": {
"message": "错误描述信息",
"type": "auth_error",
"code": "invalid_api_key"
}
}
字段
说明
error.message人类可读的错误描述（中文） error.type错误分类，对应上表的"错误类型"列 error.code具体错误子码，用于程序化处理
HTTP/1.1 401 Unauthorized
{
"error": {
"message": "API Key 无效或已过期",
"type": "auth_error",
"code": "invalid_api_key"
}
}
原因：请求头 Authorization: Bearer sk-xxx 中的 Key 不正确或已被删除。
解决：在 Key 管理 页面确认 Key 状态，必要时新建 Key 并替换。
HTTP/1.1 429 Too Many Requests
{
"error": {
"message": "当前套餐配额已用尽，请购买套餐或充值钱包",
"type": "quota_exhausted",
"code": "quota_exhausted"
}
}
原因：订阅套餐额度用尽或钱包余额不足。
解决：
HTTP/1.1 429 Too Many Requests
{
"error": {
"message": "请求速率超限，请降低并发并稍后重试",
"type": "rate_limit",
"code": "rate_limit"
}
}
原因：同一 Key 的并发请求数超过限制。
解决：降低客户端并发数，或联系管理员提升限额。
HTTP/1.1 503 Service Unavailable
{
"error": {
"message": "上游模型服务暂时不可用，请稍后重试",
"type": "service_unavailable",
"code": "upstream_unavailable"
}
}
原因：底层 AI 供应商服务暂时不可用，平台已尝试所有可用出口 Key。
解决：等待片刻后重试，系统会自动恢复。
HTTP/1.1 400 Bad Request
{
"error": {
"message": "请求内容未通过安全审查",
"type": "content_filter",
"code": "content_filter"
}
}
原因：请求或生成内容触发了安全过滤策略。
解决：修改提示词内容后重试。