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

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

## Web アプリ

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

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

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

### よくある質問

<details>

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

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

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

当社のアプリケーションはエクスポート zip を一度だけ生成し、同じ形式（例：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, オプション) - 保存先ディレクトリ。デフォルトは `./<project-slug>-<version>`.
* `overwrite` (bool、デフォルト `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>