> 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

{% hint style="warning" %}
**Lens Studio 배포는 2026년 2월부터 더 이상 지원되지 않습니다.** 이 페이지는 참고용으로만 유지됩니다. Roboflow의 다음 중 하나를 사용해 모델을 배포하는 것을 권장합니다. [지원되는 배포 옵션](/deployment/ko/readme.md).
{% endhint %}

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

{% hint style="warning" %}
새로 학습된 모델에는 더 이상 Snap AR 내보내기 가중치가 생성되지 않습니다. 2026년 2월 25일 이전에 학습된 모델 버전만 Lens Studio에 필요한 가중치를 포함합니다. 프로젝트의 "Deploy" 페이지에서 내보내기 옵션은 해당 기능을 지원하는 버전에만 표시되며, 선택한 버전이 지원하지 않는 경우 호환되는 버전을 알리는 안내가 표시됩니다.
{% endhint %}

## 작업 지원

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

| 작업 유형   | Lens Studio에서 지원됨 |
| ------- | ----------------- |
| 객체 감지   | ✅                 |
| 분류      |                   |
| 인스턴스 분할 |                   |
| 시맨틱 세분화 |                   |

*참고: Roboflow Train 3.0으로 학습된 모델만 지원됩니다. 모델이 Roboflow Train 3.0으로 학습되었는지는 모델과 연결된 Versions 페이지를 확인하여 알 수 있습니다.*

## 모델을 Lens Studio에 배포하기

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

<figure><img src="/files/e492ea4045dac2a8456de2e5cea5a6c4649f4984" 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="/files/5bfe88a518748a60155da4ea88d36cf7037cefb4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/27a60fe01c0697d2ca6106a77e2f82be9eff8c1b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/f5e96fb529e2cb0e194db2b72387c453f8e22ae5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/a1c6177ae0e35a381b3f14b24709d7c2073f69ed" alt=""><figcaption></figcaption></figure>

데모 애플리케이션은 동전 계산기 예제로 구성되어 있습니다. 자신의 모델을 사용하려면 먼저 “ML Model” 상자를 클릭하세요:

<figure><img src="/files/889951ef39b15c4939e42f14d117ff66d64dd5b2" 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로 설정하세요. bias 값은 기본값 그대로 두세요.

<figure><img src="/files/5c2a9cd67de6267039bf1ae0761180ab44a00605" alt=""><figcaption></figcaption></figure>

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

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

이제 모델이 Lens Studio에 로드되었습니다. 마지막 단계가 하나 더 있습니다. 모델에 어떤 클래스를 사용하는지 알려주어야 합니다.

앞서 사용한 ML Model 버튼 아래의 “Class Settings” 탭에서 클래스 목록을 볼 수 있습니다. 이는 데모 프로젝트의 동전 계산기 예제로 구성되어 있지만, 직접 만든 Lens Studio 프로젝트를 사용 중이라면 이 값들은 비어 있을 것입니다.

<figure><img src="/files/190d548384eff280ef5ffed57708aa666412aeea" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/052e0fa6a16bcc5c3e6334eea603bed4d514da15" alt=""><figcaption></figcaption></figure>

모델의 각 클래스마다 이 구성을 수행해야 합니다. Snap이 모델 가중치의 정보를 해석할 수 있도록 모델의 모든 클래스를 지정해야 합니다.

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