> 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/manage-datasets/add-tags-to-images.md).

# 이미지에 태그 추가

Roboflow는 이미지 태깅 기능을 제공합니다. 이 기능을 사용하면 업로드 중에 이미지에 태그를 지정할 수 있습니다. 이러한 태그는 라벨링을 위한 일괄 할당에 사용할 수 있어, 이미지를 라벨링용으로 할당할 때 더 높은 정밀도를 제공합니다. 또한, 이미지 태그를 데이터셋과 연결된 Roboflow 데이터셋 검색의 매개변수로 사용할 수 있습니다.

### 업로드 중 태그 지정하기

웹 인터페이스와 [REST API 및 Python SDK](https://docs.roboflow.com/api-reference/images/upload-api)를 사용하여 데이터 업로드 중에 태그를 지정할 수 있습니다. 아래 이미지는 웹 인터페이스를 사용해 업로드한 이미지에 연결할 태그를 지정하는 방법을 보여줍니다:

<figure><img src="/files/e27a06c79a29f9744daac0c429b3de5cfda3eaf0" alt="Opening the Tag menu prior to image Upload"><figcaption><p>이미지 업로드 전에 Tag 메뉴 열기</p></figcaption></figure>

### CLI

다음을 사용하여 기존 이미지에 태그를 추가하거나 제거할 수 있습니다: `roboflow image metadata` 명령:

```bash
# 이미지에 태그 추가
roboflow image metadata <image_id> --tags "reviewed,v2"

# 이미지에서 태그 제거
roboflow image metadata <image_id> --remove-tags "draft,needs-review"

# 한 번의 호출로 태그 추가 및 제거
roboflow image metadata <image_id> --tags "approved" --remove-tags "pending"

# 여러 이미지의 태그를 일괄 업데이트
roboflow image metadata img1,img2,img3 --tags "processed" --poll
```

업로드 시 다음을 사용해 태그를 전달할 수도 있습니다: `roboflow image upload`:

```bash
roboflow image upload photo.jpg -p my-project --tag "review,v2"
```

### Images 탭에서 태그 적용하기

Images 탭에서 태그를 적용하려면 태그를 적용할 이미지들을 클릭한 다음, 페이지 오른쪽 상단의 "Images Selected" 버튼을 클릭하고 "Apply tags"를 클릭하세요. 이렇게 하면 선택한 이미지에 원하는 수의 태그를 추가할 수 있습니다.

<figure><img src="/files/0a4c821519b643fa0be5633929b8192f5bf84502" alt=""><figcaption><p>선택한 이미지에 태그 적용하기</p></figcaption></figure>

### Project 전체에서 태그 이름 바꾸기 또는 삭제하기

Project의 모든 이미지에서 태그 이름을 바꾸거나 삭제하려면 Project "Settings" 페이지에서 "Tags" 탭을 엽니다.

1. 체크박스 열을 사용해 수정할 태그를 선택합니다.
2. 도구 모음에서 "Rename" 또는 "Delete"를 클릭합니다.
3. 이름을 바꿀 경우 각 태그의 새 이름을 입력하고, "Review Changes"를 클릭한 다음 "Confirm Changes"를 클릭합니다.
4. 삭제할 경우 목록을 검토하고 확인합니다.

### 태그로 이미지 필터링하기

Roboflow 대시보드의 Assign 페이지에서 태그를 사용해 이미지를 필터링할 수 있습니다:

<figure><img src="/files/daf4cbb893190af377f5366b6172d36a99865374" alt="Filtering by Existing dataset Tags from within the Assign tool"><figcaption><p>Assign 도구에서 기존 dataset 태그로 필터링하기</p></figcaption></figure>

### Versions에서 데이터를 선별하는 데 Tags 사용하기

해당 [Filter by Tag](https://docs.roboflow.com/datasets/image-preprocessing#filter-by-tag) 전처리 단계에서는 특정 데이터를 포함하거나 제외하는 dataset Versions를 만들 수 있습니다. 이 전처리 단계를 사용하여 선별된 데이터의 일부만 학습하거나 내보낼 수 있습니다.

<figure><img src="/files/640efff5437e6f889b42a1e2fb631028e6aea1f1" alt=""><figcaption><p>"Filter by Tag" 전처리 단계를 사용해 특정 태그가 dataset version에 포함되도록 하거나 차단할 수 있습니다.</p></figcaption></figure>