> 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/deployment/ko/self-hosted/sdks/lens-studio.md).

# Lens Studio

Snap Lens 제작에 사용하기 위해 모델을 Lens Studio에 배포합니다.

{% hint style="warning" %}
**2026년 2월부터 Lens Studio 배포가 더 이상 지원되지 않습니다.** 이 페이지는 참고용으로만 보관됩니다. 모델을 배포하려면 Roboflow의 다음 [지원되는 배포 옵션](https://docs.roboflow.com/deployment/ko/readme.md).
{% endhint %}

Roboflow에서 학습된 모델을 준비했다면 SnapML에 배포할 수 있습니다.

{% hint style="warning" %}
새로 학습한 모델에는 Snap AR 내보내기 가중치가 더 이상 생성되지 않습니다. 2026년 2월 25일 이전에 학습한 모델 버전에만 Lens Studio에 필요한 가중치가 포함되어 있습니다. 프로젝트의 "배포" 페이지에서 내보내기 옵션은 지원되는 버전에만 표시됩니다. 선택한 버전이 지원되지 않으면 호환되는 버전이 안내문에 표시됩니다.
{% endhint %}

## 작업 지원

호스팅 API는 다음 작업 유형을 지원합니다.

| 작업 유형      | Lens Studio에서 지원 |
| ---------- | ---------------- |
| 객체 감지      | ✅                |
| 분류         |                  |
| 인스턴스 분할    |                  |
| 시맨틱 세그멘테이션 |                  |

*참고: Roboflow Train 3.0을 사용해 학습한 모델만 지원됩니다. 모델에 연결된 Versions 페이지에서 해당 모델이 Roboflow Train 3.0으로 학습되었는지 확인할 수 있습니다.*

## Lens Studio에 모델 배포

Roboflow 사이드바에서 “배포”를 클릭한 다음, “Use with Snap Lens Studio” 상자가 보일 때까지 아래로 스크롤합니다. “Export to Lens Studio”를 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-f9c4614b39814c6c8dc8ddf3a40a33ad0a597a56%2Fimg-1-deploy.png?alt=media" alt=""><figcaption></figcaption></figure>

이 버튼을 클릭하면 모델의 클래스에 관한 정보가 팝업으로 표시됩니다.

이 클래스는 순서대로 정렬되어 있으며, 다음 단계에서 Lens Studio의 모델을 구성할 때 사용됩니다. 나중에 사용할 수 있도록 클래스 목록을 기록해 두세요.

또한 다음 두 파일이 다운로드됩니다.

1. 최소한의 구성만으로 애플리케이션에서 가중치를 사용할 수 있는 Roboflow Lens Studio 템플릿, 그리고
2. 모델 가중치.

Roboflow Lens Studio 템플릿의 크기는 100MB이므로 인터넷 연결 상태에 따라 다운로드하는 데 시간이 걸릴 수 있습니다.

템플릿을 준비했으니 Lens Studio에서 모델 설정을 시작할 수 있습니다.

### Lens Studio에서 모델 구성

아직 Lens Studio를 설치하지 않았다면 [Snap AR 웹사이트](https://ar.snap.com/lens-studio) 로 이동해 최신 버전의 Lens Studio를 다운로드하세요. Lens Studio를 설치하면 모델 구성을 시작할 수 있습니다.

이 섹션에서는 Roboflow Lens Studio 템플릿을 사용합니다. 하지만 [MLController 구성 요소](https://docs.snap.com/lens-studio/references/templates/ml/object-detection).

앞서 다운로드한 Roboflow Lens Studio 템플릿의 압축을 풀고, 압축을 푼 폴더에서 `Roboflow-Lens-Template.Isproj` 파일을 여세요.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-597eace699d594109cce768295f8972ea5576e33%2Fconfigure-model-1.png?alt=media" alt=""><figcaption></figcaption></figure>

애플리케이션을 열면 다음과 같은 화면이 표시됩니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-db3f4d31bcfd8929b64c9a538dc218fb0348750c%2Fconfigure-model-2.png?alt=media" alt=""><figcaption></figcaption></figure>

기본적으로 템플릿은 동전 개수 세기 모델을 사용합니다. 이 예시에서는 앞서 만든 트럼프 카드 모델을 사용하겠습니다. 이 애플리케이션은 각 예측 결과 주위에 상자를 그려 표시하지만, Lens Studio를 사용해 필터와 로직을 직접 추가할 수도 있습니다.

Lens Studio 왼쪽 사이드바 상단에서 “ML Controller” 상자를 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-f4f596fc12ab2133674adb97f22c19542b91b6e9%2Fconfigure-model-3.png?alt=media" alt=""><figcaption></figcaption></figure>

그러면 미리보기 창 옆에 애플리케이션에서 사용할 모델을 구성할 수 있는 상자가 열립니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-8dd7df74fc99215f7a8f137adc2c259947c04079%2Fconfigure-model-4.webp?alt=media" alt=""><figcaption></figcaption></figure>

데모 애플리케이션은 동전 개수 세기 예시에 맞게 구성되어 있습니다. 자체 모델을 사용하려면 먼저 “ML Model” 상자를 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-da04a177ca1fb96ca0e2232c14db454654c99aec%2Fconfigure-model-5.png?alt=media" alt=""><figcaption></figcaption></figure>

그런 다음 Roboflow에서 다운로드한 가중치를 팝업 상자로 끌어다 놓습니다.

{% embed url="<https://blog.roboflow.com/content/media/2023/06/Screen-Recording-2023-06-21-at-11.02.58.mp4>" %}

가중치를 끌어다 놓으면 몇 가지 구성 옵션이 표시됩니다. 팝업의 “Inputs” 섹션에서 각 “Scale” 값을 0.0039로 설정합니다. 편향 값은 기본 설정 그대로 둡니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-5452da89857a3ef82ee5ec87d631028634725723%2Fconfigure-model-6.png?alt=media" alt=""><figcaption></figcaption></figure>

그런 다음 “Import”를 클릭해 모델을 가져옵니다.

### Lens Studio에서 클래스 구성

이제 Lens Studio에 모델을 불러왔습니다. 한 단계만 더 진행하면 됩니다. 모델에서 사용할 클래스를 지정하세요.

앞서 사용한 ML Model 버튼 아래의 “Class Settings” 탭에 클래스 목록이 표시됩니다. 데모 프로젝트에는 동전 개수 세기 예시에 맞게 설정되어 있지만, 자체 Lens Studio 프로젝트를 사용한다면 이 값들은 비어 있을 수 있습니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-d9e08c050ee1a4f1895fe2a8f621a7f9455c064f%2Fconfigure-lens-1.png?alt=media" alt=""><figcaption></figcaption></figure>

여기에서 클래스 이름과 레이블을 설정해야 합니다. 레이블은 Roboflow 대시보드에 표시된 순서대로 입력해야 합니다. 다음은 트럼프 카드 애플리케이션에서 값 하나를 설정하는 예시입니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-f1ae3bbb3c97543ff57742576b5f17f1472618c9%2Fconfigure-lens-2.png?alt=media" alt=""><figcaption></figcaption></figure>

모델의 각 클래스에 대해 이 설정을 해야 합니다. Snap이 모델 가중치의 정보를 해석할 수 있도록 모델에 포함된 모든 클래스를 지정해야 합니다.

이제 애플리케이션을 사용할 준비가 되었습니다! “Preview” 상자에서 컴퓨터로 애플리케이션을 사용하거나, 다음 기능을 사용해 개인 기기에서 애플리케이션을 시연할 수 있습니다. [Snapchat 페어링 기능](https://docs.snap.com/lens-studio/references/guides/general/pairing-to-snapchat).
