Vision Events を一括作成

1 回のリクエストで最大 100 件の Vision Events を記録し、多数の観測を一度に取り込みます。

概要

このエンドポイントは複数の Vision Events を1回のリクエストで最大100件まで記録します。デプロイメントで多数の観測データを一度に取り込む必要がある場合に使用します。個別にイベントを作成するより効率的です。単一のイベントを記録するには、 Vision Event を作成.

HTTP API

1回のリクエストで最大100件のvisionイベントを作成できます。複数のイベントを一度に取り込む必要がある場合、個別にイベントを作成するより効率的です。

必要なスコープ: vision-events:write または device:update

Batch Create Vision Events

post

Create up to 100 vision events in a single request.

認可

Authorizationstring必須

Roboflow API key passed as a Bearer token.

本文

レスポンス

201

Events created successfully.

application/json

createdintegerオプション

eventIdsstring[]オプション

deprecationsstring[]オプション

400

Validation error.

application/json

403

Insufficient permissions for this resource.

application/json

post/vision-events/batch

POST /vision-events/batch HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 733

{
  "events": [
    {
      "eventId": "text",
      "eventType": "quality_check",
      "useCaseId": "text",
      "timestamp": "2026-08-12T11:33:35.555Z",
      "deviceId": "text",
      "streamId": "text",
      "workflowId": "text",
      "workflowVersion": "text",
      "images": [
        {
          "label": "text",
          "sourceId": "text",
          "inputSourceId": "text",
          "objectDetections": [
            {
              "class": "text",
              "x": 1,
              "y": 1,
              "width": 1,
              "height": 1,
              "confidence": 1
            }
          ],
          "classifications": [
            {
              "class": "text",
              "confidence": 1
            }
          ],
          "instanceSegmentations": [
            {
              "class": "text",
              "x": 1,
              "y": 1,
              "width": 1,
              "height": 1,
              "confidence": 1,
              "points": [
                [
                  1
                ]
              ]
            }
          ],
          "keypoints": [
            {
              "class": "text",
              "x": 1,
              "y": 1,
              "width": 1,
              "height": 1,
              "confidence": 1,
              "keypoints": [
                {
                  "id": 1,
                  "x": 1,
                  "y": 1,
                  "occluded": true
                }
              ]
            }
          ]
        }
      ],
      "displayImagePosition": 1,
      "eventData": {},
      "customMetadata": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

{
  "created": 1,
  "eventIds": [
    "text"
  ],
  "deprecations": [
    "text"
  ]
}

リクエスト例

curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "events": [
      {
        "eventId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:30:00Z",
        "eventData": {
          "result": "pass"
        }
      },
      {
        "eventId": "9c4d6a2e-81f3-4b7a-bc9e-3f1a2d4e5c6b",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:31:00Z",
        "eventData": {
          "result": "fail"
        }
      }
    ]
  }'

リクエストボディのパラメータ

イベント (配列、必須、最大100件): イベントオブジェクトの配列。各イベントは、次のものと同じスキーマに従います Vision Event を作成エンドポイントからクエリできます。

イベントに画像を含めるには、まず各画像を次のエンドポイントを使用してアップロードし、ビジョンイベント画像をアップロードエンドポイント、返された sourceId 画像オブジェクト内で参照します。詳細は画像オブジェクト詳細について。

レスポンス例

{
  "created": 2,
  "eventIds": ["f47ac10b-58cc-4372-a567-0e02b2c3d479", "9c4d6a2e-81f3-4b7a-bc9e-3f1a2d4e5c6b"]
}

{
  "error": "バッチサイズが最大100件のイベントを超えています"
}

{
  "error": "このリソースに対する権限が不十分です。"
}

レスポンスには、 warnings イベントごとの検証警告（イベントインデックスをキーとする）を含むオブジェクト、および deprecations 非推奨のフィールド名が使用されていた場合は配列。詳細は検証と警告詳細について。

Python SDK

1回のリクエストで複数のvisionイベントを作成できます。サーバーは1バッチあたり最大100件のイベントを許可します。

import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

result = ws.write_vision_events_batch([
    {
        "eventId": "e5f6a7b8-c3d4-4e5f-a0b1-c2d3e4f5a6b7",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:00:00Z",
        "eventData": {"result": "pass"},
    },
    {
        "eventId": "f6a7b8c9-d4e5-4f6a-b1c2-d3e4f5a6b7c8",
        "eventType": "quality_check",
        "useCaseId": "a1b3c8e1",
        "timestamp": "2024-01-15T10:01:00Z",
        "eventData": {"result": "fail"},
        "customMetadata": {"line": "A1"},
    },
])

print(result["created"])    # 作成されたイベント数
print(result["eventIds"])   # 作成されたイベントIDの一覧

リスト内の各イベントは、次のものと同じスキーマに従います単一のイベント。イベントスキーマと検証動作の完全な詳細については、 REST APIリファレンス.

前へ学習用画像を追加次へVision Event を作成

最終更新 14 日前

役に立ちましたか？