Events を送信する

デプロイ済みモデルから Vision Events を送信する 3 つの方法。

イベントを送信

Workflow ブロック、REST API、またはエッジデバイスのバックアップを使用して Vision Events を送信できます。

• Workflow ブロック - Workflows ユーザーは、公式の Roboflow ブロックを使うのが最も簡単だと感じるでしょう

• REST API - Workflows を使わずにモデルをデプロイするユーザーは、REST API を使用できます

• エッジデバイスのバックアップ - Roboflow Edge デバイスをデプロイするユーザーは、デバイス上のローカルイベントストアから自動バックアップを設定するのが最も便利です

Workflow ブロック

多くのユーザーに推奨される方法です。以下を追加します。 Vision Event ブロックを任意の Roboflow Workflow に追加すると、コード不要で推論結果からイベントを自動的に作成できます。

この Roboflow Agent が設定を代行できます。Agent にモデルを実行する Workflow の作成を依頼すると、Vision Events ブロックが自動的に追加され、適切な Use Case.

設定

1

Workflow Editor を開く

へ移動 Workflows で、イベントを追加したいワークフローを開きます。

2

Vision Event ブロックを追加する

ブロックカタログで「Vision Event」を検索し、ワークフローに追加します。

3

入力を接続する

画像入力とモデル予測の出力を Vision Event ブロックに接続します。

4

Use Case を設定する

Use Case 名（useCaseId）。また、上流のブロックからカスタムメタデータをマッピングすることもできます。Use Case を選択したら、下のドロップダウンの「Vision Events で開く」をクリックして、新しいタブでその Use Case のイベントページに移動します。

5

Workflow をデプロイする

ワークフローをデプロイまたは更新します。ワークフローが実行されるたびにイベントが自動的に作成されます。

Workflow ブロックは、画像のアップロードとイベント作成を 1 ステップで処理します。

REST API

Workflows を使用しないカスタム統合やパイプラインでは、REST API を使って直接イベントを送信できます。完全なリクエスト/レスポンスのスキーマについては、以下を参照してください。 Vision Events API リファレンス.

認証

すべての書き込みエンドポイントには、次のスコープを持つ API キーが必要です: visionEvents.write または device.update のスコープ。API キーは Bearer トークンとして渡します:

Authorization: Bearer YOUR_API_KEY

エンドツーエンドの例: 画像をアップロード + イベントを作成

イベントを送信する前に Use Case を作成する必要があります。イベントが参照する useCaseId 存在しないものは拒否されます。

API 経由でイベントを送信する場合、まず画像をアップロードし、その後アップロードした画像を参照するイベントを作成します。

ステップ 1: 画像をアップロードする

curl -X POST "https://api.roboflow.com/vision-events/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@inspection_photo.jpg"

レスポンス:

{
  "success": true,
  "sourceId": "abc123def456",
  "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg"
}

ステップ2: アップロードした画像を参照してイベントを作成します

curl -X POST "https://api.roboflow.com/vision-events" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "eventType": "quality_check",
    "useCaseId": "assembly-line-qa",
    "timestamp": "2026-03-30T14:30:00.000Z",
    "deviceId": "factory-cam-01",
    "streamId": "line-3",
    "images": [
      {
        "sourceId": "abc123def456",
        "objectDetections": [
          {
            "class": "defect",
            "x": 320,
            "y": 240,
            "width": 50,
            "height": 40,
            "confidence": 0.95
          }
        ]
      }
    ],
    "eventData": {
      "result": "fail"
    },
    "customMetadata": {
      "line_id": "line-3",
      "shift": "morning",
      "part_number": "PN-4421"
    }
  }'

レスポンス:

{
  "eventId": "evt-789ghi",
  "created": true
}

イベントを一括作成

batchエンドポイントを使用して、1回のリクエストで最大100件のイベントを送信できます:

curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "events": [
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

batchリクエストごとに最大100イベントです。

エッジデバイスのバックアップ

接続が断続的になる可能性があるエンタープライズ環境では、エッジデバイスがイベントをローカルに保存し、接続が復旧すると Roboflow に同期します。

Edge Device Backup には Deployment Manager が必要です。設定手順については、 Deployment Manager documentation をご覧ください。

Vision Events Backup を有効にするには:

1. 開く Deployment Manager を workspace 内で

2. 設定するデバイスを選択します

3. 有効にする Vision Events Backup デバイスの Event Store 設定で

4. イベントはデバイス上のローカル event store に書き込まれます

5. デバイスが再接続されると、イベントは自動的に Roboflow に同期されます

同期が完了すると、イベントは Vision Events ダッシュボードに表示されます。