API 错误码说明

{
  "error": {
    "message": "<英文错误描述>",
    "message_zh": "<中文错误描述>",
    "code": "<业务错误码>",
    "type": "<错误类型>",
    "source": "client | gateway | upstream",
    "upstream_code": "<上游错误码，仅上游错误时返回>",
    "upstream_status": "<上游 HTTP 状态码，仅上游错误时返回>",
    "request_id": "<请求唯一标识>"
  }
}

{
  "error": {
    "message": "The API Key does not exist or signature verification failed. Please check whether the API Key is correct. See: https://console.cloud.tencent.com/tokenhub/apikey",
    "message_zh": "API Key 不存在或签名校验失败，请检查 API Key 是否正确，查看链接：https://console.cloud.tencent.com/tokenhub/apikey",
    "code": "401002",
    "type": "gateway_error",
    "request_id": "7e6dc7d0-a8d7-4993-a74d-f6cd24b33925"
  }
}

{
  "error": {
    "message": "The request parameter messages is invalid or missing. Please check the value of this parameter.",
    "message_zh": "请求参数 messages 无效或缺失，请检查该参数取值是否正确。",
    "code": "400002",
    "type": "gateway_error",
    "request_id": "5fcdcb74-bd31-4bc6-b265-1389cea2d915"
  }
}

{
  "error": {
    "message": "The model or service ID gpt-9-turbo does not exist. Please check whether the service ID is correct. Service IDs are available in the Online Inference Service list in the console. See: https://cloud.tencent.com/document/product/1823/130079",
    "message_zh": "请求中的模型或服务 ID gpt-9-turbo 不存在，请检查服务 ID 是否正确。服务 ID 可在控制台的在线推理服务列表中查看，查看链接：https://cloud.tencent.com/document/product/1823/130079",
    "code": "400004",
    "type": "gateway_error",
    "request_id": "7a948a0f-740f-4d37-846f-0b500c3f1c48"
  }
}

{
  "error": {
    "message": "The request is invalid: temperature must be [0.0, 2.0]. Please check the request body, required fields, and request format.",
    "message_zh": "请求不合法：temperature must be [0.0, 2.0]，请检查请求体、必填字段及请求格式是否正确。",
    "code": "400001",
    "type": "invalid_request_error",
    "source": "client",
    "request_id": "d4924d12-a56f-4a51-94f4-dab3608dd6c4"
  }
}

{
  "error": {
    "code": 429001,
    "message": "The request rate exceeds the current model deepseek-v4-flash-202605 limit 60. Please reduce the request frequency or contact Tencent Cloud support to request a higher limit.",
    "message_zh": "请求速率超过当前模型 deepseek-v4-flash-202605 阈值 60，请降低访问频率或联系腾讯云售后申请更高限额。",
    "request_id": "req-16c2ae01"
  }
}

{
  "error": {
    "message": "The upstream model service is abnormal or unreachable. Please try again. If the issue persists, contact platform support for troubleshooting.",
    "message_zh": "上游模型服务异常或不可达，请重试。如多次失败，请联系平台售后协助排查。",
    "code": "502001",
    "type": "upstream_error",
    "source": "upstream",
    "upstream_status": 502,
    "request_id": "req-7d2c4a11"
  }
}

{
  "type": "error",
  "error": {
    "type": "<错误类型>",
    "message": "<错误描述>",
    "reqid": "<请求唯一标识>"
  }
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "The API Key does not exist or signature verification failed. Please check whether the API Key is correct. See: https://console.cloud.tencent.com/tokenhub/apikey",
    "reqid": "e556c76e-acf8-46ef-88f4-8395f3cd6ffc"
  }
}