> 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/datasets/ja/toappurdo/adding-data.md).

# 画像、動画、注釈をアップロードする

画像、動画、注釈を Roboflow にアップロードします。

Roboflowでモデルをトレーニングしてデプロイする最初のステップは、Projectにデータをアップロードすることです。

まず、 [Projectを作成](https://docs.roboflow.com/datasets/ja/toappurdo/create-a-project.md).

すると、データをアップロードできるウェブページが表示されます。このページは、プロジェクトのサイドバーにある「Upload Data」ボタンからも開けます。

## データを追加する方法

Roboflowアカウントには、次の方法でデータを追加できます。

* ウェブアプリケーションを使用する：画像が1,000枚未満のデータセットにおすすめです。
* コマンドラインを使用する：画像が1,000枚を超えるデータセットにおすすめです。
* Dataset Upload Workflow Blockを使用する：すでに本番環境で稼働しているモデルを使ってWorkflowsからデータを収集する場合におすすめです。

{% hint style="info" %}
画像がAWS S3、Google Cloud Storage、Azure Blob Storageなどのクラウドストレージにすでに保存されている場合は、アップロード用のスクリプトを書く代わりに、デフォルトの方法として [Datasources](https://docs.roboflow.com/datasets/ja/toappurdo/adding-data/datasources.md) とBucket Mirrorを使用してください。Datasourceを使うと、画像とメタデータが自動的にワークスペースにインポート、取り込み、同期されます。署名付きURLによるアップロードやローカルへのダウンロードは、1回限りまたは必要に応じたインポートにのみ使用してください。
{% endhint %}

ウェブアプリケーションとコマンドラインから、次のファイルをアップロードできます。

* JPG、PNG、WEBP、AVIF、BMP、HEIC/HEIF形式の画像。\*
* MOVおよびMP4形式の動画。
* PDFファイル。
* 次の [40以上の対応形式](https://roboflow.com/formats)のアノテーション。使用できる形式は、Projectの種類によって異なります。

\**最大サイズは30 MB、1辺あたり最大16,384ピクセル、総画素数は178,956,970ピクセル（約1億7,900万画素）です。*

アノテーションは、対応する画像と一緒にのみアップロードできます。データセットにすでにインポートされている画像のアノテーションはアップロードできません。

<details>

<summary>ファイル名の処理方法</summary>

Roboflowでは、アップロード、インポート、エクスポート時にクラス名を標準化します。

* 先頭と末尾の空白は削除されます。
* 改行やタブを含むすべての空白文字は、スペースに置き換えられます。
* 連続するスペースは削除されます。
* `/.[]#~*` 文字はダッシュ（`-`).
* `|'"` 文字は削除されます。

</details>

## ウェブアプリ

画像、動画、アノテーションをUpload Dataページ、またはProjectの作成時に表示されるアップロードボックスにドラッグ＆ドロップします。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-deb24c5aa34b10e1ccab8bec61e7f55ed2f8c273%2Fimage%20(426).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### カメラから撮影する

ウェブカメラ、またはウェブカメラとして使用するスマートフォンから画像や動画を追加するには、Upload Dataページで「Use Camera」をクリックし、カメラを選択します。「Photo」では1枚ずつ撮影できます。「Interval」では0.2～60秒ごとに1フレームを撮影し（最大1,000枚）、「Video」では最大300秒のMP4動画を録画できます。録画後、「Keep Video」をクリックします。次に追加ボタン（例：「Add 12 to Upload」、「Add Video to Upload」）をクリックして、撮影したデータをアップロードに追加します。画像ベースのProjectでは、動画を追加すると [抽出ダイアログ](#upload-video)が開きます。MP4を録画できないブラウザー（例：Firefox）では、動画モードを利用できません。

### Zipファイルをアップロードする

各 `.zip` ファイルは1つのファイルとしてアップロードされ、Roboflowのサーバー上で処理されます。ページにはまず、zipファイルの内容（画像、動画、アノテーションファイル、データ分割）が一覧表示されます。パスワード保護されている、破損している、画像が含まれていない、ファイル数が100,000を超えている、または圧縮後・展開後のサイズが8 GBを超えているzipファイルは受け付けられません。大きなzipファイルは小さく分割してください。

「Upload Zip」をクリックします。各zipファイルは個別のバッチになり、バッチ名を入力しない場合はzipファイル名が使われます。アップロードが完了するまでタブを開いたままにしてください。完了すると、各zipファイルのカードに進行状況と、追加、アノテーション済み、スキップされた件数が表示されます。「Open Annotation Job」または「Go to Annotate」をクリックすると、画像を確認できます。

デフォルトでは、Project内にすでにある画像のアノテーションは維持されます。置き換えるには、「Upload Zip」をクリックする前に「Replace annotations on images already in this project」にチェックを入れます。Classification Projectでは、ラベルが常に置き換えられます。

アーカイブにアノテーションが含まれている場合、同じzipファイルを再度アップロードしても、その画像はあなたに割り当てられた新しいアノテーションジョブに追加されます。 [Review Mode](https://docs.roboflow.com/datasets/ja/zhu-shi/zhu-shi/team-collaboration.md#review-mode) がオンの場合、レビュー担当者が承認するまでReviewに保留されます。オフの場合は、すぐにデータセットに追加されます。

### 動画をアップロードする

画像ベースのProjectでは、各動画がアノテーション対象のフレームに分割されます。Action Recognition Projectでは動画は分割されず、 [動画セグメント](https://docs.roboflow.com/datasets/ja/zhu-shi/zhu-shi/annotate-video-segments.md).

としてアクションをラベル付けできます。

動画は保存するまでアップロードキューに残ります。動画の行で「Preview Video」をクリックすると再生でき、「Extract Frames」をクリックすると抽出ダイアログが開きます。行の上にある「Extract Frames」をクリックすると、すべての動画に対して実行されます。抽出されたフレームは、保存時にアップロードされます。

保存すると、Roboflowは動画（最大3 GB）と抽出されたフレームを保持します。アップロードに画像も含まれている場合、動画は「Videos: 」にバッチ名を続けた名前の別バッチに保存されます。動画がそれより大きい場合や、ユーザーのロールで動画を保持できない場合、Roboflowは抽出されたフレームのみを保持します。ご利用のプランまたはProjectの種類が動画アノテーションに対応していない場合は、動画を追加すると抽出ダイアログが開きます。 `M` を押すと現在のフレームが追加されます。フィルムストリップのトリムハンドルをドラッグして、範囲外のフレームを除外できます。フレームを手動で選ぶには、「Manual selection」をクリックし、 `,` および `.` 1フレームずつ移動するには、 `Shift+Left` および `Shift+Right` を押すと、選択したフレーム間を移動できます。サンプリングされたフレームと選択したフレームは、重複を除いて統合されます。

複数の動画をキューに追加すると、すべてに同じ間隔を適用できます。選択したフレームは1本の動画に属するため、選択したフレームがある動画ごとに個別のダイアログが開きます。

プロジェクト内の動画からフレームを抽出するには、画像ブラウザーで動画を選択して「フレームを抽出」をクリックするか、動画を開いてプレビューから抽出します。データセットページで動画のみを表示するには、「種類」を「動画」に設定します。新しい動画は、データセットに追加されるまで、アノテーションページでそのバッチとともに保持されます。

<details>

<summary>対応している動画ファイル形式</summary>

Roboflowではブラウザーを使って動画をデコードするため、アップロードできる形式は [ブラウザーの動画対応状況](https://caniuse.com/?search=video%20format)によって異なります。ほとんどのブラウザーでMOVとMP4を使用できます。

ブラウザーで動画をデコードできない場合、Roboflowは「サポートされていない動画」エラーを表示します。よくある原因はHEVC/H.265です（DJIのドローン、GoPro、新しいスマートフォンで撮影した映像など）。この形式をデコードできるのはSafariのみです。動画をMP4（H.264）に変換して、もう一度アップロードしてください。

それでも動画を読み込めない場合は、 [フォーラム](https://discuss.roboflow.com/) に投稿するか、担当のアカウント担当者にお問い合わせください。

</details>

### 動画セグメントアノテーションをインポートする

アクション認識プロジェクトでは、各アクションが発生するタイミングを示すラベルをインポートできます。動画を含むフォルダーをドラッグして追加してください。各動画の隣には、その動画に対応する `_annotations.coco.json` ファイルを1つ配置します。

```
my_videos/
├── train/
│   ├── serve-01.mp4
│   └── _annotations.coco.json
└── valid/
    ├── serve-02.mp4
    └── _annotations.coco.json
```

各ファイルでは、 `info.format` を `roboflow-video-coco` に設定し、MP4またはMOV形式の動画を1本記述します。空間アノテーションとフレーム単位のアノテーションはスキップされ、zipアーカイブは受け付けられません。 `train`, `valid`または `test` という名前のフォルダーを使うと、その中の動画のデータセット分割が設定されます。それ以外の場合は、アップロード開始前に分割を選択します。

動画を再度インポートすると、そのセグメントは置き換えられます。ただし、すでにフレームアノテーションがある場合は、Roboflowはそちらを保持します。

## HTTP API

### 画像アップロードの審査状況を確認する

アップロード時に審査対象となった画像IDが返された場合、利用可能であると報告する前に、その判定結果を確認してください。審査中の画像は、引き続き保留状態です。審査に合格した画像、または墨消し処理された画像は、後から利用可能になる場合があります。却下または審査失敗となった画像はプロジェクトに追加されません。審査結果だけでは、その画像がデータセットで利用可能になったことは確認できません。

{% openapi src="/files/871d94afdd69722fa0b20585f008a8cecc6c224f" path="/{workspace}/images/{imageId}/screening" method="get" %}
[manage-images.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e79147570726f4d6b42c79beb72e2651a92dfd6d%2Fmanage-images.yaml?alt=media)
{% endopenapi %}

### 動画をアップロードする

最大3 GBのMP4またはMOV動画を、ワークスペースまたはアクション認識プロジェクトなどのプロジェクトにアップロードできます。アップロードは次の3つの手順で行います。

1. アップロードを準備します。次の値が取得できます。 `videoId`、 `signedUrl`、および `requiredHeaders`.
2. 動画ファイルを `PUT` リクエストで送信します。送信先は `signedUrl`。すべてのヘッダーは `requiredHeaders`に指定します。URLの有効期限は60分です。
3. ステータスが `status` が `uploaded` または `failed`.

アップロードのスクリーニングを有効にすると、スクリーニングで1秒あたり1フレームを確認している間、動画は `pending` の状態になります。フレームが拒否またはマスキングされた場合、ステータスは `failed` となり、動画は削除されます。音声とメタデータはスクリーニングされません。

省略可能な `batch`, `tag`, `metadata`および `split` フィールドは、画像のアップロード時と同じように機能します。同じ動画がすでにプロジェクトにある場合、Roboflowはそれを再利用します。動画は既存のバッチを維持し、指定したタグ、メタデータ、分割が適用されます。

{% openapi src="/files/9417dd9b22cd189c66ed7b470e987b9944d45144" path="/{workspace}/upload/video" method="post" %}
[video-upload.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e3c30ed3463097178da198e0cc20ac25f88d496c%2Fvideo-upload.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/9417dd9b22cd189c66ed7b470e987b9944d45144" path="/{workspace}/upload/video/{videoId}" method="get" %}
[video-upload.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e3c30ed3463097178da198e0cc20ac25f88d496c%2Fvideo-upload.yaml?alt=media)
{% endopenapi %}

アップロードした動画を見つけるには、 [データセットを検索](https://docs.roboflow.com/datasets/ja/guan-li/manage-datasets/dataset-search.md#http-api) します。 `mediaTypes` を `["video"]`.

## CLI

RoboflowのPythonコマンドラインインターフェースを使うと、より大きなデータセットをアップロードできます。

コマンドラインインターフェースでアップロードできるのは画像のみです。動画がある場合は、 [ファイルとして保存したフレームに分割する](https://superuser.com/questions/1044444/how-do-i-use-ffmpeg-to-split-a-video-into-images-and-then-reassemble-exactly-the)必要があります。これらのファイルをRoboflowにアップロードできます。

まず、 `roboflow-python`:

```
pip install roboflow
```

次に、 [ワークスペースIDを取得](https://docs.roboflow.com/reference/authentication/authentication/workspace-and-project-ids).

します。最後に、次の形式でコマンドを準備します。

```
roboflow import -w testupload -p project-1-8zgld /path/to/dataset/folder
```

指定する必要がある引数は次のとおりです。

* `-w testupload`：ワークスペース名です。
* `-p <project-id>`：プロジェクトIDです。

コマンドを実行すると、アップロード処理が開始したことを示すメッセージが表示されます。その後、画像のアップロード状況を示すログが表示されます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-cb3c6b1fff1fa6883a6fb226f8a3704493263a70%2FCleanShot%202024-03-13%20at%2011.29.09%402x.png?alt=media" alt=""><figcaption><p>コマンドラインを使ったデータセットのアップロード</p></figcaption></figure>

コマンドラインからデータをアップロードする方法を紹介する動画チュートリアルをご覧ください。

{% embed url="<https://www.loom.com/share/19637984033a466b831af56f9404fa89>" %}

### Zipファイルをアップロードする

大規模なデータセットの場合、個々のファイルの代わりに、画像とアノテーションをまとめた単一の `.zip` アーカイブをアップロードできます。アーカイブは一度アップロードされ、Roboflowのサーバー上で非同期に処理されます。ファイルを1つずつアップロードするよりも高速で信頼性に優れています。

次の `.zip` ファイルを直接アップロードします。

```bash
roboflow image upload dataset.zip --workspace <workspace> -p <project>
```

または、アップロード前にCLIでフォルダーをZIPに圧縮します。

```bash
roboflow image upload ./dataset/folder --zip-upload --workspace <workspace> -p <project>
```

デフォルトでは、処理が完了するまでコマンドは待機し、概要を出力します。 `--no-wait` を指定するとすぐに戻ります。この場合、CLIはアップロード状況の確認に使用できるタスクIDを出力します。

## Python SDK

次を使用して、 `Workspace.upload_dataset()` アーカイブ `.zip` をアップロードするか、アップロード前にフォルダーをZIPに圧縮します。

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

# .zip パスは自動的に検出され、アーカイブとしてアップロードされます
workspace.upload_dataset("dataset.zip", project_name="your-project")

# フォルダーの場合は、use_zip_upload を有効にして、1つのアーカイブに圧縮してアップロードします
workspace.upload_dataset("./dataset/folder", project_name="your-project", use_zip_upload=True)
```

{% hint style="info" %}
ZIPアップロードでは、最大8 GB、100,000ファイルまでのアーカイブをサポートします。予測（`is_prediction=True`）はZIPアップロードではサポートされていません。該当する場合は、画像ごとのアップロードを使用してください。
{% endhint %}

## MCPサーバー

AIエージェントを [MCPサーバー](https://docs.roboflow.com/agents/mcp-server) に接続すると、画像と任意のアノテーションファイルを含むZIPを追加できます。スクリーニングのために保留中の画像と、使用可能な画像は分けて報告してください。

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>image_upload</code></td><td>ZIP経由でローカルの画像ファイルをプロジェクトにアップロードします。</td></tr><tr><td><code>image_upload_status</code></td><td>スクリーニング保留中の画像も含め、ZIPの進捗状況と件数を確認します。</td></tr><tr><td><code>images_screening_status</code></td><td>保留中の画像IDについて、スクリーニング判定を確認します。</td></tr><tr><td><code>images_update_metadata</code></td><td>アップロード済み画像のメタデータとタグを更新します。</td></tr></tbody></table>

## アップロードしたデータを表示する

Roboflowにアップロードされたデータはすべて「バッチ」としてアップロードされます。これらのバッチは、プロジェクトの「Annotate」ページで確認できます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e02e3663f94fef52256a1528c2361066bcc4d89f%2FScreenshot%202025-05-20%20at%2008.04.10.png?alt=media" alt=""><figcaption></figcaption></figure>

## 画像サイズの制限

画像のサイズは最大30 MB、各辺は最大16,384ピクセル、総画素数は最大178,956,970ピクセル（約1億7,900万画素）です。Webアプリ、API、ZIPアップロード、データソースなど、すべてのアップロード方法で、これを超える画像は拒否されます。これらの制限が適用される前にアップロードされた画像は、引き続きプロジェクトに残ります。

## 重複画像

すでにプロジェクトにある画像をアップロードしようとした場合、その画像のアップロードはスキップされます。

プロジェクトから画像を削除しても、そのアノテーションは保持されます。その画像を再度アップロードすると、アノテーションと以前のアノテーション状態を保ったままプロジェクトに戻るため、アノテーション済みの画像が未アノテーションの状態に戻ることはありません。

{% hint style="info" %}
2つのデータセットを [マージした場合](https://docs.roboflow.com/datasets/ja/guan-li/merge-datasets.md)、マージ後のデータセットと2つの元のデータセットはすべてアカウントに残ります。画像が重複しているため、マージに料金はかかりません。
{% endhint %}

## データの所有権

Roboflowにアップロードしたすべての画像と動画の所有権は、引き続きお客様が保持します。これは、 [利用規約の第23B条](https://roboflow.com/terms):

> お客様は、投稿、提出、公開、表示、または送信するコンテンツ、情報、素材に関するすべての所有権を保持します

## データのプライバシー

プライベートプロジェクトはRoboflow Universeで公開されません。プロジェクトのプライバシーは [管理できます](https://docs.roboflow.com/datasets/ja/guan-li/make-a-project-public.md).
