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

# Universe データセットをフォークする

Fork Project 機能を使って、Universe データセットのデータを自分のアカウントにコピーできます。

## 概要

Fork Project 機能を使用すると、Universe データセットからアカウントにデータをコピーできます。

プロジェクトをフォークするには、Roboflow アカウントにログインしている必要があります。

## Web アプリ

### プロジェクトをフォーク

まず、コンピュータービジョンのプロジェクトで使用したい Universe 上のデータセットを見つけます。

次に、「このデータセットを使用」をクリックし、続いて「Fork Project」ボタンをクリックします:

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-04762a6e3921992b76b92f853c2612398715dab3%2Ffork-dataset.png?alt=media" alt=""><figcaption></figcaption></figure>

その後、データセットは Roboflow ワークスペースにコピーされます。

プロジェクトがコピーされると、データセットを使用してプロジェクトのバージョンを生成できるページに移動します:

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

その後、必要に応じてプロジェクトを変更したり、データセットを使ってモデルを学習したりできます。

## HTTP API

次の場所から公開プロジェクトをフォークできます [Roboflow Universe](https://universe.roboflow.com/) を、次の POST リクエストを送信してワークスペースに `/:workspace/projects/fork` に対して行います。置き換えてください `:workspace` を、新しいプロジェクトを受け取る対象のワークスペースに。

フォーク処理は非同期で実行されます。フォーク要求はタスク ID とポーリング URL を返します。非同期タスクが完了するまでポーリングし、完了後にタスク結果からフォークされたプロジェクトの詳細を読み取ります。

フォークすると、ソース画像とアノテーションがワークスペース内の新しいプロジェクトにコピーされます。フォークは新しいバージョンとエクスポート設定から開始されるため、自分で選んだ前処理や拡張設定を使ってデータセットのバージョンを生成できます。

このエンドポイントには、次の権限を持つ API キーが必要です。 `project:create` スコープ。

**リクエスト例**

```bash
$ curl --location "https://api.roboflow.com/my-workspace/projects/fork?api_key=$ROBOFLOW_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://universe.roboflow.com/roboflow-jvuqo/football-players-detection-3zvbc/browse?queryText=&pageSize=50&startingIndex=0&browseQuery=true"
}'
```

ソースのプロジェクト slug を直接指定することもできます:

```bash
$ curl --location "https://api.roboflow.com/my-workspace/projects/fork?api_key=$ROBOFLOW_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "source_project": "football-players-detection-3zvbc"
}'
```

**パラメータ**

```
- url (string) - Universe プロジェクトの完全な URL。source_project が指定されていない場合は必須です。URL には /browse などの追加パスやクエリパラメータを含めることができます。
- source_project (string) - ソースの Universe プロジェクト slug。url が指定されていない場合は必須です。
```

**レスポンス例**

フォーク要求は `202 Accepted` を、非同期タスク ID とポーリング URL 付きで返します:

```json
{
    "taskId": "abc123",
    "url": "https://api.roboflow.com/my-workspace/asynctasks/abc123"
}
```

**フォークのステータスを確認**

返された `url`をポーリングするか、 `GET /:workspace/asynctasks/:id` を `taskId` で呼び出します:

```bash
$ curl --location "https://api.roboflow.com/my-workspace/asynctasks/abc123?api_key=$ROBOFLOW_API_KEY"
```

レスポンス形式と非同期タスクのエラー動作については、 [Async Tasks](https://docs.roboflow.com/reference/platform/rest-api/async-tasks).

**フォーク要求のエラー**

```
- 402 - 対象のワークスペースに、プロジェクトをフォークするのに十分なクレジットまたは画像クォータがありません。
- 403 - ソースプロジェクトは公開されていません。
- 404 - ソースプロジェクトが見つからないか、API キーに必要なスコープがないか、API キーが対象ワークスペースに属していません。
- 409 - 対象ワークスペースはすでにソースプロジェクトを所有しています。
- 422 - 必須パラメータが不足しているか、URL にプロジェクト slug が含まれていません。
```

## Roboflow Agent

次の内容を [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) に依頼してください（例: 「ヘルメットを着用した作業者の画像50枚」）。必要なデータを見つけて Universe のデータセットを比較し、その後、データセット全体を新しいプロジェクトにコピーするか、選択したプロジェクトに指定枚数の画像をコピーします。複数のデータセットの画像を同じプロジェクトに入れることもできます。ソースデータセットは変更されません。

Agent は、コピー後にクラス名の変更や削除もできます。この変更は、新しく追加された画像だけでなく、プロジェクト内のすべての画像に適用されます。

## MCP Server

AI エージェントを [MCP Server](https://docs.roboflow.com/agents/mcp-server) に接続すると、次のツールを使って Universe データセットをワークスペースにフォークできます:

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>projects_fork</code></td><td>公開されている Universe プロジェクトの非同期フォークをワークスペースにキューします。</td></tr><tr><td><code>async_tasks_get</code></td><td>フォークタスクが完了するまでポーリングします。</td></tr></tbody></table>