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

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

概要

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

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

Web アプリ

プロジェクトをフォーク

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

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

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

プロジェクトがコピーされると、データセットを使ってProject Versionを生成できるページに移動します：

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

HTTP API

から公開プロジェクトをフォークできます Roboflow Universe 次へのPOSTリクエストを送ることで、Workspaceに /:workspace/projects/fork エンドポイント。置き換えてください :workspace を、新しいプロジェクトを受け取る対象のWorkspaceに置き換えてください。

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

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

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

リクエスト例

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

ソースのプロジェクトスラッグを直接指定することもできます：

$ 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プロジェクトのスラッグ。urlが指定されていない場合は必須です。

レスポンス例

フォーク要求は次を返します 202 Accepted 非同期タスクIDとポーリング用URLが含まれます：

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

フォークの状態を確認

返されたものをポーリングするか、 urlまたは次を呼び出します GET /:workspace/asynctasks/:id を使って taskId フォーク応答から取得します：

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

レスポンス形式と非同期タスクのエラー挙動については、次を参照してください： 非同期タスク.

フォーク要求のエラー

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