> 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/deployment/ja/roboflow-cloud/batch-processing.md).

# バッチ処理

クラウドインフラを用いて、大量の画像や保存済み動画に対して Workflow を実行します。

## 概要

バッチ処理は、 [ワークフロー](https://docs.roboflow.com/workflows) を画像や保存済みの動画のバッチに対して実行する、費用対効果の高い方法です。大量のデータを非同期で処理するのに最適です。

バッチ処理では、大規模なバッチを実行するために必要なインフラストラクチャが自動的にプロビジョニングされます。

{% hint style="info" %}
バッチ処理は、Roboflowのクレジット制またはEnterpriseプランをご利用のすべてのワークスペースで利用できます。「バッチ処理」タブからジョブを開始するか、 [アセットライブラリ](https://docs.roboflow.com/platform/workspaces/asset-library).
{% endhint %}

バッチ処理ジョブは、RoboflowのウェブインターフェースまたはAPI（CLI経由）から設定できます。

ジョブを開始すると、データを処理するためのマシンがクラウド上にプロビジョニングされます。その後、データに対して実行するよう選択したワークフローの出力を含むJSONファイルが届きます。

ジョブはCPUまたはGPUマシンで実行されます。GPUジョブは高速ですが、コストが高くなります。詳しくは [クレジットのページ](https://roboflow.com/credits) CPUとGPUの料金についてです。ジョブの所要時間は、処理する画像や動画の数、Workflowの複雑さ、マシンの種類によって異なります。よくある問題については、 [トラブルシューティング](https://docs.roboflow.com/deployment/ja/roboflow-cloud/batch-processing/troubleshooting.md).

次の動画では、バッチ処理について詳しく説明します。

{% embed url="<https://www.youtube.com/watch?v=S7K2j2IeQrM>" %}

## Webアプリ

左側のサイドバーで「デプロイメント」を開き、「バッチ処理」タブを選択します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1193fa943b014f1b279c123ad5ccc88fac10f551%2FScreenshot%202025-05-19%20at%2012.14.51.png?alt=media" alt=""><figcaption></figcaption></figure>

「新しいバッチジョブ」をクリックし、次の手順に従います。

1. 次を選択します:  [Workflow](https://docs.roboflow.com/workflows).
2. 処理する画像または動画をアップロードします。
3. CPUまたはGPUのハードウェアを選択します。変更する必要がない限り、「詳細オプション」はデフォルトのままにします。
4. 「バッチジョブを作成」をクリックします。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-10667231b1e727c9344565e52171e0d1cb26b90c%2FScreenshot%202025-05-19%20at%2012.16.27.png?alt=media" alt=""><figcaption></figcaption></figure>

ジョブ一覧には、各ジョブの進行状況がリアルタイムで表示されます。このタブから開始したジョブは、アクティビティセンターにも表示されます。ここに表示されるのは自分だけです。ジョブをクリックすると詳細が開きます。「ソースと種類」には、ジョブの実行対象となった画像が表示されます。対象の画像は、 [アセットライブラリ](https://docs.roboflow.com/platform/workspaces/asset-library) で画像を選択した検索クエリと「アセットライブラリで開く」リンク、または手動で選択した画像の枚数で確認できます。

### アセットライブラリから

「 [アセットライブラリ](https://docs.roboflow.com/platform/workspaces/asset-library)」で画像を選択するか、検索条件に一致するすべての画像を選択してから、「ワークフローを実行」をクリックします。 [ワークフローの実行](https://docs.roboflow.com/platform/workspaces/asset-library#running-a-workflow) では、画像への結果の書き戻し方を含む一連の手順を説明しています。

### エージェントから

質問する [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) を使うと、Asset Library の画像（自分で選んだ画像、検索条件に一致する画像、またはライブラリ全体）に対して、公開済みの Workflow を実行できます。また、ジョブの状況を確認でき、ジョブが完了するとチャットで通知されます。Agent が開始したジョブは、Background Tasks にも表示されます。

Agent は、Batch Processing をチャットのタブとして開くこともできます。新しいジョブのフォームには、合意した Workflow と設定が Agent によって入力されますが、ファイルは自分でコンピューターから選択してください。

### データソースの同期時に自動実行

次のたびに [データソース](https://docs.roboflow.com/datasets/create-and-upload/adding-data/datasources) が同期されると、Batch Processing ジョブで、新たにインポートされた画像に対して Workflow を実行できます（例：タグや事前ラベルを最新の状態に保つ）。 [データソース](https://app.roboflow.com/settings/datasources) ページの「Workflow runs」セクションで、「Add workflow run」をクリックします。「Run when」で「On Sync」を選択し、実行のトリガーとなるデータソースを選びます。Workflow には次のものがちょうど1つ必要です `image` 入力。

{% hint style="info" %}
「Workflow runs」セクションが表示されない場合は、バッチ自動化を管理できるロールをWorkspace管理者に依頼してください。
{% endhint %}

結果を検索可能にする方法については、次を参照してください。 [結果をAsset Libraryに書き戻す](https://docs.roboflow.com/platform/workspaces/asset-library#writing-results-back-to-the-asset-library).

## HTTP API

**クイックリンク：**

* [データを取り込む](#ingest-data) （動画、単一画像、画像）
* [バッチのステータスを確認](#check-batch-status) （項目数、シャードの詳細）
* [ジョブを開始](#start-a-job)
* [ジョブの進行状況を監視](#monitor-job-progress) （ジョブのステータス、ステージ、タスク）
* [結果をエクスポート](#export-results) （出力パーツ、ダウンロードURL）
* [Webhook通知](#webhook-notifications)

### データを取り込む

#### 動画をアップロード

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/upload/video" method="post" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

#### 画像をアップロード

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/upload/image" method="post" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

#### 画像を一括アップロード

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/bulk-upload/image-files" method="post" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

### バッチのステータスを確認

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/count" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

#### シャードのアップロード詳細を確認

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/shards" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

### ジョブを開始

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/batch-processing/v1/external/{workspace}/jobs/{job\_id}" method="post" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

### ジョブの進行状況を監視

#### ジョブのステータスを取得

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/batch-processing/v1/external/{workspace}/jobs/{job\_id}" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

#### ジョブのステージを一覧表示

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/batch-processing/v1/external/{workspace}/jobs/{job\_id}/stages" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

#### ステージのタスクを一覧表示

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/batch-processing/v1/external/{workspace}/jobs/{job\_id}/stages/{stage\_id}/tasks" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

### 結果をエクスポート

#### 出力パーツを一覧表示

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/parts" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

#### ダウンロードURLを一覧表示

{% openapi src="/files/0625b474340498fdbe5abb9dd23cc6ceb0fd7eed" path="/data-staging/v1/external/{workspace}/batches/{batch\_id}/list" method="get" %}
[batch-processing.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c01faa8d2b7705ff92e611d69a086a8d11d1c26a%2Fbatch-processing.yaml?alt=media)
{% endopenapi %}

### Webhook通知

ステータスをポーリングする代わりに、Webhookを使うと、データの取り込みまたは処理が完了したときに通知を受け取れます。Webhookの設定とペイロード形式については、 [CLIの使用方法](#webhook-automation) をご覧ください。

## CLI

ローカルまたはクラウド上の画像や動画をステージングして処理するには、 `inference rf-cloud` を使用します。すでに [アセットライブラリ](https://docs.roboflow.com/platform/workspaces/asset-library)にある画像には、 `roboflow batch`.

### ローカルファイルとクラウドファイル

#### 設定

ローカルファイルまたはクラウドファイルを扱うには、Inference CLIをインストールします。

```bash
pip install inference-cli
export ROBOFLOW_API_KEY="YOUR-API-KEY-GOES-HERE"
```

クラウドストレージをサポートするには、次を実行します。

```bash
pip install 'inference-cli[cloud-storage]'
```

APIキーの確認方法については、 [認証ガイド](https://docs.roboflow.com/reference/authentication/authentication/find-your-roboflow-api-key).

#### データを取り込む

**画像**

```bash
inference rf-cloud data-staging create-batch-of-images \
  --images-dir <your-images-dir-path> \
  --batch-id <your-batch-id>
```

**動画**

```bash
inference rf-cloud data-staging create-batch-of-videos \
  --videos-dir <your-videos-dir-path> \
  --batch-id <your-batch-id>
```

{% hint style="info" %}
バッチIDには小文字を使用し、長さは最大64文字としてください。使用できる文字は、英字、数字、ハイフン（`-`）、アンダースコア（`_`).
{% endhint %}

**クラウドストレージ**

データがすでにクラウドストレージ（S3、Google Cloud Storage、Azure）にある場合は、ファイルをローカルにダウンロードせずに直接処理できます。

画像の場合：

```bash
inference rf-cloud data-staging create-batch-of-images \
  --data-source cloud-storage \
  --bucket-path <cloud-path> \
  --batch-id <your-batch-id>
```

動画の場合：

```bash
inference rf-cloud data-staging create-batch-of-videos \
  --data-source cloud-storage \
  --bucket-path <cloud-path> \
  --batch-id <your-batch-id>
```

この `--bucket-path` パラメータは、以下のプロバイダーをサポートしています。globパターンで取り込むファイルを絞り込めます。

<table data-search="false"><thead><tr><th>プロバイダー</th><th>パスの形式</th><th>globパターンの例</th></tr></thead><tbody><tr><td>S3</td><td><code>s3://bucket-name/path/</code></td><td><code>s3://my-bucket/training-data/**/*.jpg</code>：すべてのJPGファイルを再帰的に取得</td></tr><tr><td>Google Cloud Storage</td><td><code>gs://bucket-name/path/</code></td><td><code>gs://my-bucket/videos/2024-*/*.mp4</code>： <code>2024-*</code> フォルダー内のMP4ファイル</td></tr><tr><td>Azure Blob Storage</td><td><code>az://container-name/path/</code></td><td><code>az://container/images/*.png</code>：imagesフォルダー内のPNGファイル</td></tr></tbody></table>

{% hint style="info" %}
クラウドストレージの認証情報は、CLIが署名付きURLを生成するためにローカルでのみ使用されます。Roboflowのサーバーにアップロードされることはありません。
{% endhint %}

{% hint style="warning" %}
生成された署名付きURLの有効期間は24時間です。この期間内にバッチ処理ジョブが完了するようにしてください。
{% endhint %}

大規模なデータセットの場合、システムは画像を自動的に20,000ファイルずつのチャンクに分割します。動画は1,000件未満のバッチで処理することをおすすめします。

**署名付きURLによる取り込み**

高度な自動化には、ローカルファイルの代わりに署名付きURLを使用してデータを取り込めます。

<table data-search="false"><thead><tr><th>フラグ</th><th>説明</th></tr></thead><tbody><tr><td><code>--data-source references-file</code></td><td>署名付きURLで参照されるファイルを処理します。</td></tr><tr><td><code>--references &#x3C;path_or_url></code></td><td>ファイルのURLを含むJSONLファイルへのパス、またはそのようなファイルを指す署名付きURL。</td></tr></tbody></table>

参照ファイルの形式： `JSONL`:

```
{"name": "<unique-file-name-1>", "url": "https://<signed-url>"}
{"name": "<unique-file-name-2>", "url": "https://<signed-url>"}
```

{% hint style="info" %}
署名付きURLによる取り込みは、Enterpriseプランと以前のGrowthプランで利用できます。
{% endhint %}

#### ステージングされたデータを確認する

```bash
inference rf-cloud data-staging show-batch-details --batch-id <your-batch-id>
```

#### ジョブを開始

**画像を処理する**

```bash
inference rf-cloud batch-processing process-images-with-workflow \
  --workflow-id <workflow-id> \
  --batch-id <batch-id> \
  --machine-type gpu
```

**動画を処理する**

```bash
inference rf-cloud batch-processing process-videos-with-workflow \
  --workflow-id <workflow-id> \
  --batch-id <batch-id> \
  --machine-type gpu \
  --max-video-fps <your-desired-fps>
```

{% hint style="info" %}
Workflow IDを確認するには、Roboflow AppでWorkflow Editorを開き、「デプロイ」をクリックして、コードスニペット内の識別子を確認します。
{% endhint %}

{% hint style="info" %}
デフォルトでは、処理はCPUで実行されます。複数のモデルや大規模なモデルを使用するWorkflowでは、 `--machine-type gpu` を使用してください。
{% endhint %}

#### ジョブの進行状況を監視

startコマンドはジョブIDを出力します。これを使用してステータスを確認します。

```bash
inference rf-cloud batch-processing show-job-details --job-id <your-job-id>
```

#### 結果をエクスポート

ジョブの詳細には出力バッチ ID が含まれます。これを使用して結果をエクスポートします。

```bash
inference rf-cloud data-staging export-batch \
  --target-dir <dir-to-export-result> \
  --batch-id <output-batch-of-a-job>
```

#### Webhook による自動化

ステータスをポーリングする代わりに、Webhook を使用して、取り込みまたは処理の完了時に通知を受け取ることができます。

**データ取り込み Webhook**

CLI コマンド `create-batch-of-images` および `create-batch-of-videos` は、次のオプションに対応しています。

<table data-search="false"><thead><tr><th>フラグ</th><th>説明</th></tr></thead><tbody><tr><td><code>--notifications-url &#x3C;webhook_url></code></td><td>通知を送信する Webhook エンドポイント。</td></tr><tr><td><code>--notification-category ingest-status</code></td><td>取り込み処理全体のステータス。デフォルト。</td></tr><tr><td><code>--notification-category files-status</code></td><td>個々のファイルの処理ステータス。</td></tr></tbody></table>

通知は、次の内容を含む HTTP POST で送信されます。 `Authorization` ヘッダーには Roboflow Publishable Key が含まれます。

**取り込みステータス通知**

```json
{
    "type": "roboflow-data-staging-notification-v1",
    "event_id": "8c20f970-fe10-41e1-9ef2-e057c63c07ff",
    "ingest_id": "8cd48813430f2be70b492db67e07cc86",
    "batch_id": "test-batch-117",
    "shard_id": null,
    "notification": {
        "type": "ingest-status-notification-v1",
        "success": false,
        "error_details": {
            "type": "unsafe-url-detected",
            "reason": "Untrusted domain found: https://example.com/image.png"
        }
    },
    "delivery_attempt": 1
}
```

**ファイルステータス通知**

```json
{
    "type": "roboflow-data-staging-notification-v1",
    "event_id": "8f42708b-aeb7-4b73-9d83-cf18518b6d81",
    "ingest_id": "d5cb69aa-b2d1-4202-a1c1-0231f180bda9",
    "batch_id": "prod-batch-1",
    "shard_id": "0d40fa12-349e-439f-83f8-42b9b7987b33",
    "notification": {
        "type": "ingest-files-status-notification-v1",
        "success": true,
        "ingested_files": [
            "000000494869.jpg",
            "000000186042.jpg"
        ],
        "failed_files": [
            {
                "type": "file-size-limit-exceeded",
                "file_name": "big_image.png",
                "reason": "Max size of single image is 20971520B."
            }
        ],
        "content_truncated": false
    },
    "delivery_attempt": 1
}
```

**ジョブ完了 Webhook**

追加 `--notifications-url` ジョブの開始時に:

```bash
inference rf-cloud batch-processing process-images-with-workflow \
  --workflow-id <workflow-id> \
  --batch-id <batch-id> \
  --notifications-url <webhook_url>
```

**ジョブ完了通知**

```json
{
  "type": "roboflow-batch-job-notification-v1",
  "event_id": "8f42708b-aeb7-4b73-9d83-cf18518b6d81",
  "job_id": "<your-batch-job-id>",
  "job_state": "success | fail",
  "delivery_attempt": 1
}
```

#### クラウドストレージの認証

**AWS S3およびS3互換ストレージ**

認証情報は次の場所から自動的に検出されます:

1. 環境変数:

```bash
export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token  # Optional
```

2. AWS認証情報ファイル（`~/.aws/credentials`, `~/.aws/config`)
3. IAMロール（EC2、ECS、Lambda）

名前付きプロファイル:

```bash
export AWS_PROFILE=production
```

S3互換サービス（例: Cloudflare R2、MinIO）の場合:

```bash
export AWS_ENDPOINT_URL=https://account-id.r2.cloudflarestorage.com
export AWS_REGION=auto  # R2 requires region='auto'
export AWS_ACCESS_KEY_ID=your-r2-access-key
export AWS_SECRET_ACCESS_KEY=your-r2-secret-key
```

**Google Cloud Storage**

認証情報は次の場所から検出されます:

1. サービスアカウントキー ファイル（自動化に推奨）:

```bash
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
```

2. gcloud CLIのユーザー認証情報（`gcloud auth login`)
3. GCPメタデータサービス（Google Cloud Platform上で実行している場合）

**Azure Blob Storage**

SASトークン（推奨）:

```bash
export AZURE_STORAGE_ACCOUNT_NAME=mystorageaccount
export AZURE_STORAGE_SAS_TOKEN="YOUR_SAS_TOKEN"
```

アカウントキー:

```bash
export AZURE_STORAGE_ACCOUNT_NAME=mystorageaccount
export AZURE_STORAGE_ACCOUNT_KEY=your-account-key
```

Azure CLIでSASトークンを生成します。 `<expiry-utc>` を、将来のUTC時刻である `YYYY-MM-DDTHH:MMZ` 形式の値に置き換えます:

```bash
az storage container generate-sas \
  --account-name mystorageaccount \
  --name my-container \
  --permissions rl \
  --expiry <expiry-utc>
```

**カスタムスクリプト**

高度なユースケースでは、署名付きURLファイルを生成するスクリプトを参照してください:

* AWS S3: [generateS3SignedUrls.sh](https://raw.githubusercontent.com/roboflow/roboflow-python/main/scripts/generateS3SignedUrls.sh)
* Google Cloud Storage： [generateGCSSignedUrls.sh](https://raw.githubusercontent.com/roboflow/roboflow-python/main/scripts/generateGCSSignedUrls.sh)
* Azure Blob Storage： [generateAzureSasUrls.sh](https://raw.githubusercontent.com/roboflow/roboflow-python/main/scripts/generateAzureSasUrls.sh)

#### すべてのオプションを確認する

```bash
inference rf-cloud --help
inference rf-cloud data-staging --help
inference rf-cloud batch-processing --help
```

### アセットライブラリの画像

置き換える `<workspace-url>` をワークスペースのスラッグに置き換えます（例： `my-workspace`）。image `image` 入力を1つ持つ、公開済みのワークフローを選択します。他の必須入力にはデフォルト値を設定します。ただし、 `source_id`は、Batch Processingが各画像に設定するため対象外です。

Roboflow CLIをインストールまたは更新し、 [Roboflow CLI](https://docs.roboflow.com/reference/platform/cli)にサインインして、ワークフローの一覧を表示します：

```bash
pip install --upgrade roboflow
roboflow auth login
roboflow --workspace <workspace-url> --json workflow list
```

公開済みワークフローのJSON出力から `id` を使用します。処理する画像を、 [RoboQL](https://docs.roboflow.com/platform/workspaces/asset-library) 検索で見つけます：

```bash
roboflow --workspace <workspace-url> --json image search "tag:night-shift" \
  --fields id,filename
```

検索結果の画像IDを `--image-ids`:

```bash
roboflow --workspace <workspace-url> batch create \
  --workflow <workflow-id> \
  --image-ids <image-id-1>,<image-id-2>
```

構造化フィルターに一致するすべての画像を処理するには、 `--image-ids` を `--query "tag:night-shift"`に置き換えます。 `--all` を指定すると、アセットライブラリ全体が処理されます。選択オプションは必ず1つだけ指定してください。

作成レスポンスには、 `taskId`, `jobId`および `requestId`が含まれます。タスクIDを使って完了を待ち、ジョブIDを使ってジョブを確認します：

```bash
roboflow --workspace <workspace-url> asynctasks wait <task-id>
roboflow --workspace <workspace-url> batch status <job-id>
roboflow --workspace <workspace-url> batch list
```

{% hint style="info" %}
ターミナルを閉じたり、wait コマンドがタイムアウトしたりしても、ジョブは実行され続けます。ネットワークエラーが発生した場合は、同じオプションで再試行してください。重複したジョブの作成を避けるには、 `requestId` レスポンスまたはエラーのヒントに含まれる値を、次のように指定します。 `--request-id <request-id>` ジョブを停止するには
{% endhint %}

batch abort \<job-id> `を使用します。既存の設定で再試行するには、` batch restart \<job-id> `を使用します。` どちらのコマンドも確認を求めます。スクリプトでは、 `--yes` を追加してください。再起動するとクレジットを消費する場合があります。
