Universe 데이터셋 포크

Fork Project 기능을 사용해 Universe 데이터셋의 데이터를 계정으로 복사할 수 있습니다.

소개

Fork Project 기능을 사용하여 Universe 데이터셋의 데이터를 계정으로 복사할 수 있습니다.

프로젝트를 포크하려면 Roboflow 계정에 로그인되어 있어야 합니다.

웹 앱

프로젝트 포크하기

먼저, 컴퓨터 비전 프로젝트에 사용하고 싶은 Universe의 데이터셋을 찾으세요.

다음으로, "Use this Dataset"을 클릭한 다음 "Fork Project" 버튼을 클릭하세요:

그러면 해당 데이터셋이 Roboflow Workspace로 복사됩니다.

프로젝트가 복사되면, 데이터셋을 사용해 Project Version을 생성할 수 있는 페이지로 이동합니다:

그런 다음 원하는 대로 프로젝트를 변경하거나, 데이터셋을 사용해 모델을 학습할 수 있습니다.

HTTP API

다음에서 공개 프로젝트를 포크할 수 있습니다. Roboflow Universe 를 Workspace로, 다음 POST 요청을 보내어 /:workspace/projects/fork 엔드포인트에. :workspace 를 새 Project를 받아야 하는 대상 Workspace로 바꾸세요.

포크 작업은 비동기적으로 실행됩니다. 포크 요청은 작업 ID와 폴링 URL을 반환합니다. 비동기 작업이 완료될 때까지 폴링한 다음, 작업 결과에서 포크된 Project 세부정보를 읽으세요.

포크하면 원본 이미지와 주석이 Workspace의 새 Project로 복사됩니다. 포크는 새 버전과 내보내기 설정으로 시작하므로, 자체 전처리 및 증강 옵션을 사용해 데이터셋 버전을 생성할 수 있습니다.

이 엔드포인트에는 다음이 포함된 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"
}'

원본 Project 슬러그를 직접 제공할 수도 있습니다:

$ 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에 Project를 포크할 충분한 크레딧 또는 이미지 할당량이 없습니다.
- 403 - 원본 Project가 공개되어 있지 않습니다.
- 404 - 원본 Project를 찾을 수 없거나, API 키에 필요한 범위가 없거나, API 키가 대상 Workspace에 속하지 않습니다.
- 409 - 대상 Workspace가 이미 원본 프로젝트를 소유하고 있습니다.
- 422 - 필수 매개변수가 누락되었거나 URL에 Project 슬러그가 포함되어 있지 않습니다.