イベントを送信

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

イベントを送信

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

• Workflow ブロック - Workflows のユーザーは、おそらく公式の Roboflow ブロックを使うのが最も簡単です

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

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

Workflow ブロック

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

この Roboflow Agent が設定をお手伝いします。Agent にモデルを実行する Workflow の作成を依頼すると、Vision Events ブロックが自動的に追加され、適切な ユースケース.

設定

1

Workflow エディタを開く

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

2

Vision Event ブロックを追加

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

3

入力を接続

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

4

ユースケースを設定

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

5

Workflow をデプロイ

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

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

REST API

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

認証

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

Authorization: Bearer YOUR_API_KEY

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

イベントを送信する前に、ユースケースを作成する必要があります。 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": "alksjdflaalsf32",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

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

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

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

エッジデバイスのバックアップには Deployment Manager が必要です。次を参照してください: Deployment Manager のドキュメント セットアップ手順について。

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

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

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

3. 有効化 Vision Events バックアップ デバイスの Event Store 設定

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

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

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