错误码

LiMa 返回的错误分为两类：

1. OpenAI 兼容错误：HTTP 状态码 + error 对象
2. 设备业务错误：HTTP 状态码 + code / message 对象

HTTP 状态码

状态码	含义	常见场景
200	成功	请求正常完成
400	请求参数错误	JSON 格式、字段缺失或类型错误
401	未授权	API Key 缺失或无效
403	禁止访问	没有设备控制权限
404	资源不存在	任务或设备未找到
429	请求过多	触发速率限制
500	服务器内部错误	后端或模型异常
503	服务不可用	后端冷却或维护中

设备业务错误码

设备 App 与网关接口使用 code + message 返回业务错误：

错误码	HTTP	含义
0	200	成功
400	400	请求体不是合法 JSON 或不是 JSON 对象
4001	400	不支持的能力类型
4002	400	任务参数校验失败
4003	400	任务构建失败
4004	400	激活码无效或已过期
403	403	当前账户无权操作该设备
404	404	任务不存在
429	429	注册请求过于频繁

OpenAI 兼容错误示例

{
  "error": {
    "message": "Rate limit exceeded. Try again later.",
    "type": "rate_limit_error"
  }
}

设备业务错误示例

{
  "code": 4004,
  "message": "Invalid activation code"
}

排错建议

1. 先检查 HTTP 状态码和 Authorization Header
2. 再检查响应体中的 error.message 或 message
3. 对于 400 系列错误，核对请求体字段类型与示例
4. 对于 500/503 错误，查看 LiMa 管理后台日志或运维指标 /v1/ops/metrics