> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/models/ja/supported-models/yolo-world.md).

# YOLO-World

YOLO-World はオープンボキャブラリーの物体検出モデルで、学習なしに任意のテキストクラス名から物体を検出します。私たちは、以下を通じて YOLO-World の推論をサポートしています: [サーバーレスホスト型 API](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api).

YOLO-World の実行の詳細については、以下を参照してください: [推論ドキュメント](https://docs.roboflow.com/deployment/self-hosted/self-hosted).

## コードサンプル

HTTP エンドポイントを直接使って YOLO-World を実行します。 `curl`、または以下を使って: [`inference-sdk`](https://docs.roboflow.com/reference/inference/inference-sdk) ラッパー。

{% tabs %}
{% tab title="HTTP（curl）" icon="webhook" %}
{% stepper %}
{% step %}

### API キーを取得する

Roboflow アカウントを作成し、以下でキーを見つけます: [Roboflow API 設定ページ](https://app.roboflow.com/settings/api) そして、それをシェルで利用できるようにします:

```bash
export ROBOFLOW_API_KEY="your-key-here"
```

{% endstep %}

{% step %}

### モデルを実行する

以下を呼び出します: `/yolo_world/infer` エンドポイントを `curl`:

```bash
curl --location 'https://serverless.roboflow.com/yolo_world/infer' \
  --header 'Content-Type: application/json' \
  --data '{
    "api_key": "'"$ROBOFLOW_API_KEY"'",
    "image": {"type": "url", "value": "https://media.roboflow.com/quickstart/traffic.jpg"},
    "text": ["car", "truck"],
    "yolo_world_version_id": "v2-s",
    "confidence": 0.05
  }'
```

{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="SDK（Python）" icon="python" %}
{% stepper %}
{% step %}

### API キーを取得する

Roboflow アカウントを作成し、以下でキーを見つけます: [Roboflow API 設定ページ](https://app.roboflow.com/settings/api) そして、それをシェルで利用できるようにします:

```bash
export ROBOFLOW_API_KEY="your-key-here"
```

{% endstep %}

{% step %}

### 依存関係をインストールする

SDK と [supervision](https://supervision.roboflow.com/):

```bash
pip install -U inference-sdk supervision
```

{% endstep %}

{% step %}

### モデルを実行する

カスタムクラス名で YOLO-World を実行し、その後 supervision で予測をデコードして可視化します。

```python
import os
import cv2
import supervision as sv
from inference_sdk import InferenceHTTPClient

image = sv.load_image_from_url("https://media.roboflow.com/quickstart/traffic.jpg")

client = InferenceHTTPClient(
    api_url="https://serverless.roboflow.com",
    api_key=os.environ["ROBOFLOW_API_KEY"],
)

results = client.infer_from_yolo_world(
    inference_input=image,
    class_names=["car", "truck"],
    model_version="v2-s",
    confidence=0.05,
)

detections = sv.Detections.from_inference(results[0])

labels = [
    f"{name} {conf:.2f}"
    for name, conf in zip(detections.data["class_name"], detections.confidence)
]
annotated = sv.BoxAnnotator().annotate(image.copy(), detections)
annotated = sv.LabelAnnotator().annotate(annotated, detections, labels=labels)
cv2.imwrite("annotated.png", annotated)
```

<figure><img src="/files/926228b5a1828397249ea518f38492080b3b622b" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

この `class_names` 引数は任意のクラス名リストを受け付けます。利用可能な `model_version` 値: `v2-s`, `v2-m`, `v2-l`, `v2-x`, `s`, `m`, `l`, `x`.

## 推論速度

レイテンシは以下で測定: [Roboflow Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted) 1x NVIDIA L4、バッチサイズ 1、ウォームアップ後の平均で測定。

<table data-search="false"><thead><tr><th>モデル</th><th>レイテンシ（ms）</th></tr></thead><tbody><tr><td><code>yolo-world</code></td><td>12.4</td></tr></tbody></table>

以下で測定: `v2-s` 2クラスのバリアント。クラスリストを設定するとテキストエンコーダーが1回実行されますが、各フレームごとに繰り返されないため、この図からは除外されています。

{% hint style="info" %}
設定する `api_url` をデプロイ先に合わせて設定します:

* `https://serverless.roboflow.com` Serverless Hosted API 用。
* `http://localhost:9001` ローカル [Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted) サーバー用。
* あなたの [専用デプロイメント](https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments) プライベートエンドポイントの URL。
  {% endhint %}

## Inference（セルフホスト）で使用

YOLO-World は、inference パッケージでプロセス内に読み込むか、ローカルの Inference サーバーで提供するかに関わらず、あなた自身のハードウェア上でも動作します。対応可能なハードウェア（たとえば V100 GPU）ではリアルタイムで動作するため、動画に適した実用的な選択肢になります。 [`inference`](https://docs.roboflow.com/deployment/self-hosted/self-hosted) パッケージ、またはローカル Inference サーバーで提供されます。対応可能なハードウェア（たとえば V100 GPU）ではリアルタイムで動作するため、動画に適した実用的な選択肢になります。

{% tabs %}
{% tab title="Inference（ネイティブ）" icon="server" %}

```bash
pip install "inference[yolo-world]" supervision
```

```python
import cv2
import supervision as sv

from inference.models.yolo_world.yolo_world import YOLOWorld

image = cv2.imread("image.jpeg")

model = YOLOWorld(model_id="yolo_world/l")
classes = ["person", "backpack", "dog"]
results = model.infer("image.jpeg", text=classes, confidence=0.03)[0]

detections = sv.Detections.from_inference(results)
labels = [classes[class_id] for class_id in detections.class_id]

annotated = sv.BoxAnnotator().annotate(scene=image, detections=detections)
annotated = sv.LabelAnnotator().annotate(
    scene=annotated, detections=detections, labels=labels
)
sv.plot_image(annotated)
```

{% endtab %}

{% tab title="ローカル Inference サーバー" icon="docker" %}

```bash
pip install inference inference-sdk
inference server start  # serves http://localhost:9001
```

```python
import os
from inference_sdk import InferenceHTTPClient

client = InferenceHTTPClient(
    api_url="http://127.0.0.1:9001",
    api_key=os.environ["ROBOFLOW_API_KEY"],
)

results = client.infer_from_yolo_world(
    inference_input=["https://media.roboflow.com/dog.jpeg"],
    class_names=["person", "backpack", "dog"],
    model_version="l",
    confidence=0.1,
)[0]
```

{% endtab %}

{% tab title="動画" icon="video" %}
YOLO-World ブロックを Workflow に追加し、検出したいクラスを設定します。その後、以下を使って、その Workflow にウェブカメラ、カメラフィード、または動画ファイルをストリームします: [Inference SDK WebRTC クライアント](https://docs.roboflow.com/workflows/deploy/video-processing).
{% endtab %}
{% endtabs %}

ネイティブパッケージでは、YOLO-World のチェックポイントは `yolo_world/<version>`として識別されます。ここで `<version>` は次のいずれかです: `s`, `m`, `l`, `x`, `v2-s`, `v2-m`, `v2-l`, `v2-x`。 `v2-` チェックポイントは新しく、評価指標でもより高いスコアを示します。

{% hint style="info" %}
多くのゼロショット検出器と同様に、YOLO-World は一般的な物体（車、人、犬）に最も強く、狭く細分化されたカテゴリでは弱くなります。シーンに合うものを見つけるために、プロンプトの文言を試してみてください。
{% endhint %}