Nodaro 문서앱과 컴포넌트
list_apps, run_app, list_components, run_component로 게시된 Nodaro 앱과 컴포넌트를 찾고, 입력을 확인하고, AI 어시스턴트에서 실행합니다.
앱과 컴포넌트 도구를 사용하면 어시스턴트가 다른 사람들이 게시한 워크플로를 쓸 수 있습니다. 앱은 사진 복원이나 테마 편집처럼 간단한 양식을 갖춘 게시된 워크플로이고, 컴포넌트는 게시된 구성 요소입니다. 어시스턴트는 앱이나 컴포넌트를 찾아 입력을 읽은 다음, 내 크레딧으로 실행합니다.
앱은 새로운 변환, 테마 편집, 여러 단계의 파이프라인처럼 생성 도구 하나로는 처리할 수 없는 많은 요청을 다룹니다. 어시스턴트는 무언가를 할 수 없다고 답하기 전에 앱을 검색해야 합니다.
list_apps
게시된 앱을 검색합니다. 공개 마켓플레이스나 내 앱에서 찾습니다.
권한: apps:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
scope | string | public(기본값)은 마켓플레이스, mine은 내 앱입니다. |
search | string | 검색할 주제로, 최대 100자입니다. |
category | string | 카테고리로, 최대 50자입니다. |
limit | integer | 1~50입니다. |
cursor | string | 이전 페이지의 커서입니다. |
반환값: 일치하는 앱과 각 앱의 슬러그입니다. 각 앱의 estimated_credits는 앱이 표시하는 가격입니다. 가격이 내가 앱에 주는 녹화본의 길이에 따라 정해지는 경우, 예를 들어 에피소드 전체의 EDL 적용 렌더라면, estimated_credits는 고정 부분이고 per_minute_credits는 녹화본 1분당 크레딧입니다. 앱에 내가 채우는 목록 입력이 있으면, per_item_credits는 크리에이터가 저장한 항목을 넘는 항목마다 더해지는 크레딧입니다. 해당하지 않으면 둘 다 0이거나 없습니다.
표시되는 가격은 범위입니다. 위의 필드는 앱에 저장된 설정 기준의 “최소” 가격입니다. max_estimated_credits, max_per_minute_credits, max_per_item_credits는 “최대” 가격으로, 앱 사용자가 고를 수 있는 선택지 중에서 실행 한 번에 들 수 있는 가장 높은 비용입니다. “최소” 가격과 다를 때만 나타납니다. 범위가 생기기 전에 게시된 앱은 다음에 다시 게시한 뒤에야 이 필드를 가집니다.
get_app_inputs
앱 페이지에 표시되는 것과 같은 양식으로 앱의 입력을 반환합니다. 입력 키를 알아보려면 run_app 전에 호출하세요.
권한: apps:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
slug | string | 필수. 앱의 슬러그입니다. 예: photo-restoration. |
반환값: 앱의 slug, name, description, 그리고 입력마다 항목 하나입니다. 각 항목에는 key, label, type(image, video, audio, text, select, number, boolean, list 또는 color), required 여부, 그리고 select의 options가 들어 있습니다.
- 앱이 노출하는 슬라이더, 예를 들어 텍스트 음성 변환의 안정성, LLM의 온도, 길이는 슬라이더 자체의
min,max,step을 가진type: "number"입니다.run_app은 이 입력에 숫자나 숫자 문자열을 받습니다. - 앱이 노출하는 빠른 설정, 예를 들어 노드의 모델, 해상도, 길이, 화면 비율 또는 초안 선택은 받는 값에 따라 타입이 정해집니다. 값 목록을
options로 가진select, 범위 안의 아무 값이나 받는 설정이면min과max를 가진number, 또는 초안이나 반주 같은boolean입니다. 선택지가 노드의 모델에 따라 달라지면options에는 모든 모델의 값이 나열되고description에 그렇다고 적혀 있습니다. 노드의 모델이 받는 값을 고르세요. 이 입력에서run_app은 숫자 문자열을 숫자로,"true"또는"false"를 boolean으로 바꿉니다. 고정 목록에 없는 값은400 validation_error로 거부됩니다. - 동영상 URL 입력은
type: "video"이고required: true입니다. 값은 동영상 링크로, YouTube, TikTok, Instagram, Facebook, X 게시물이나 다른 공개 웹 링크입니다. 웹 링크가 아닌 값은400 locked_field로 거부됩니다. 4분 이상인 YouTube 동영상은inputOverrides에서 노드에sectionStartSec와sectionEndSec로 지정한 부분만 다운로드됩니다. 부분을 지정하지 않은 실행은 아무것도 청구되기 전에 거부됩니다.
run_app
게시된 앱을 실행합니다. 실행의 크레딧은 내가 냅니다.
권한: workflows:execute. 크레딧: 앱 안에서 실행되는 노드의 크레딧입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
slug | string | 필수. 앱의 슬러그입니다. |
inputs | object | get_app_inputs에서 받은 입력 키를 키로 쓰는 평면 객체입니다. 생략하면 기본값을 씁니다. |
inputOverrides | object | 고급 옵션입니다. 노드 id와 필드를 키로 쓰는 노드 필드 원본 값으로, inputs 위에 적용됩니다. 예: { "n1": { "promptPrefix": "..." } }. null로 지정한 필드는 이번 실행에서 비워집니다. 노드는 크리에이터가 저장한 값이 아니라 그 자리에 값이 없는 상태로 실행됩니다. |
client_request_id | string | 재시도 토큰으로, 영문자, 숫자, _ - . :로 이루어진 8~128자입니다. 타임아웃 후 재시도할 때 같은 값을 다시 쓰면 실행이 두 번 시작되거나 두 번 청구되지 않습니다. |
반환값: 실행 ID입니다. 실행은 get_app_run으로 확인하세요.
inputOverrides로는 Webhook 출력 노드의 URL, 게시 노드의 계정, 스크레이퍼의 대상처럼 출력이 가는 곳을 설정할 수 없습니다. 이를 시도하는 실행은 400 locked_field로 거부됩니다.
delete_app_run
앱 실행을 보관함으로 옮깁니다. app.nodaro.ai/archived-runs에서 복원하거나 완전히 삭제할 수 있습니다. 실행은 끝났거나 중지된 뒤에만 완전히 삭제할 수 있습니다.
권한: workflows:execute. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
slug | string | 필수. 앱의 슬러그로, 앱 URL의 마지막 부분입니다. |
runId | string | 필수. 실행 id입니다. |
반환값: 확인 메시지입니다.
list_components
게시된 컴포넌트를 검색합니다. 공개 마켓플레이스나 내 컴포넌트에서 찾습니다. 사용자가 컴포넌트 이름을 말하거나, 알려진 컴포넌트와 맞는 여러 단계의 파이프라인을 요청할 때 사용하세요.
권한: workflows:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
scope | string | public(기본값)은 마켓플레이스, mine은 내 컴포넌트입니다. |
search | string | 검색할 주제로, 최대 100자입니다. |
limit | integer | 1~50입니다. |
cursor | string | 이전 페이지의 커서입니다. |
반환값: 일치하는 컴포넌트와 각 컴포넌트의 슬러그입니다. 각 컴포넌트에는 estimated_credits, per_minute_credits, per_item_credits와 이에 대응하는 max_ 필드가 있으며, list_apps와 같은 방식으로 읽습니다.
get_component_inputs
컴포넌트의 입력을 반환합니다. 입력 키를 알아보려면 run_component 전에 호출하세요.
권한: workflows:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
component_id | string | 필수. 컴포넌트의 슬러그입니다. |
반환값: 입력마다 항목 하나이며, 각 항목에는 key, label, type, required 여부가 들어 있습니다.
run_component
게시된 컴포넌트를 실행합니다.
권한: workflows:execute. 크레딧: 컴포넌트 안에서 실행되는 노드의 크레딧입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
component_id | string | 필수. 컴포넌트의 슬러그입니다. |
inputs | object | get_component_inputs에서 받은 입력 키를 키로 쓰는 평면 객체입니다. 생략하면 기본값을 씁니다. |
client_request_id | string | 재시도 토큰으로, 영문자, 숫자, _ - . :로 이루어진 8~128자입니다. 타임아웃 후 재시도할 때 같은 값을 다시 쓰세요. |
반환값: 작업 ID입니다. 작업이 완료되면 output_data에 컴포넌트의 출력이 담깁니다. MCP Apps를 지원하는 클라이언트에서는 작업 카드에 출력이 위아래로 차례로 표시됩니다.
자주 묻는 질문
앱과 컴포넌트는 어떻게 다른가요?
앱은 간단한 양식으로 단독 실행되는 게시된 워크플로입니다. 컴포넌트는 다른 워크플로가 재사용하는 게시된 구성 요소입니다. 요청을 처리할 전용 도구가 없으면 어시스턴트는 먼저 앱을 찾습니다.
어시스턴트가 시작한 앱 실행의 비용은 누가 내나요?
내가 냅니다. run_app과 run_component는 앱이나 컴포넌트 안에 있는 노드의 가격대로 내 계정의 크레딧을 씁니다.
어시스턴트가 앱의 숨겨진 설정을 바꿀 수 있나요?
일부만 바꿀 수 있습니다. inputOverrides로 프롬프트 앞에 붙는 텍스트 같은 노드 필드를 직접 설정할 수 있지만, Webhook URL이나 소셜 계정처럼 출력이 가는 곳은 바꿀 수 없습니다. 그런 실행은 거부됩니다.
어시스턴트에서 앱 실행을 삭제하려면 어떻게 하나요?
앱의 슬러그와 실행 id로 delete_app_run을 호출하세요. 실행이 보관함으로 옮겨지며, 그곳에서 복원하거나 완전히 삭제할 수 있습니다.
관련 문서
앱(미니앱)
컴포넌트와 하위 워크플로
갤러리와 에셋
프로젝트와 워크플로
최종 업데이트