イベントを送信

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

イベントを送信

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

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

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

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

Workflowブロック

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

セットアップ

1

Workflow Editor を開く

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

2

Vision Event ブロックを追加

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

3

入力を接続

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

4

Use Case を設定

Use Case 名（useCaseId）を設定します。上流のブロックからカスタムメタデータをマッピングすることもできます。

5

Workflow をデプロイ

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

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

REST API

Workflows を使わないカスタム統合やパイプラインでは、REST 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
}

バッチでイベントを作成

バッチエンドポイントを使って、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": "assembly-line-qa",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "assembly-line-qa",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

1 回のバッチリクエストにつき最大 100 件のイベントです。

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

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

Edge Device Backup には Deployment Manager が必要です。セットアップ手順については Deployment Manager のドキュメントを参照してください。

Vision Events のバックアップを有効にするには:

1. 開く Deployment Manager をワークスペースで

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

3. 有効化 Vision Events Backup をデバイスの Event Store 設定で

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

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

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