> 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/ja/to/vision-events/upload-a-vision-event-image.md).

# Vision Event 画像をアップロード

ワークスペースレベルの画像をアップロードし、Vision Event を作成するときにその sourceId を参照します。

## 概要

このエンドポイントは、 [ビジョンイベント](https://docs.roboflow.com/deployment/ja/to/vision-events.md)で使用する画像をワークスペースにアップロードします。アップロードはワークスペースレベルで行われ、特定のプロジェクトには紐付けられません。返された `sourceId` は、 `images` 配列で参照でき、 [イベントを作成](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md)するときに使用できます。モデルが処理した元のフレームや出力フレームを添付すると、イベントとともに表示できます。

## HTTP API

ビジョンイベントで使用する画像をアップロードします。これはワークスペースレベルのアップロードであり、特定のプロジェクトには関連付けられません。返された `sourceId` は、イベントの作成時に `images` 配列で参照できます。

**必須スコープ：** `vision-events:write` または `device:update`

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

返された `sourceId` を `images[].sourceId` に指定して、 [ビジョンイベントを作成します](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#http-api).

## Python SDK

ビジョンイベントで使用するローカル画像をアップロードします。返された `sourceId` は、イベントの作成時に `images` 配列で参照できます。

```python
import roboflow

roboflow.login()

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

# 画像をアップロード
result = ws.upload_vision_event_image("inspection-photo.jpg")
source_id = result["sourceId"]

# 必要に応じて名前とメタデータを指定することもできます
result = ws.upload_vision_event_image(
    "inspection-photo.jpg",
    name="line-a-check-001",
    metadata={"camera": "cam-1", "shift": "morning"},
)
```

レスポンスの `sourceId` は、 `images` 配列で、 [ビジョンイベントを作成する際に使用します](https://docs.roboflow.com/deployment/ja/to/vision-events/create-a-vision-event.md#python-sdk):

```python
ws.write_vision_event({
    "eventId": "d4e5f6a7-b2c3-4d4e-9f6a-7b8c9d0e1f2a",
    "eventType": "quality_check",
    "useCaseId": "a1b3c8e1",
    "timestamp": "2024-01-15T10:30:00Z",
    "images": [
        {
            "sourceId": source_id,
            "label": "inspection-photo",
            "objectDetections": [
                {"class": "defect", "x": 100, "y": 200, "width": 50, "height": 30, "confidence": 0.95}
            ],
        }
    ],
    "eventData": {"result": "fail"},
})
```

サポートされている画像形式とメタデータの制約については、 [REST APIリファレンスを参照してください](#http-api).
