# 画像、動画、annotations をアップロード

Roboflow でモデルを学習・デプロイする最初のステップは、データを Project にアップロードすることです。

まず、 [Project を作成する](/roboflow/roboflow-jp/datasets/create-a-project.md).

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

## データの追加方法

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

* web application を使用する: 1,000 枚未満の画像を含む datasets に推奨。
* command line を使用する: 1,000 枚を超える画像を含む datasets に推奨。
* Dataset Upload Workflow Block を使用する: すでに production で稼働している model を持つ Workflows からデータを収集する場合に推奨。

web application と command line からは、以下をアップロードできます。

* JPG、PNG、WEBP、AVIF、BMP、HEIC/HEIF 画像。\*
* MOV と MP4 の動画。
* PDF ファイル。
* [サポートされている任意の形式の annotations。](https://roboflow.com/formats)

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

annotations は、関連する画像と一緒にのみアップロードできます。すでに dataset に取り込まれている画像の annotations をアップロードすることはできません。

## Web Application でデータをアップロードする

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

<figure><img src="/files/7ac9bdbedd4e924fdedaabe8f6731656700d2d33" alt="" width="563"><figcaption></figcaption></figure>

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

<details>

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

クラス名は、upload/import 時と export 時の両方でサニタイズされ、画像ファイル名を標準化できるようにしています。upload と dataset export では、次の処理を行います。

* 先頭・末尾の空白を削除
* すべての空白（改行やタブを含む）をスペースに変換
* 連続する 2 つのスペースを削除
* `/.[]#~*` 文字をダッシュ（`-`)
* `|'"` 文字を削除

</details>

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

アップロードされた動画は、注釈を付けられる個別のフレームに分割されます。動画をアップロードすると、dataset で使用するためにフレームをどの頻度でサンプリングするかを選べるウィンドウが開きます。

<figure><img src="/files/e1d196f9c2c85e0a588bc62b10523589409bc48f" alt=""><figcaption></figcaption></figure>

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

dataset のアップロードが完了すると、labeling 用にデータを割り当てられるようになります。

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

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

動画からサンプリングした後、画像は Roboflow に元から画像をアップロードした場合と同じように表示されます。

<details>

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

Roboflow は、ブラウザに組み込まれている動画ファイルのサポートを使用して、動画をフレーム画像に解析し、それを model の学習に利用できます。つまり、使用しているブラウザに応じて、MOV や MP4 ファイルを含む多くの動画形式を使用できます。

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

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

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

</details>

## Command Line で datasets をアップロードする

Roboflow Python command line interface を使って、より大きな datasets をアップロードできます。

command line interface では画像のみアップロードできます。動画がある場合は、 [フレームに分割してファイルとして保存する](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="/files/3e79da5898dce124a8b4bbf3921ffb7f4a5666a5" alt=""><figcaption><p>Command-line を使用して dataset をアップロードする</p></figcaption></figure>

command line からデータをアップロードする方法を示す動画ガイドがあります。

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

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

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

<figure><img src="/files/ac6e56e2fbfadf7a00126c3f1f504b867fdd627f" alt=""><figcaption></figcaption></figure>

## 画像サイズの制限

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

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

## 重複画像

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

{% hint style="info" %}
2 つの datasets を [merge する](https://docs.roboflow.com/merge-datasets)と、merge された dataset と元の 2 つの datasets はアカウント内に残ります。したがって、画像は重複しているため、merge に対して料金は発生しません。
{% endhint %}

## データの所有権

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

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

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

**Public Plan:** Public plan を利用している場合、Roboflow によって明示的に指定され手配されていない限り、あなたの datasets は Roboflow Universe 上で公開されます。

**Paid Plans（Enterprise を含む）:** 別段の指定がない限り、あなたのデータはアカウント内で非公開です。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-jp/datasets/adding-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
