Nodaro 문서
문서노드 레퍼런스모델템플릿AI 에이전트(MCP)개발자셀프 호스팅리서치비교
임베드

임베드

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

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

임베드 선택

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

미니앱을 임베드할 때

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

미니앱 임베드를 읽어 보세요.

3D 장면 뷰포트를 임베드할 때

  • 내 제품이 3D 장면 생성과 3D 장면 편집 작업으로 만든 3D 장면 플랜을 저장하고 있고, 사용자가 이를 볼 수 있어야 할 때.
  • 사용자가 장면을 재생하고, 탐색하고, 오브젝트를 선택할 수 있어야 할 때. 기본은 읽기 전용입니다.
  • 사용자가 포즈, 색상, 잠금을 편집하고, 내 페이지가 새 리비전을 하나씩 저장해야 할 때.

3D 장면 뷰포트 임베드를 읽고, 뷰포트가 그리는 데이터는 3D 장면 형식을 참고하세요.

두 임베드 모두 토큰을 브라우저 밖에 둡니다

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

자주 묻는 질문

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

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

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

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

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

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

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

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

최종 업데이트

목차