# 임베드

> 내 제품 안에 Nodaro를 넣는 두 가지 방법, 즉 게시된 워크플로를 실행하는 미니앱과 상태가 없는 3D 장면 뷰포트, 그리고 각각을 사용할 때를 설명합니다.

Source: https://nodaro.ai/ko/docs/developers/embed

**임베드**는 Nodaro의 일부를 내 제품 안에 넣습니다. 임베드는 두 가지이며, 각각 다른 문제를 해결합니다. **미니앱 임베드**는 내 사용자를 위해 게시된 워크플로를 실행하고, **3D 장면 뷰포트**는 아무것도 실행하지 않고 3D 장면을 보여 주며, 원하면 편집도 할 수 있게 합니다.

## 임베드 선택
| | 미니앱 | 3D 장면 뷰포트 |
| --- | --- | --- |
| **기능** | 게시된 미니앱을 실행합니다. 입력을 받고, 실행을 시작하고, 결과를 보여 줍니다. | 3D 장면 플랜을 그립니다. 뷰포트, 재생, 오브젝트 목록, 포즈 편집기, 리비전 기록을 제공합니다. |
| **임베드 방법** | REST API 위에 만든 나만의 인터페이스, 또는 미니앱 임베드 코드로 넣는 프레임. | `postMessage`로 제어하는 `/embed/scene3d`의 프레임. |
| **인증** | 나만의 인터페이스는 내 서버에 보관한 개인 API 토큰이나 OAuth 토큰을 사용합니다. 프레임은 보는 사람의 Nodaro 세션으로 작동합니다. | 없습니다. 프레임에는 세션이 없으며 네트워크 호출도 하지 않습니다. |
| **크레딧** | 실행할 때마다 크레딧이 들며, 실행 주체인 계정이 지불합니다. | 들지 않습니다. 뷰어는 작업을 실행하지 않습니다. |
| **상태가 저장되는 곳** | 실행은 Nodaro에 저장됩니다. | 내 페이지가 장면을 보관합니다. 프레임은 새로 고침하면 아무것도 유지하지 않습니다. |

## 미니앱을 임베드할 때
- 워크플로를 미니앱으로 게시했고, 사용자가 내 사이트나 앱에서 그것을 실행해야 할 때. [앱](https://nodaro.ai/docs/concepts/apps)을 참고하세요.
- 앱을 나만의 양식과 스타일로 감싸고 싶을 때. REST API 위에 만드세요.
- 가장 빠른 방법을 원할 때. 미니앱의 임베드 코드를 페이지에 붙여 넣으세요.

[미니앱 임베드](https://nodaro.ai/docs/developers/embed/miniapps)를 읽어 보세요.

## 3D 장면 뷰포트를 임베드할 때
- 내 제품이 [**3D 장면 생성**](https://nodaro.ai/docs/nodes/video/generate-3d-scene)과 [**3D 장면 편집**](https://nodaro.ai/docs/nodes/video/edit-3d-scene) 작업으로 만든 3D 장면 플랜을 저장하고 있고, 사용자가 이를 볼 수 있어야 할 때.
- 사용자가 장면을 재생하고, 탐색하고, 오브젝트를 선택할 수 있어야 할 때. 기본은 읽기 전용입니다.
- 사용자가 포즈, 색상, 잠금을 편집하고, 내 페이지가 새 리비전을 하나씩 저장해야 할 때.

[3D 장면 뷰포트 임베드](https://nodaro.ai/docs/developers/embed/scene3d)를 읽고, 뷰포트가 그리는 데이터는 [3D 장면 형식](https://nodaro.ai/docs/developers/embed/scene3d-format)을 참고하세요.

## 두 임베드 모두 토큰을 브라우저 밖에 둡니다
어느 임베드도 내 웹 페이지에 Nodaro 토큰을 넣지 않습니다. 나만의 미니앱 인터페이스를 만들면 토큰은 내 서버에 남습니다. 3D 장면 뷰포트는 메시지에 토큰을 절대 싣지 않습니다. 내 페이지가 자체 세션으로 장면의 에셋을 가져와 바이트를 보냅니다.

## 자주 묻는 질문

### Nodaro에서 무엇을 임베드할 수 있나요?

두 가지입니다. 간단한 양식이 있는 게시된 워크플로인 미니앱, 그리고 내 페이지가 보내는 3D 장면 플랜을 그리는 3D 장면 뷰포트입니다.

### AI 생성을 실행하는 Nodaro 임베드는 무엇인가요?

미니앱 임베드뿐입니다. 3D 장면 뷰포트는 아무것도 실행하지 않고, 세션이 없으며, 네트워크 호출을 하지 않고, 크레딧을 전혀 쓰지 않습니다.

### 3D 장면 뷰포트를 임베드하려면 API 토큰이 필요한가요?

아니요. 뷰포트에는 토큰도 세션도 필요 없습니다. 내 페이지가 postMessage로 장면을 보내고, 장면의 바이너리 에셋은 내 페이지가 자체 세션으로 가져옵니다.

### 미니앱용 인터페이스를 직접 만들 때 토큰은 어디에 두나요?

내 서버에 둡니다. 브라우저 코드는 내 서버와 통신하고, 내 서버가 토큰으로 Nodaro API를 호출하므로 토큰은 브라우저에 절대 전달되지 않습니다.