# 画像、動画、アノテーションをアップロードする

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

まず、次の操作が必要です [Project を作成する](https://docs.roboflow.com/roboflow/roboflow-jp/datasets/create-a-project).

次に、データをアップロードできる Web ページに移動します。このページには、project のサイドバーにある「Upload Data」ボタンからもアクセスできます。

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

Roboflow アカウントにデータを追加する方法は次のとおりです。

* Web アプリケーションを使用する: 1,000 枚未満の画像を含むデータセットに推奨されます。
* コマンドラインを使用する: 1,000 枚を超える画像を含むデータセットに推奨されます。
* Dataset Upload Workflow Block を使用する: すでに本番運用中のモデルがある Workflows からデータを収集する場合に推奨されます。

Web アプリケーションとコマンドラインから、次をアップロードできます。

* JPG、PNG、WEBP、AVIF、BMP 画像。\*
* MOV および MP4 動画。
* PDF ファイル。
* [サポートされている任意の形式のアノテーション。](https://roboflow.com/formats)

\**最大サイズは 20MB、16,400 x 10,900 ピクセルです。*

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

## Web アプリケーションでデータをアップロードする

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

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

[40 種類以上のアノテーション形式がサポートされています。](https://roboflow.com/formats) サポートされる形式は、project の種類によって異なります。

<details>

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

画像ファイル名を標準化できるように、アップロード/インポート時とエクスポート時の両方でクラス名をサニタイズします。アップロード時とデータセットのエクスポート時には、次の処理を行います。

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

</details>

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

アップロードされた動画は、アノテーション可能な個別のフレームに分割されます。動画をアップロードすると、データセットで使用するためにどの頻度でフレームをサンプリングするかを選択できるウィンドウが開きます。

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

「Choose Frame Rate」をクリックすると、動画はフレームに分割されます。その後、これらのフレームがデータセットにアップロードされます。

データセットをアップロードすると、ラベリング用にデータを割り当てられるようになります。

それらを Web UI にドロップすると、ダイアログボックスが表示され、 **フレームレート**を選択するよう求められます。これにより、動画の 1 秒あたり何枚の画像をサンプリングするかが決まります。

* 選択できる最高フレームレートは 1 秒あたり 60 フレームで、アップロードした動画 1 秒ごとに 60 枚の画像が生成されます。
* 選択できる最低フレームレートは 60 秒あたり 1 フレームです。

動画からのサンプリング後、画像は最初から Roboflow に画像をアップロードしたかのように表示されます。

<details>

<summary>サポートされている動画ファイル形式</summary>

Roboflow は、ブラウザに組み込まれている動画ファイルのサポートを使用して、モデルのトレーニングに使えるフレーム画像へと動画を解析します。つまり、使用しているブラウザに応じて、MOV や MP4 ファイルを含む多くの異なる動画形式を使用できます。

次のことができます [ブラウザでサポートされている動画形式を確認する](https://caniuse.com/?search=video%20format).

たとえば、HEVC/H.265 でエンコードされた MP4 ファイルは Safari ブラウザでのみサポートされている点に注意してください。H.265 で撮影する GoPro や iPhone からインポートする場合は、より広くサポートされている H.264 に設定を変更するとよいでしょう。

動画ファイルを Roboflow に読み込めない場合は、 [forum](https://discuss.roboflow.com/) に投稿するか、アカウント担当者にお問い合わせください。

</details>

## コマンドラインでデータセットをアップロードする

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
```

次に、 [Workspace ID を取得する](https://docs.roboflow.com/developer/rest-api/workspace-and-project-ids).

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

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

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

* `-w testupload`: これは workspace 名です。
* `-p <project-id>`: これは project ID です。

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

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%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>" %}

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

Roboflow にアップロードされるすべてのデータは「batch」としてアップロードされます。これらの batch は Project Annotate ページで確認できます。

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

## 画像サイズの制限

画像の最大サイズは 20 MB です

最大ピクセル寸法は 16,400 × 10,900 ピクセルです。

## 重複画像

すでに Project 内にある画像をアップロードしようとすると、その画像のアップロードはスキップされます。

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

## データの所有権

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

> お客様が投稿、送信、公開、表示、または送信するあらゆるコンテンツ、情報、または資料に関するすべての所有権は、お客様に帰属します

## データプライバシー

**Public Plan:** Roboflow によって明示的に指定および取り決めされていない限り、Public plan をご利用の場合、データセットは Roboflow Universe 上で公開されます。

**有料プラン（Enterprise を含む）:** 別途指定がない限り、お客様のデータはお客様のアカウント内で非公開です。
