汽车仪表盘里程识别 API

上传仪表盘照片，识别总里程（公里数）。

识别接口

POST/api/v1/odometer/recognize

Content-Type: multipart/form-data

请求参数

字段	类型	必填	说明
`file`	文件	是	仪表盘图片（JPG/PNG，≤10MB）
`crop_x`	float	否	裁剪左上角 X，范围 0~1
`crop_y`	float	否	裁剪左上角 Y，范围 0~1
`crop_w`	float	否	裁剪宽度，范围 0~1
`crop_h`	float	否	裁剪高度，范围 0~1
`enhance`	bool	否	图像增强，默认 `false`（低对比度照片可试）
`fast`	bool	否	快速模式，默认 `true`（自动裁剪图片下半部分）

快速模式开启时，裁剪参数无效，将自动裁切图片下半部分。

响应格式

所有响应均为 HTTP 200，JSON 格式固定如下：

{
  "success": true,
  "mileage_km": 125430.5,
  "confidence": 0.92,
  "message": null
}

成功：success 为 true，mileage_km 为识别里程，confidence 为置信度（0~1）。

失败：success 为 false，message 为错误说明，其余字段为 null。

请求示例

curl -X POST "http://127.0.0.1:8000/api/v1/odometer/recognize" \
  -F "file=@dashboard.jpg" \
  -F "fast=true"

curl -X POST "http://127.0.0.1:8000/api/v1/odometer/recognize" \
  -F "file=@dashboard.jpg" \
  -F "crop_x=0" \
  -F "crop_y=0.5" \
  -F "crop_w=1" \
  -F "crop_h=0.5" \
  -F "fast=false"

失败响应示例

{
  "success": false,
  "mileage_km": null,
  "confidence": null,
  "message": "未能从图片中识别出有效里程数，请提高照片清晰度后重试"
}