> 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/download-a-dataset.md).

# データセットをダウンロード

## Web アプリ

{% hint style="info" %}
参照してください [Roboflow Universe データセットをダウンロードする](/datasets/ja/universe/universe/download-a-universe-dataset.md) Roboflow Universe からデータセットをダウンロードしたい場合は、ドキュメントを参照してください。
{% endhint %}

Roboflow からデータセットをダウンロードまたはエクスポートするには、まずプロジェクトのデータセットページに移動します。

<figure><img src="/files/0658c6bac357d5035ae3dcad1eebd63c09c7732b" alt="" width="165"><figcaption></figcaption></figure>

画像検索バーの右側にある［Export］をクリックします。

<figure><img src="/files/e7bb1f98a3ce31716db43ffc211628926199fea5" alt="" width="344"><figcaption></figcaption></figure>

データをどの形式でダウンロードするかを選べるモーダルが表示されます。Roboflow は [50 種類以上の異なるアノテーション形式](https://roboflow.com/formats).

データセットを zip ファイルとして直接ダウンロードすることも、データをローカルにダウンロードするためのコードスニペットを提供してもらうこともできます。

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

コードオプションを選ぶと、Python のコードスニペット、curl コマンド、またはデータセットへの直接ダウンロードリンクから選べます。

<figure><img src="/files/7d35f0bce2c8114c85aaf45bd1ea664657b24cb0" alt=""><figcaption></figcaption></figure>

### FAQ

<details>

<summary>なぜ zip 化した画像数が UI と一致しないのですか?</summary>

これには 2 つの可能性があります:

* それぞれのクラウドサービスで、画像のダウンロードにランダムな失敗が発生した。
* 画像が破損しているかサイズが大きすぎるため、いくつかのエラーが発生している。

当社のアプリケーションはエクスポート zip を 1 回だけ生成し、その後、同じ形式（例: COCO）が選択された場合は同じエクスポートを再ダウンロードします。ダウンロードで画像数がずれていることに気づいた場合は、いつでも新しいバージョンを作成して再ダウンロードできます。

\\

</details>

<details>

<summary>ダウンロードされた画像は元の品質ですか?</summary>

いいえ。学習の遅延を防ぐため、学習速度と十分なモデル性能に必要な解像度のバランスを保つレベルで画像を圧縮しています。

単一の元画像品質の画像をダウンロードしたい場合は、データセット内の画像をクリックして［Download Image］を選択してください。

複数の元画像品質の画像をダウンロードしたい場合は、当社の [CLI](#cli) または当社の [Image Search API](/datasets/ja/guan-li/manage-datasets/dataset-search.md#search-images-across-a-workspace).

</details>

## Python SDK

プロジェクトに生成済みのバージョンがある場合、対応するエクスポート形式で画像とアノテーションをダウンロードできます。使用して `Version.download()` 同期的な「取得して解凍」フローでは、 `Version.export()` を使用して、ダウンロードせずに Roboflow にエクスポートを非同期で（再）生成するよう依頼します。

### バージョンをダウンロードする

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace().project("my-detector")
version = project.version(3)

dataset = version.download(
    model_format="yolov8",      # または "voc", "coco", "darknet" など
    location="./my-detector-v3", # 任意、既定値は ./<project>-<version>
    overwrite=False,             # 任意、既存のディレクトリを再ダウンロードする場合は True に設定
)

print(dataset.location)  # ディスク上のパス
```

#### パラメータ

* `model_format` (str) - エクスポート形式。一般的な値: `yolov8`, `yolov11`, `voc`, `coco`, `darknet`, `tfrecord`, `createml`, `multiclass`。完全な一覧はプロジェクトタイプに依存します。無効な値を渡すと、エラーとして完全な一覧が返されます。
* `location` (str, optional) - 出力先ディレクトリ。既定値は `./<project-slug>-<version>`.
* `overwrite` (bool, default `False`) - 対象ディレクトリが既に存在していても再ダウンロードします。

返される `Dataset` オブジェクトには `.location` 展開済みディレクトリを指す属性があります。

### ダウンロードせずに新しいエクスポートを実行する

```python
ok = version.export(model_format="coco")
```

これにより、サーバー側でエクスポートの再生成が開始されます。生成が完了すると呼び出しは戻り、失敗した場合は `RuntimeError` を発生させます。その後、続けて `download()` が新しく生成された成果物を取得します。

### 公開 Universe データセット

公開 Universe プロジェクトをダウンロードするのにワークスペースのメンバーである必要はありません。API キーに Universe へのアクセス権があれば十分です:

```python
project = rf.workspace("roboflow-100").project("poker-cards-cxcvz")
project.version(1).download("yolov8", location="./poker-cards")
```

## CLI

プロジェクトに保存済みのバージョンがある場合は、コマンドラインを使ってそのバージョンの画像とアノテーションをダウンロードできます。

### コマンド

```bash
roboflow version download <workspace/project/version> -f <format> -l <location>
```

または短縮エイリアスを使用します:

```bash
roboflow download <workspace/project/version> -f <format> -l <location>
```

次のとおりです:

* `<format>` はサポートされているデータセット形式のいずれかです（ `voc`, `yolov8`, `coco`, `darknet`など）。 `roboflow version download --help` を実行すると、完全な一覧を確認できます。
* `<location>` はダウンロード先のローカルパスです（任意、既定値は現在のディレクトリ）
* データセット URL では [resource shorthand](https://docs.roboflow.com/reference/platform/cli#resource-shorthand): `workspace/project/version`, `project/version`を使うか、あるいは `-p project` とバージョン番号を指定します。

### 例

VOC 形式でデータセットのバージョンをダウンロード:

```bash
roboflow download -f voc -l ./my-dataset my-workspace/hand-gestures/1
```

プロジェクトの短縮表記を使ってダウンロード（既定のワークスペースを使用します）:

```bash
roboflow download -f yolov8 hand-gestures/1
```

から公開データセットをダウンロード [Roboflow Universe](https://universe.roboflow.com):

```bash
roboflow download -f coco joseph-nelson/chess-pieces-new/25
```

### JSON出力

スクリプトや自動化では `--json` を使って構造化された出力を取得します:

```bash
roboflow download hand-gestures/1 -f yolov8 --json
```

```json
{
  "workspace": "my-workspace",
  "project": "hand-gestures",
  "version": 1,
  "format": "yolov8",
  "location": "./hand-gestures-1"
}
```