> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/batch-create-vision-events.md).

# Vision Event 일괄 생성

한 번의 요청으로 최대 100개의 Vision Event를 기록하여 많은 관측값을 한꺼번에 수집합니다.

## 개요

이 엔드포인트는 여러 [비전 이벤트](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events.md) 를 단일 요청으로 한 번에 최대 100개까지 기록합니다. 배포 환경에서 많은 관측값을 한 번에 수집해야 할 때 사용하세요. 이벤트를 하나씩 생성하는 것보다 효율적입니다. 단일 이벤트를 기록하려면 [비전 이벤트 생성](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/create-a-vision-event.md).

## HTTP API

단일 요청으로 비전 이벤트를 최대 100개까지 생성합니다. 여러 이벤트를 한 번에 수집해야 할 때 이벤트를 하나씩 생성하는 것보다 효율적입니다.

**필수 범위:** `vision-events:write` 또는 `device:update`

{% openapi src="/files/07bb573a8b2a5a268b550bc4e2d87e5feae31c5d" path="/vision-events/batch" method="post" %}
[openapi.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% hint style="info" %}
이벤트에 이미지를 포함하려면 먼저 [비전 이벤트 이미지 업로드](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#http-api) 엔드포인트를 사용해 각 이미지를 업로드한 다음 반환된 `sourceId` 를 이미지 객체에서 참조하세요. 동영상도 같은 방식으로 처리합니다. 각 동영상을 다음 엔드포인트로 업로드하세요. [비전 이벤트 동영상 업로드](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md#http-api). [비전 이벤트 생성](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api) 에는 이미지 및 동영상 객체의 필드가 나와 있습니다.
{% endhint %}

각 이벤트는 단일 이벤트와 동일한 방식으로 유효성이 검사됩니다. 자세한 내용은 [유효성 검사 및 경고](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/create-a-vision-event.md#validation-and-warnings).

## Python SDK

단일 요청으로 여러 비전 이벤트를 생성합니다. 서버는 배치당 최대 100개의 이벤트를 허용합니다.

```python
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 목록
```

목록의 각 이벤트는 [단일 이벤트](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/create-a-vision-event.md#python-sdk)와 동일한 스키마를 따릅니다. 이벤트 스키마와 유효성 검사 동작에 대한 자세한 내용은 [REST API 참조](#http-api).
