YOLO-World

YOLO-World is a zero-shot object detection model that allows you to perform object detection without any training, just by describing the items you want to detect.

You can also run YOLO-World locally using Inference, our open-source inference server.

API Reference

The base URL for our hosted API is at https://infer.roboflow.com.

More information on using YOLO-World with Inference, through the Python SDK or the self-hosted API, see the YOLO-World Inference docs page.

YOLO-World inference.

Run the YOLO-World zero-shot object detection model.

post

/yolo_world/infer

Query parameters

api_keyApi Key

Roboflow API Key that will be passed to the model during initialization for artifact retrieval

Body

idIdrequired

api_keyApi Key

Roboflow API Key that will be passed to the model during initialization for artifact retrieval

usage_billableUsage Billable

startStart

sourceSource

source_infoSource Info

model_idModel Id

model_typeModel Type

The type of the model, usually referring to what task the model performs

imageImagerequired

disable_preproc_auto_orientDisable Preproc Auto Orient

If true, the auto orient preprocessing step is disabled for this call.

disable_preproc_contrastDisable Preproc Contrast

If true, the auto contrast preprocessing step is disabled for this call.

disable_preproc_grayscaleDisable Preproc Grayscale

If true, the grayscale preprocessing step is disabled for this call.

disable_preproc_static_cropDisable Preproc Static Crop

If true, the static crop preprocessing step is disabled for this call.

textTextrequired

A list of strings

yolo_world_version_idYolo World Version Id

confidenceConfidence

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/yolo_world/infer' \
  --header 'Content-Type: application/json' \
  --data '{"id":"text","usage_billable":true,"model_type":"object-detection","image":[{"type":"url","value":"http://www.example-image-url.com"}],"disable_preproc_auto_orient":false,"disable_preproc_contrast":false,"disable_preproc_grayscale":false,"disable_preproc_static_crop":false,"text":["person","dog","cat"],"yolo_world_version_id":"l","confidence":0.4}'

200

422

200

{
  "visualization": "text",
  "inference_id": "text",
  "frame_id": 1,
  "time": 1,
  "image": [
    {
      "width": 1,
      "height": 1
    }
  ],
  "predictions": [
    {
      "x": 1,
      "y": 1,
      "width": 1,
      "height": 1,
      "confidence": 1,
      "class": "text",
      "class_confidence": 1,
      "class_id": 1,
      "tracker_id": 1,
      "detection_id": "text",
      "parent_id": "text"
    }
  ]
}

Successful Response