이벤트 전송

배포된 모델에서 Vision Events를 보내는 세 가지 방법입니다.

이벤트 전송

Workflow 블록, REST API 또는 엣지 디바이스 백업을 사용하여 Vision Event를 보낼 수 있습니다.

• 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 이름 설정 (useCaseId). 상위 블록의 사용자 지정 메타데이터도 매핑할 수 있습니다.

5

Workflow 배포

workflow를 배포하거나 업데이트합니다. Workflow가 실행될 때마다 이벤트가 자동으로 생성됩니다.

Workflow 블록은 이미지 업로드와 이벤트 생성을 한 번에 처리합니다.

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
}

배치 이벤트 생성

배치 엔드포인트를 사용하여 한 번의 요청으로 최대 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" }
      }
    ]
  }'

배치 요청당 최대 100개 이벤트입니다.

엣지 디바이스 백업

연결이 간헐적일 수 있는 엔터프라이즈 배포의 경우, 엣지 디바이스는 이벤트를 로컬에 저장하고 연결이 복구되면 Roboflow와 동기화합니다.

엣지 디바이스 백업에는 Deployment Manager가 필요합니다. 설정 방법은 Deployment Manager 문서를 참조하세요.

Vision Events 백업을 활성화하려면:

1. 열기 Deployment Manager 워크스페이스에서

2. 구성할 디바이스 선택

3. 활성화 Vision Events Backup 디바이스의 Event Store 구성에서

4. 이벤트는 디바이스의 로컬 이벤트 저장소에 기록됩니다

5. 디바이스가 다시 연결되면 이벤트가 Roboflow로 자동 동기화됩니다

동기화가 완료되면 이벤트가 Vision Events 대시보드에 표시됩니다.