> 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/roboflow/roboflow-ko/datasets/adding-data.md).
# 이미지, 비디오, 주석 업로드
Roboflow에서 모델을 학습하고 배포하는 첫 단계는 Project에 데이터를 업로드하는 것입니다.
먼저, 다음이 필요합니다 [Project를 생성](/roboflow/roboflow-ko/datasets/create-a-project.md).
그러면 데이터를 업로드할 수 있는 웹 페이지로 이동합니다. 또한 프로젝트 사이드바에 있는 "Upload Data" 버튼에서 이 페이지에 접근할 수 있습니다.
## 데이터 추가 방법
다음 방법으로 Roboflow 계정에 데이터를 추가할 수 있습니다:
* 웹 애플리케이션 사용: 이미지가 1,000장 미만인 데이터셋에 권장됩니다.
* 명령줄 사용: 이미지가 1,000장 초과인 데이터셋에 권장됩니다.
* Dataset Upload Workflow Block 사용: 이미 운영 중인 모델이 있는 Workflows에서 데이터를 수집할 때 권장됩니다.
웹 애플리케이션과 명령줄에서 다음을 업로드할 수 있습니다:
* JPG, PNG, WEBP, AVIF, BMP, HEIC/HEIF 이미지.\*
* MOV 및 MP4 동영상.
* PDF 파일.
* [지원되는 모든 형식의 주석.](https://roboflow.com/formats)
\**최대 크기는 20MB, 16,400 x 10,900 픽셀입니다.*
주석은 연결된 이미지와 함께만 업로드할 수 있습니다. 이미 데이터셋에 가져온 이미지에 대한 주석은 업로드할 수 없습니다.
## 웹 애플리케이션으로 데이터 업로드
Project를 만들 때 또는 Upload Data 페이지에서 이미지, 동영상, 주석을 끌어다 놓을 수 있는 상자가 표시됩니다:
[40개 이상의 주석 형식을 지원합니다.](https://roboflow.com/formats) 지원되는 형식은 프로젝트 유형에 따라 다릅니다.
파일 이름 처리 방식
이미지 파일 이름을 표준화할 수 있도록 업로드/가져오기와 내보내기 과정 모두에서 클래스 이름을 정리합니다. 업로드 및 데이터셋 내보내기 시 다음 작업을 수행합니다:
* 앞뒤 공백 제거
* 모든 공백(줄바꿈 및 탭 포함)은 공백 하나로 변환됩니다
* 연속된 공백은 제거됩니다
* `/.[]#~*` 문자는 대시(-)로 대체됩니다 (`-`)
* `|'"` 문자는 제거됩니다
### 동영상 업로드
업로드된 동영상은 주석을 달 수 있는 개별 프레임으로 분해됩니다. 동영상을 업로드하면 내장 동영상 플레이어, 샘플링 슬라이더, 선택적 수동 프레임 선택 기능이 있는 추출 대화상자가 열립니다.
#### 샘플링 간격
슬라이더를 사용해 프레임을 샘플링하는 빈도를 설정하세요. 또한 슬라이더 아래의 입력란에 간격을 초 단위로 입력하거나 원하는 프레임 수를 직접 입력할 수 있습니다. 샘플링 범위는 초당 60프레임부터 60초마다 1프레임까지입니다.
#### 수동 프레임 선택
"Manual selection"을 클릭하여 프레임 선택 패널을 펼치세요. "Add current frame"을 사용하거나 다음 키를 누르세요 `M` 현재 재생 헤드 위치의 프레임을 선택합니다. 다음 키로 프레임을 하나씩 이동할 수 있습니다 `,` 및 `.`, 또는 다음 키로 선택된 프레임 사이를 이동할 수 있습니다 `Shift+Left` 및 `Shift+Right`.
샘플링된 프레임과 수동으로 선택된 프레임은 병합 및 중복 제거되며, 대화상자에는 추출할 전체 프레임 수가 실시간으로 표시됩니다.
#### 자르기
필름스트립의 자르기 핸들을 끌어 시작점과 끝점을 설정하세요. 잘라낸 범위 밖의 프레임은 제외됩니다.
"Extract N frames"를 클릭하여 동영상을 프레임으로 분할하고 데이터셋에 업로드하세요.
여러 동영상이 대기 중일 때는 동일한 간격 설정을 모두에 적용할 수 있습니다. 선택된 프레임은 동영상별로 적용되므로, 선택된 프레임이 있으면 각 동영상마다 별도의 대화상자가 열립니다.
지원되는 동영상 파일 형식
Roboflow는 브라우저에 내장된 동영상 파일 지원을 사용해 동영상을 프레임 이미지로 변환하고, 이를 모델 학습에 사용할 수 있게 합니다. 즉, 사용하는 브라우저에 따라 MOV 및 MP4 파일을 포함한 다양한 동영상 형식을 사용할 수 있습니다.
다음이 가능합니다 [브라우저가 지원하는 동영상 형식을 확인하기](https://caniuse.com/?search=video%20format).
예를 들어 HEVC/H.265로 인코딩된 MP4 파일은 Safari 브라우저에서만 지원됩니다. H.265로 촬영하는 GoPro나 iPhone에서 가져오는 경우, 더 널리 지원되는 H.264로 설정을 변경하는 것이 좋습니다.
동영상 파일을 Roboflow에 불러오는 데 문제가 있다면, 다음에 글을 남길 수 있습니다 [포럼](https://discuss.roboflow.com/) 또는 계정 담당자에게 문의하세요.
## 명령줄로 데이터셋 업로드
Roboflow Python 명령줄 인터페이스를 사용하여 더 큰 데이터셋을 업로드할 수 있습니다.
명령줄 인터페이스에서는 이미지만 업로드할 수 있습니다. 동영상이 있다면 다음이 필요합니다 [파일로 저장된 프레임으로 분할](https://superuser.com/questions/1044444/how-do-i-use-ffmpeg-to-split-a-video-into-images-and-then-reassemble-exactly-the). 그런 다음 이 파일들을 Roboflow에 업로드할 수 있습니다.
시작하려면 먼저 다음을 설치하세요 `roboflow-python`:
```
pip install roboflow
```
다음으로, [Workspace ID를 확인하세요](https://docs.roboflow.com/developer/rest-api/workspace-and-project-ids).
마지막으로, 다음 형식의 명령을 준비하세요:
```
roboflow import -w testupload -p project-1-8zgld /path/to/dataset/folder
```
지정해야 하는 인수는 다음과 같습니다:
* `-w testupload`: 이는 Workspace 이름입니다.
* `-p `: 이는 프로젝트 ID입니다.
명령을 실행하면 업로드 프로세스가 시작되었음을 나타내는 메시지가 표시됩니다. 그런 다음 이미지가 업로드되는 동안 로그를 볼 수 있습니다:
명령줄을 사용하여 데이터셋 업로드하기
명령줄에서 데이터를 업로드하는 방법을 보여주는 동영상 안내가 있습니다:
{% embed url="" %}
## 업로드한 데이터 보기
Roboflow에 업로드된 모든 데이터는 "batch" 단위로 업로드됩니다. 이러한 batch는 Project Annotate 페이지에서 확인할 수 있습니다:
## 이미지 크기 제한
이미지의 최대 크기는 20MB입니다
최대 픽셀 크기는 16,400 × 10,900 픽셀입니다.
## 중복 이미지
이미 Project에 있는 이미지를 업로드하려고 하면 해당 이미지의 업로드는 건너뜁니다.
{% hint style="info" %}
만약 [두 데이터셋을 병합하면](https://docs.roboflow.com/merge-datasets), 병합된 데이터셋과 두 원본 데이터셋이 모두 계정에 남아 있습니다. 따라서 이미지가 중복되므로 병합에 대한 요금은 청구되지 않습니다.
{% endhint %}
## 데이터 소유권
Roboflow에 업로드하는 모든 이미지와 동영상의 소유권은 귀하에게 있습니다. 이는 다음에 명시되어 있습니다 [Terms of Service의 23B 섹션](https://roboflow.com/terms):
> 귀하가 게시, 제출, 게시, 표시 또는 전송하는 모든 콘텐츠, 정보 또는 자료에 대한 모든 소유권은 귀하에게 있습니다
## 데이터 개인정보
**Public Plan:** Public plan을 사용 중인 경우, Roboflow에서 명시적으로 지정하고 별도 조치한 경우를 제외하면 데이터셋은 Roboflow Universe에 공개됩니다.
**유료 플랜(Enterprise 포함):** 별도로 명시되지 않는 한, 귀하의 데이터는 계정에만 비공개로 유지됩니다.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.roboflow.com/roboflow/roboflow-ko/datasets/adding-data.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.