错误码

所有 API 端点使用统一的错误响应格式。

错误响应格式

{
    "error": {
        "message": "人类可读的错误描述",
        "type": "error_type",
        "code": "ERROR_CODE",
        "param": null
    }
}

错误码一览

HTTP 状态码	type	说明
400	invalid_request_error	请求参数错误或缺失
401	authentication_error	API Key 缺失、无效或已撤销
403	insufficient_quota	月配额已用完
403	insufficient_scope	API Key 没有所需作用域
403	subscription_required	需要订阅付费智能体
404	not_found_error	智能体或资源不存在
405	invalid_request_error	请求方法不允许
429	rate_limit_error	请求频率超限，60秒后重试
500	server_error	服务器内部错误