目标检测

POST 
/api/v5/detect/yolo

使用YOLO模型对图片进行目标检测，识别图片中的物体

Request

Header Parameters

Authorization stringrequired

用户个人令牌

application/json

Body

modelstringrequired
yolo11模型权重文件名称 (yolo11n.pt, yolo11s.pt, yolo11m.pt, yolo11l.pt, yolo11x.pt)
Example: yolo11n.pt
sourcestringrequired
待检测图片base64编码字符串
Example: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQXXXXXXX
imgszintegerrequired
输入图像的尺寸，有效范围是 32 - 1280 像素
Possible values: >= 32 and <= 1280
Example: 640
confnumberrequired
预测的置信度阈值，有效范围 0.01 - 1.0
Possible values: >= 0.01 and <= 1
Example: 0.5
iounumberrequired
交并比iou阈值，有效范围 0.0 - 0.95
Possible values: <= 0.95
Example: 0.45

Responses

200

Response Headers

application/json

Schema

Schema

images object[]required
检测结果图片列表
Array [
results object[]required
检测结果列表
Array [
box objectrequired
边界框坐标
x1numberrequired
左上角x坐标
Example: 14.55554
x2numberrequired
右下角x坐标
Example: 72.45978
y1numberrequired
左上角y坐标
Example: 116.72369
y2numberrequired
右下角y坐标
Example: 268.92963
classinteger
类别ID
Example: 0
confidencenumberrequired
置信度
Example: 0.83583
namestringrequired
类别名称
Example: person
]
shapeinteger[]required
图片尺寸 [width, height]
speed objectrequired
处理速度信息
inferencenumberrequired
推理时间(ms)
Example: 56.13449
postprocessnumberrequired
后处理时间(ms)
Example: 0.05426
preprocessnumberrequired
预处理时间(ms)
Example: 21.20275
]
metadata objectrequired
元数据信息
functionTimeAlivenumber
函数存活时间(ms)
Example: 163779.863
functionTimeCallnumber
函数调用时间(ms)
Example: 0.57
imageCountinteger
图片数量
Example: 1
modelstring
模型名称
Example: yolo11n-cls.pt
version objectrequired
版本信息
pythonstringrequired
Python版本
Example: 3.11.14
torchstring
PyTorch版本
Example: 2.9.1+cpu
torchvisionstring
torchvision版本
Example: 0.24.1+cpu
ultralyticsstringrequired
ultralytics版本
Example: 8.3.228

Example (auto)

{
  "images": [
    {
      "results": [
        {
          "box": {
            "x1": 14.55554,
            "x2": 72.45978,
            "y1": 116.72369,
            "y2": 268.92963
          },
          "class": 0,
          "confidence": 0.83583,
          "name": "person"
        }
      ],
      "shape": [
        0
      ],
      "speed": {
        "inference": 56.13449,
        "postprocess": 0.05426,
        "preprocess": 21.20275
      }
    }
  ],
  "metadata": {
    "functionTimeAlive": 163779.863,
    "functionTimeCall": 0.57,
    "imageCount": 1,
    "model": "yolo11n-cls.pt",
    "version": {
      "python": "3.11.14",
      "torch": "2.9.1+cpu",
      "torchvision": "0.24.1+cpu",
      "ultralytics": "8.3.228"
    }
  }
}

Example

{
  "images": [
    {
      "results": [
        {
          "box": {
            "x1": 1.511962890625,
            "x2": 263.31793212890625,
            "y1": 0.378143310546875,
            "y2": 200.42999267578125
          },
          "confidence": 0.6070891618728638,
          "name": "person"
        }
      ],
      "shape": [
        203,
        320
      ],
      "speed": {
        "inference": 235.26057600975037,
        "postprocess": 1.4520995318889618,
        "preprocess": 3.9573051035404205
      }
    }
  ],
  "metadata": {
    "version": {
      "python": "3.11.13",
      "ultralytics": "8.3.231"
    }
  }
}