앱(미니앱)
미니앱은 고유 URL이 있는 간단한 양식으로 게시한 워크플로입니다. 사람들이 채울 입력, 보기 모드, 공유, 요금, 임베드를 정하는 방법을 알아보세요.
미니앱은 간단한 앱으로 게시한 워크플로입니다. 사람들이 짧은 양식을 채우고 실행을 클릭하면, Nodaro가 그 뒤에 있는 워크플로를 실행하고 결과를 보여 줍니다. 사람들은 캔버스를 보지 않으며, 미니앱마다 고유한 URL, 실행 기록, 버전이 있습니다.
미니앱의 작동 방식
| 만든 사람(나) | 앱을 실행하는 사람 | |
|---|---|---|
| 보이는 것 | 캔버스 위의 워크플로 전체 | 만든 사람이 고른 입력과 결과만 |
| 하는 일 | 워크플로를 만들고, 입력과 출력을 고르고, 게시합니다 | 입력을 채우고 실행을 클릭합니다 |
| 비용 | 게시는 무료입니다 | 실행에 드는 크레딧. 자신의 잔액에서 내며, 실행 버튼에 표시됩니다 |
워크플로를 미니앱으로 게시
프레젠테이션 탭 열기
워크플로를 열고 편집기 상단의 프레젠테이션을 클릭하세요. 프레젠테이션 탭에서는 사람들이 보는 화면을 만듭니다. 사람들이 채우는 입력, 받는 결과, 그리고 그 주변의 제목, 그룹, 짧은 텍스트입니다.
입력과 출력 고르기
프롬프트, 이미지 업로드, 피커처럼 사람들이 필드를 채울 노드를 추가하세요. 그런 다음 사람들이 결과를 볼 노드를 추가하세요. 각각에 제목과 설명을 붙이세요. 선택지 목록이라면 사람들이 고를 수 있는 값을 제한할 수 있습니다.
노드 하단 바의 빠른 설정도 무엇이든 공개할 수 있습니다. 예를 들어 모델, 해상도, 길이, 화면 비율, 초안입니다. 앱의 카드는 실행에 쓰이는 모델의 선택지만 보여 줍니다. 사람들이 모델을 바꾸면, 새 모델이 받지 않는 선택은 받는 선택으로 바뀝니다.
게시를 클릭하고 미니앱 선택
게시를 클릭하고 미니앱을 선택한 다음, 미니앱 이름과 설명을 입력하세요. URL 슬러그는 선택 사항입니다. 비워 두면 Nodaro가 이름으로 만들어 줍니다.
앱 옵션을 정하고 게시
아래 표의 옵션을 고른 다음 앱 게시를 클릭하세요. 미니앱 열기로 사용자에게 보이는 모습 그대로 확인할 수 있습니다.
| 옵션 | 기능 |
|---|---|
| 마켓플레이스에 등록 | 고른 카테고리, 출력 유형, 태그와 함께 미니앱 페이지의 둘러보기 탭에 앱을 등록합니다. 등록하지 않은 앱도 링크로는 열립니다. |
| RemX 지원 | 사람들이 내 앱을 맞춤 설정하고 리믹스할 수 있게 합니다. |
| 읽기 전용 | 사람들이 결과는 볼 수 있지만 입력은 편집할 수 없습니다. |
| 허용할 보기 모드 | 사람들이 전환할 수 있는 레이아웃입니다. 보기 모드를 참고하세요. |
| 기본 보기 모드 | 앱이 처음 열릴 때의 레이아웃입니다. |
| 비교 기본값 | 나란히 비교 모드가 처음에 왼쪽과 오른쪽에 나란히 보여 주는 두 노드입니다. |
| 실행 썸네일 | 실행 목록에서 각 실행의 썸네일로 쓰이는 결과를 내는 노드입니다. |
게시된 앱의 주소는 app.nodaro.ai/app/ 뒤에 슬러그를 붙인 것입니다. URL은 버전이 바뀌어도 그대로입니다. 워크플로를 변경한 뒤 다시 게시하면, 공유한 모든 링크에서 새 버전이 열립니다.
보기 모드
만든 사람은 앱이 제공할 보기 모드와 처음 열릴 모드를 고릅니다. 앱을 실행하는 사람은 허용된 모드 사이에서 전환할 수 있습니다.
| 모드 | 모습 |
|---|---|
| 좌우 분할 | 왼쪽에 입력, 오른쪽에 결과가 있습니다. |
| 세로 배열 | 위에 입력, 아래에 결과가 있습니다. 좁은 화면에 알맞습니다. |
| 갤러리 그리드 | 입력과 결과가 카드 그리드로 표시됩니다. |
| 전체 화면 슬라이드쇼 | 결과를 한 번에 하나씩 전체 화면으로 보여 줍니다. |
| 나란히 비교 | 두 결과를 나란히 보여 줍니다. |
| 채팅 | 하단의 작성창에 입력이 있고, 각 실행이 스레드의 메시지로 나타납니다. |
채팅 모드
채팅 모드는 앱을 대화로 바꿉니다. 앱의 허용할 보기 모드에 채팅을 추가하기 전까지는 꺼져 있으며, 데스크톱과 모바일에서 작동합니다.
- 작성창은 칩 한 줄입니다. 각 입력은 작은 칩입니다. 클릭하면 값을 편집할 수 있습니다. 업로드 칩은 파일을 추가하면 썸네일을 보여 줍니다.
- 실행 버튼으로 시작합니다. 새 실행 버튼은 따로 없습니다. 실행은 실행을 시작하고 크레딧 가격을 보여 주며, 값을 작성창에 그대로 남겨 두므로 하나만 바꿔 다시 실행할 수 있습니다.
- 한 번에 하나씩 실행합니다. 실행 중에는 작성창이 잠기고, 실행이 끝나면 다시 열립니다.
- 각 실행은 스레드에 남습니다. 여러 단계로 된 실행은 단계마다 칩을 보여 주고, 단계가 끝날 때마다 완료 표시가 됩니다. 같은 값으로 다시 실행하려면 입력 재사용, 단계의 결과를 열려면 단계 보기, 결과를 저장하려면 다운로드를 사용하세요.
- 결과를 전체 화면으로 봅니다. 결과를 탭하면 전체 화면으로 열립니다. ←와 →로 그 실행의 입력과 결과를 차례로 보고, ↑와 ↓로 실행 사이를 이동하고, Esc로 닫으세요.
앱을 실행하는 사람에게 보이는 것
- 내가 고른 것만 보입니다. 프레젠테이션 탭에 넣은 입력과 결과가, 내가 쓴 제목과 텍스트와 함께 보입니다.
- 앞뒤 텍스트는 보이지 않습니다. 노드의 앞뒤 텍스트는 모든 프롬프트를 감싸지만, 앱에는 절대 표시되지 않습니다. 내 고유한 스타일을 담는 데 사용하세요.
- 보내는 곳은 바뀌지 않습니다. 앱은 보내는 곳과 가져오는 대상을 고정합니다. Webhook 출력 주소, 소셜 계정, 스크레이퍼의 대상이 그렇습니다. 앱을 실행하는 사람은 이를 바꿀 수 없습니다.
- 각자 자신의 잔액으로 냅니다. 앱을 실행하려면 로그인해야 하며, 각 실행 비용은 자신의 크레딧에서 나갑니다. 앱은 잔액으로 몇 번 실행할 수 있는지 알려 줍니다.
- 녹음 길이에 따른 가격. 가격이 앱에 주는 녹음이나 동영상 링크의 길이에 따라 달라지면, 고정 부분과 녹음 1분당 부분으로 표시됩니다. 채우는 목록이 있으면 추가 항목마다 부분이 더해집니다. 표시된 가격에는 최종 렌더링도 포함됩니다. 실행 버튼은 실행의 가격을 보여 주고, 녹음을 고르면 정확한 금액을 보여 줍니다.
- 선택에 따라 가격이 바뀌면 가격 범위. 사람들이 모델이나 길이처럼 가격을 바꾸는 설정을 바꿀 수 있으면, 표시된 가격은 “X부터 최대 Y”로 나옵니다. “부터”는 내가 저장한 설정의 가격이고, “최대”는 사람들이 고를 수 있는 선택지에서 실행 한 번에 들 수 있는 가장 높은 가격입니다.
저장된 키로 보내는 Webhook 출력이 있으면, 앱을 게시하기 전에 하나의 주소에 고정된 키를 사용해야 합니다. 게시 대화 상자에서 키를 대신 고정해 주겠다고 제안합니다. Webhook 출력을 참고하세요.
앱의 UGC 동영상
UGC 동영상을 만드는 워크플로는 UGC 노드를 비운 채로 게시합니다. 앱에는 내 스크립트, 클립, 카드, 크리에이터 이미지가 포함되지 않으며, 내 사진도 절대 포함되지 않습니다. 크리에이터 사진으로 이어지는 모든 노드와 UGC 동영상으로 만든 모든 노드는 설정만 포함됩니다. 실행할 때마다 다시 렌더링됩니다. 공유 링크도 같은 방식으로 다른 사람에게 워크플로를 보여 줍니다.
- 내 사진 사용. UGC 크리에이터가 내 사진 사용으로 설정되어 있으면, 앱은 실행하는 사람마다 본인 사진을 요청합니다. 사진 없이 실행하면 요금이 청구되기 전에 “이 앱에는 본인 사진이 필요합니다. 사진을 추가한 뒤 다시 실행하세요.”라는 메시지와 함께 거부됩니다.
- 크리에이터 하나. 앱 실행은 크리에이터를 하나만 만들고 곧바로 동영상으로 넘어갑니다.
- 잔액 먼저 확인. UGC 동영상은 클립을 렌더링하는 동안 예상 비용보다 많은 크레딧을 보류합니다. 결제하는 사람이 그 보류 금액을 충당할 수 없는 실행은 아무것도 실행되기 전에 금액과 잔액을 알려 주는 메시지와 함께 거부됩니다.
- 잠긴 필드. 실행으로 설정할 수 있는 것은 크리에이터의 소스, 성별, 사진과 스크립트 길이뿐입니다. UGC 노드의 다른 값은 거부됩니다.
UGC 동영상은 Nodaro Cloud 기능입니다.
앱에서 최종 렌더링
워크플로의 EDL 적용 렌더링이 미리 보기 먼저 — 검토 후 최종 렌더링으로 설정되어 있으면, 앱의 렌더링 카드는 결과를 미리 보기 레이블과 함께 보여 줍니다. 카드에는 가격이 붙은 최종 렌더링 버튼도 있습니다. 최종 렌더링은 시작하기 전에 확인을 요청합니다. 컷을 전체 품질로 렌더링한 다음, 렌더링 뒤의 모든 노드를 한 번 더 실행합니다. Nodaro Cloud에서는 앱 실행이 미리 보기에서 멈추지 않습니다. 렌더링 뒤의 노드는 먼저 미리 보기로 실행됩니다.
- 앱 실행과 별도로 청구됩니다. 최종본과 그 뒤의 노드는 앱을 실행하는 사람에게 각 노드의 가격으로 청구됩니다. 만든 사람의 추가 요금은 붙지 않으며, 앱의 하루 실행 한도에도 포함되지 않습니다.
- 미리 보기는 계속 재생할 수 있습니다. 최종본을 렌더링하는 동안에도 그렇습니다. 최종본이 완성되면 카드에 최종이 표시되고, 미리 보기 표시로 미리 보기로 돌아갈 수 있습니다.
- 실행마다 최종 렌더링은 한 번에 하나입니다. 실패한 최종 렌더링은 같은 버튼에서 다시 시작할 수 있습니다.
최종 렌더링은 모든 보기 모드, 모바일, 임베드한 앱에서 작동합니다. 미리 보기와 최종 렌더링을 참고하세요.
대신 프레젠테이션 링크 공유
프레젠테이션 탭에서는 워크플로를 게시하지 않고 공유할 수도 있습니다. 공유 대화 상자는 누구나 워크플로를 실행할 수 있는 링크를 만들며, 실행 비용은 각자 자신의 크레딧으로 냅니다. 뷰어 설정에는 뷰어는 결과만 볼 수 있습니다, 허용할 보기 모드, 기본 보기 모드가 있습니다. 공유 취소를 누르면 링크가 꺼집니다.
오래 유지되는 URL, 실행 기록, 버전, 분석, 미니앱 페이지 등록이 필요하면 미니앱을 게시하세요. 빠르게 검토만 받으려면 공유 링크를 사용하세요.
내 미니앱 관리
사이드바에서 미니앱을 여세요. 페이지에는 탭이 세 개 있습니다.
- 둘러보기: 등록된 모든 미니앱입니다. 검색하고 인기순, 최신순, 즐겨찾기 많은 순으로 정렬할 수 있습니다.
- 내 미니앱: 내가 게시한 앱과 각 앱의 실행 수, 실행당 가격, 즐겨찾기 수입니다. 각 카드에서 앱이나 워크플로를 열고, URL이나 임베드 코드를 복사할 수 있습니다. 분석을 보고, 설정을 편집하고, 등록하거나 등록 해제하고, 비활성화할 수도 있습니다.
- 즐겨찾기: 하트를 눌러 둔 앱입니다.
미니앱을 삭제하면 마켓플레이스와 내 목록에서 숨겨집니다. 삭제한 미니앱에서 언제든 복원할 수 있으며, 수익, 분석, 실행 기록은 그대로 유지됩니다.
미니앱에 요금 부과
Nodaro Cloud에서 사용할 수 있습니다
Nodaro Cloud에서는 다른 사람이 내 미니앱을 실행할 때 추가 요금을 받을 수 있습니다. 앱 카드에서 미니앱 설정 편집을 열고, 수익화에서 크레딧 단위의 고정 요금, 비율 또는 둘 다를 정하세요. 대화 상자에는 사람들이 낼 금액, 즉 실행 기본 비용에 내 추가 요금을 더한 금액이 표시됩니다. 미니앱 페이지의 수익화 기본값은 미니앱에서 수익화를 처음 켤 때 적용되는 고정 요금과 비율을 정합니다.
내 수익은 충전 잔액에 더해지며 12개월 동안 유효합니다. 결제 페이지의 미니앱 수익에서 이번 달, 최근 30일, 전체 기간의 수익을 볼 수 있습니다. 크레딧을 참고하세요.
미니앱 임베드 또는 코드에서 실행
웹사이트에 임베드하기. 앱 카드에서 임베드를 클릭해 임베드 코드를 복사하세요. 먼저 임베드 설정 › 임베드 허용 도메인에 앱을 보여 줄 웹사이트를 추가하세요. 도메인을 하나 이상 추가하기 전까지 임베드는 차단됩니다.
내 코드에서 실행하기. 내 웹사이트나 앱에서도 REST API로 게시된 미니앱을 실행할 수 있습니다. 서버가 앱의 입력을 읽고, 실행을 시작하고, 결과를 기다립니다. 앱의 식별자는 URL의 마지막 부분인 슬러그입니다. 실행은 비동기로 진행되므로, 서버는 실행을 시작한 다음 결과를 확인합니다. 코드를 포함한 전체 흐름은 미니앱 임베드에 있습니다.
MCP로 연결된 어시스턴트도 내 앱을 나열하고 실행할 수 있으며, CLI는 nodaro apps run으로 앱을 실행합니다.
양식이 아니라 다른 워크플로 안에서 워크플로를 재사용하려면 컴포넌트로 게시하세요. 워크플로 하나를 미니앱과 컴포넌트로 동시에 게시할 수 있습니다.
자주 묻는 질문
Nodaro의 미니앱이란 무엇인가요?
미니앱은 고유 URL이 있는 간단한 앱으로 게시한 워크플로입니다. 사람들은 만든 사람이 고른 입력을 채우고 “실행”을 클릭합니다. Nodaro가 워크플로를 실행하고, 캔버스 없이 결과를 보여 줍니다.
내 미니앱의 실행 비용은 누가 내나요?
앱을 실행하는 사람이 자신의 크레딧으로 냅니다. “실행” 버튼에 가격이 먼저 표시됩니다. Nodaro Cloud에서는 추가 요금을 붙일 수도 있으며, 이 금액은 수익으로 내 충전 잔액에 더해집니다.
사람들이 내 프롬프트와 설정을 볼 수 있나요?
앱에 넣은 입력과 결과만 볼 수 있습니다. 앞뒤 텍스트는 절대 표시되지 않으며, Webhook 주소나 소셜 계정처럼 외부로 보내는 노드의 대상은 앱을 실행하는 사람이 바꿀 수 없습니다.
게시한 미니앱은 어떻게 업데이트하나요?
워크플로를 변경한 다음 “프레젠테이션” 탭에서 다시 게시하세요. URL은 버전이 바뀌어도 그대로이므로, 이미 공유한 링크도 계속 작동합니다.
미니앱을 내 웹사이트에 넣을 수 있나요?
네. 앱 카드에서 임베드 코드를 복사하고 “임베드 허용 도메인”에 내 웹사이트를 추가하세요. 인터페이스를 직접 만들려면, 서버에서 REST API로 실행을 시작하고 결과를 읽을 수 있습니다.
관련 문서
미니앱 임베드
컴포넌트와 하위 워크플로
크레딧
프롬프트 앞뒤 텍스트
워크플로와 프로젝트
최종 업데이트