> 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データセットをダウンロードする](https://docs.roboflow.com/datasets/ja/universe/universe/download-a-universe-dataset.md) Roboflow Universeからデータセットをダウンロードしたい場合は、ドキュメントを参照してください。
{% endhint %}

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

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

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

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

モーダルが表示され、データをダウンロードする形式のオプションが表示されます。Roboflowは [50種類以上の注釈形式](https://roboflow.com/formats).

データセットをそのままZIPファイルとしてダウンロードするか、ローカルにデータをダウンロードするためのコードスニペットを受け取るかを選択することもできます。

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

コードオプションを選ぶと、コードは「Jupyter」（Python）および「Terminal」（CLI）タブにすぐ表示されます。実行すると、現在の検索条件に一致する画像を、選択した形式でエクスポートしてダウンロードできます。

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

### よくある質問

<details>

<summary>圧縮した画像の数がUIと一致しないのはなぜですか？</summary>

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

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

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

\\\\

</details>

<details>

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

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

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

元の品質の複数画像をダウンロードしたい場合は、次のものを使用することをおすすめします： [CLI](#cli) または [Image Search API](https://docs.roboflow.com/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は [リソースの短縮表記](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"
}
```

## MCPサーバー

AIエージェントを [MCPサーバー](https://docs.roboflow.com/agents/mcp-server) また、これらのツールを使ってデータセットのダウンロードを取得できます：

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>versions_export</code></td><td>バージョンのデータセットエクスポートを確認または開始します。</td></tr><tr><td><code>versions_get</code></td><td>分割と学習履歴を含むバージョン情報を取得します。</td></tr></tbody></table>
