> 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 のオープンボキャブラリ物体検出を Serverless Cloud API 経由で使用します

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).

## YOLO-World API

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' \
  --header "Authorization: Bearer $ROBOFLOW_API_KEY" \
  --data '{
    "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, InferenceConfiguration

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"],
).configure(InferenceConfiguration(api_key_transport="header"))

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="https://1194881119-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcmo9mhfIjYrvFFy1U7dk%2Fuploads%2Fgit-blob-a3e567c4ef81a613978ee2cc3fd4921f238fb24f%2Fyolo-world-detection.webp?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

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

## YOLO-World の推論速度

レイテンシの測定条件: [Roboflow Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted) 1 台の 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` サーバーレス・クラウド 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 を実行する

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" %}
Workflow に YOLO-World ブロックを追加し、検出したいクラスを設定します。その後、次を使って Web カメラ、カメラフィード、または動画ファイルをその 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 %}

## ライセンス

YOLO-World は GPL-3.0 の下で公開されています（Ultralytics 版は AGPL-3.0）。商用利用では次の意味があります:

* **Roboflow クラウドでは:** 無料プランを含むすべてのユーザーに商用ライセンスが含まれます。
* **自前ホストでは:** Enterprise ライセンスのアドオンが必要です。もしくは、同じライセンスの下でアプリケーションをオープンソース化する必要があります。

参照: [Roboflow の Ultralytics ライセンス](https://roboflow.com/ultralytics) 詳細をご覧ください。
