> 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 データセットのデータを自分のアカウントにコピーできます。

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

## Webアプリ

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

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

次に、「Use this Dataset」をクリックし、その後「Fork Project」ボタンをクリックします:

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

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

プロジェクトのコピーが完了すると、データセットを使用して Project Version を生成できるページに移動します:

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

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

## HTTP API

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

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

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

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

**リクエスト例**

```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"
}'
```

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

## MCP サーバー

AI エージェントを [MCP サーバー](https://docs.roboflow.com/agents/mcp-server) そして、次のツールを使って Universe データセットを Workspace にフォークできます:

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