Nodaro 문서CLI
명령
프로젝트, 워크플로, 앱, 노드, 모델, 프리셋, 팔레트, 작업, 갤러리, Webhook, 결제, Recast를 다루는 Nodaro CLI의 모든 핵심 명령과 옵션을 정리했습니다.
핵심 Nodaro CLI 명령은 프로젝트와 워크플로를 관리하고, 게시된 앱과 단일 노드를 실행하고, 실행과 작업을 확인합니다. 이 페이지에는 각 명령과 옵션이 정리되어 있습니다. 에셋, 미디어, 워크스페이스 명령은 별도 페이지가 있으며, 첫 번째 표에 나와 있습니다.
모든 예시는 CLI를 설치하고 로그인했다고 가정합니다.
명령 그룹
| 그룹 | 기능 | 문서 위치 |
|---|---|---|
auth | 로그인, 프로필 보기와 제거 | CLI |
projects | 프로젝트 만들기, 읽기, 수정, 삭제 | 이 페이지 |
sessions | 프로젝트 안의 생성 세션 | 이 페이지 |
workflows | 워크플로 관리, 내보내기, 가져오기, 실행, 공유 | 이 페이지 |
apps | 게시된 앱 둘러보기와 실행 | 이 페이지 |
nodes | 노드 타입 목록 보기와 단일 노드 실행 | 이 페이지 |
models | 모델 카탈로그 둘러보기 | 이 페이지 |
billing | 요금제와 가격, 내 구독 | 이 페이지 |
pickers | 피커 카탈로그 읽기와 설명으로 피커 채우기 | 이 페이지 |
presets | 내 노드 프리셋, 즐겨찾기, 폴더, 그리고 기본 제공 카탈로그 | 이 페이지 |
palettes, moodboards | 이미지 생성에 쓰는 내 컬러 팔레트와 무드보드 | 이 페이지 |
catalog | 배포 환경의 카탈로그 팩을 오프라인으로 관리 | 이 페이지 |
executions, jobs | 실행 확인, 필터, 평가, 취소 | 이 페이지 |
gallery | 공개 갤러리와 내 즐겨찾기 | 이 페이지 |
webhooks | 작업이 끝날 때 Nodaro가 호출하는 엔드포인트 | 이 페이지 |
video-pro | 동영상 생성 Pro 실행 중지와 이어 가기 | 이 페이지 |
prompt | 대략적인 아이디어를 최적화된 프롬프트로 바꾸기 | 이 페이지 |
shots | 샷 공유 기록 만들기와 읽기 | 이 페이지 |
recast | Recast 실행 계획과 렌더링, 또는 스크립트 가져오기 | 이 페이지 |
characters, locations, objects | 에셋 관리와 그 이미지, 모션 생성 | 에셋 명령 |
voice, media, audio, edit | 미디어의 음성 교체, 자막, 합성, 편집 | 미디어와 보이스 명령 |
org, workspace | 조직, 초대, 워크스페이스, 사용량 보고서 | 워크스페이스와 조직 |
모든 명령에 쓸 수 있는 옵션
--profile <name>은 기본 프로필 대신 저장된 프로필로 명령을 실행합니다.--json은 데이터를 읽는 모든 명령에서 기계가 읽을 수 있는 출력을 표시합니다. 출력과 종료 코드를 참고하세요.--workspace <id>는 전역 옵션입니다. 이 명령에만 적용할 워크스페이스를 정합니다. 워크스페이스와 조직을 참고하세요.-v또는--version은 CLI 버전을 표시합니다.
아래 형식에서 <value>는 직접 넣는 값, [...]는 선택 사항, a|b는 나열된 값 중 하나를 뜻합니다.
프로젝트
nodaro projects list [--json]
nodaro projects get <id> [--json]
nodaro projects create --name <name> [--description <desc>] [--json]
nodaro projects update <id> [--name <name>] [--description <desc>] [--json]
nodaro projects delete <id> [--json]세션
생성 세션은 프로젝트 안에서 단일 생성을 묶습니다. 세션의 항목은 내 작업의 사본이 아니라 링크입니다. client.sessions를 참고하세요.
nodaro sessions list [--project <id>] [--tool <tool>] [--archived] [--limit <n>] [--cursor <c>] [--json]
nodaro sessions get <id> [--json]
nodaro sessions items <id> [--limit <n>] [--cursor <c>] [--json]
nodaro sessions create --tool <tool> [--project <id>] [--title <title>] [--json]
nodaro sessions update <id> [--title <title> | --untitled] [--archive | --unarchive] [--json]
nodaro sessions import <id> --jobs <id,id,...> [--json]
nodaro sessions remove <id> <jobId> [--json]
nodaro sessions delete <id> [--json]import는 작업을 세션에 연결합니다. 전부 성공하거나 전부 실패합니다. 내 것이 아닌 작업이 하나라도 있으면 호출 전체가 실패합니다.remove는 링크만 제거합니다. 작업은 남고, 그 작업을 담은 다른 세션도 그대로입니다.delete는 세션을 삭제합니다. 세션의 작업은 유지됩니다.
워크플로
nodaro workflows list --project <projectId> [--json]
nodaro workflows get <id> [--json]
nodaro workflows create --project <projectId> --name <name> [--file bundle.json] [--json]
nodaro workflows update <id> [--name <name>] [--file nodes-edges.json] [--json]
nodaro workflows delete <id> [--json]
nodaro workflows export <id> [--with-assets] [--output bundle.json]
nodaro workflows import <file> --project <projectId> [--json]
nodaro workflows run <id> [--watch] [--node n1 n2 ...] [--json]| 옵션 | 기능 |
|---|---|
create --file | 내보낸 워크플로 번들로 워크플로를 만듭니다. |
update --file | JSON 파일에 있는 노드, 엣지, 설정을 워크플로에 씁니다. |
export --with-assets | 워크플로가 쓰는 캐릭터, 오브젝트, 장소 데이터를 번들에 추가합니다. |
export --output | 번들을 출력하지 않고 파일에 씁니다. |
run --node | 공백으로 구분해 나열한 노드 ID만 실행합니다. |
run --watch | 실행이 끝날 때까지 따라갑니다. |
번들 형식은 편집기가 내보내는 형식과 같습니다. 워크플로 가져오기와 내보내기를 참고하세요.
워크플로 공유와 이동
이 명령은 조직과 워크스페이스가 있는 인스턴스에서 작동합니다.
nodaro workflows share <id> [--visibility workspace|private] [--json]
nodaro workflows move <id> --project <projectId> [--json]
nodaro workflows shared-with-me [--json]
nodaro workflows collaborators list <id> [--json]
nodaro workflows collaborators add <id> (--user <userId> | --email <email>) --role viewer|editor [--json]
nodaro workflows collaborators update <id> <userId> --role viewer|editor [--json]
nodaro workflows collaborators remove <id> <userId> [--json]share는 워크스페이스에서 누가 워크플로를 볼 수 있는지 정합니다. 기본 공개 범위는workspace입니다.collaborators add --email은 조직과 관계없이 모든 Nodaro 계정의 주소와 대조합니다. 계정이 없는 주소에는404가 반환됩니다.move는 워크플로를 다른 프로젝트로 옮깁니다. 다른 워크스페이스로 옮기면 워크플로의 공동 작업자가 제거되며, 결과에 액세스를 잃은 사람이 나옵니다.
앱
앱은 다듬어진 입력과 출력 폼으로 감싼 워크플로입니다. 앱을 참고하세요.
nodaro apps list [--search <query>] [--limit <n>] [--cursor <token>] [--category <slug>]
nodaro apps get <slug> # input schema and outputs
nodaro apps run <slug> --input prompt="..." [--watch]
nodaro apps run <slug> --params-file inputs.json [--watch]
nodaro apps run <slug> --input prompt="..." --override <nodeId>.<field>=<value>
nodaro apps runs <slug> [--limit <n>] [--cursor <token>] [--json] # your past runs
nodaro apps run-get <slug> <runId>apps list는 페이지마다 최대 50개의 앱을 반환합니다. 다음 페이지를 받으려면 한 페이지의--cursor를 넘기세요.apps get은 앱의 입력 이름을 보여 줍니다. 이 이름을--input의 키로 쓰세요.--input은 앱 입력 하나를 설정합니다. 입력마다 반복하거나,--params-file로 모두 JSON 파일에 담으세요.--override는 이번 실행에만 원시 노드 필드를<nodeId>.<field>=<value>형식으로 설정합니다.promptPrefix처럼 앱이 노출하지 않는 필드에도 닿습니다. 프롬프트 앞뒤 텍스트를 참고하세요.
재정의로는 Webhook 출력 주소처럼 외부 전송 노드가 보내거나 가져오는 곳을 절대 바꿀 수 없습니다. 대신 실행이 locked_field로 거부됩니다.
노드
nodaro nodes list [--category <category>] [--json]
nodaro nodes get <type> # full input schema
nodaro nodes run <type> --param prompt="..." --param provider=flux [--watch]
nodaro nodes run <type> --params-file body.json [--watch] [--poll-interval 1000]
nodaro nodes run generate-image --param prompt="..." [--count 1-4] [--models <id,id,...>] [--watch]--category는input,parameter,ai-image,ai-video,ai-audio,ai-text,processing,composition,output,control,entity,trigger,utility중 하나입니다.nodes get은 노드 타입 하나의 입력 스키마, 즉--param이 받는 필드를 출력합니다.nodes run은 노드 자체의 경로로 요청을 보내며, 대부분의 노드 타입에서는POST /v1/<type>입니다.llm-chat이나 Suno 노드 같은 일부 노드 타입은 별도의 경로가 있으며, CLI가 그 경로를 대신 사용합니다.modify-image나paint-mask처럼 단독으로 실행할 수 없는 노드 타입은 API를 호출하기 전에 실패하며, 메시지가 대신 실행할 것을 알려 줍니다. 노드 실행을 참고하세요.--watch는 응답에 작업 ID가 있으면 작업이 끝날 때까지 폴링합니다.--poll-interval은 폴링 간격을 밀리초 단위로 정합니다. 기본값은 2000입니다.
--param과 --params-file의 문법은 매개변수와 입력 파일에 있습니다.
예를 들어 동영상 깊이는 클립을 가까운 곳은 밝고 먼 곳은 어두운 깊이 동영상으로 바꿉니다.
nodaro nodes run video-depth --param videoUrl=https://cdn.example.com/clip.mp4 --param colormap=turbo --watch한 번의 호출로 여러 이미지
generate-image에서만 --count <n>이 이미지를 14장 만들며, 각 이미지는 별도의 작업입니다. 4개에서 같은 요청을 실행합니다. 둘을 함께 쓰면 --models a,b는 provider 대신 이미지 모델 2--count는 모델마다 적용되며, 최대 8장입니다. 일괄 처리 전체가 내 잔액과 비교되고, 전체가 청구되거나 아예 청구되지 않습니다.
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --count 4 --watch
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --models gpt-image-2,flux-2-max --count 2 --watchCLI는 모든 작업 ID를 모델별로 묶어 출력하고, 일괄 처리 ID도 출력합니다. --watch는 모든 작업이 끝날 때까지 하나하나 따라갑니다. 모두 완료되면 0, 하나라도 실패하거나 취소되면 2, 나머지는 완료되고 일부가 검토를 기다리면 3으로 종료합니다. --json --watch는 모든 최종 상태를 출력합니다. 이 플래그는 --param이나 --params-file의 count, models보다 우선합니다.
모델
nodaro models list [--kind image|video|audio] [--mode <mode>] [--family <vendor>] [--featured] [--json]--mode는t2i,i2v,t2v,tts같은 작업 종류로 거릅니다.--family는Google이나Bytedance같은 모델 제조사로 거릅니다.--featured는 추천 모델만 보여 줍니다.
표에는 각 모델의 ID, 종류, 제품군, 제조사, 모드, 크레딧 등급이 나옵니다. 제조사는 모델을 만든 회사입니다. 추천 모델과, Nodaro가 프롬프트 가이드를 마련한 모델 제품군도 표시됩니다. --json은 전체 기능 명세, 크레딧 가격, 프롬프트 팁을 반환합니다. 각 모델의 maker를 { id, name }으로, 제조사의 logoUrl도 반환하며, 인스턴스가 로고를 게시하지 않으면 logoUrl은 null입니다. 같은 카탈로그는 모델에서 둘러볼 수 있습니다.
결제
이 명령은 요금제와 가격, 내 구독을 읽습니다. 요금제 구매와 변경은 Nodaro 앱에서 합니다.
nodaro billing plans [--base-url <url>] [--json]
nodaro billing subscription [--json]
nodaro billing account [--json]
nodaro billing surface [--base-url <url>] [--json]| 명령 | 보여 주는 내용 |
|---|---|
billing plans | 판매 중인 요금제와 크레딧 팩, 그리고 가격입니다. Nodaro Cloud 전용입니다. 로그인이 필요 없습니다. |
billing subscription | 내 구독과, 내 계정의 권한이 따르는 등급입니다. Nodaro Cloud 전용입니다. |
billing account | 배포 환경의 결제 공급자가 보고하는 내 요금제와 잔액이며, 그 공급자의 단위로 표시됩니다. |
billing surface | 배포 환경의 결제 방식입니다. 사용량을 측정하는지, 비용을 어떤 단위로 표시하는지 알려 줍니다. 로그인이 필요 없습니다. |
plans와 surface는 자격 증명을 보내지 않습니다. --base-url의 인스턴스에 묻고, 없으면 프로필의 인스턴스, 그것도 없으면 https://app.nodaro.ai에 묻습니다. 결제가 없는 셀프 호스팅 인스턴스에서는 plans와 subscription이 404로 응답합니다. 필드는 client.billing을 참고하세요.
피커
피커는 분위기, 프레이밍 같은 크리에이티브 컨트롤 노드입니다. 이 명령은 피커의 유효한 값 카탈로그를 읽습니다. 피커 카탈로그를 참고하세요.
nodaro pickers list [--json]
nodaro pickers get <nodeType> [--full] [--category <c>] [--field <f>] [--json]
nodaro pickers analyze "<text>" [--target <types>] [--instructions <text>] [--model <id>] [--effort <level>] [--json]| 명령 또는 옵션 | 기능 |
|---|---|
pickers list | 모든 피커 노드 타입과 각 타입의 옵션 수, 그리고 이미지가 있는 옵션 수를 나열합니다. |
pickers get | 카탈로그 하나를 반환합니다. 각 옵션에는 id, label, category, term, icon이 있고, 이미지가 있으면 imageUrl도 있습니다. |
--full | 각 옵션의 설명과 그 옵션이 추가하는 프롬프트 조각을 더합니다. |
--category | 단일 차원 피커를 카테고리 하나로 거릅니다. |
--field | 프레이밍의 shotSize처럼 다차원 피커의 차원 하나를 반환합니다. |
pickers analyze | “AI 채우기”입니다. 자유롭게 쓴 설명에서 피커 값을 고릅니다. LLM 호출이며 크레딧이 청구됩니다. |
--target | 채울 피커 노드 타입을 쉼표로 구분한 목록입니다. 기본값은 분석할 수 있는 모든 피커입니다. |
term은 간략 힌트 모드가 프롬프트에 추가하는 짧은 전문 문구입니다. auto나 none처럼 아무것도 추가하지 않는 옵션에서는 비어 있습니다. 인물과 스타일링은 sections도 반환합니다. 각 주제에는 둥근 이미지가 있습니다.
프리셋
프리셋은 노드의 저장된 설정입니다. 이 명령은 내 프리셋, 즐겨찾기, 폴더를 관리하고, 기본 제공 카탈로그를 읽습니다. 프리셋을 참고하세요.
nodaro presets list [--node-type <type>] [--factory [--base-url <url>]] [--json]
nodaro presets create --node-type <type> --name <name> (--data <json> | --data-file <path|->) [--description <text>] [--group <id>] [--tag <t>]... [--preview-url <url>] [--json]
nodaro presets update <id> [--name <name>] [--description <text>] [--data <json> | --data-file <path|->] [--group <id> | --no-group] [--tag <t>]... [--preview-url <url> | --no-preview-url] [--expected-updated-at <iso>] [--json]
nodaro presets delete <id> [--expected-updated-at <iso>] [--json]
nodaro presets export [--node-type <type>] [--output <file>]
nodaro presets import <file|-> [--json]
nodaro presets favorites --node-type <type> [--json]
nodaro presets favorite <presetId> --node-type <type> [--json]
nodaro presets unfavorite <presetId> --node-type <type> [--json]
nodaro presets groups list [--node-type <type>] [--json]
nodaro presets groups create --node-type <type> --name <name> [--kind folder|section] [--sort-order <n>] [--json]
nodaro presets groups update <id> [--name <name>] [--sort-order <n>] [--json]
nodaro presets groups delete <id> [--json]| 명령 또는 옵션 | 기능 |
|---|---|
list --factory | --node-type의 기본 제공 카탈로그를 나열합니다. 로그인이 필요 없습니다. --base-url은 다른 인스턴스에 묻습니다. photos 열은 프리셋이 쓰는 레퍼런스 사진의 수이고, preview는 예시 이미지가 있는지 알려 줍니다. |
list | --factory 없이 쓰면 내 프리셋을 나열합니다. 프로필이 필요합니다. |
create --preview-url | 이 플랫폼에 이미 저장된 이미지입니다. 업로드한 이미지나 완료된 결과입니다. |
update --expected-updated-at, delete --expected-updated-at | 그 시각 이후 프리셋이 바뀌었으면 변경을 거부합니다. |
export | 내 프리셋을 import가 받는 JSON 파일로 씁니다. |
import | 그 파일이나 프리셋의 JSON 목록을 경로 또는 표준 입력에서 읽습니다. |
favorite, unfavorite | 즐겨찾기를 추가하거나 제거합니다. 기본 제공 ID나 내 프리셋 ID를 씁니다. |
groups | 내 폴더와 섹션을 나열하고, 만들고, 이름을 바꾸고, 삭제합니다. groups만 써도 목록이 나옵니다. 폴더를 삭제하면 그 안의 프리셋은 폴더 밖으로 옮겨집니다. |
순서 바꾸기는 편집기에서 드래그로 합니다. 스크립트에서는 SDK의 presets.reorder()를 쓰세요.
팔레트와 무드보드
내 색상과 스타일 레퍼런스를 저장한 다음, generate-image에서 하나를 쓰세요. 팔레트는 direction.colorLook에 palette:<id>로, 무드보드는 direction.style에 moodboard:<id>로 넣습니다. SDK 레퍼런스의 팔레트와 무드보드를 참고하세요.
nodaro palettes list [--limit <n>] [--cursor <c>] [--json]
nodaro palettes get <id> [--json]
nodaro palettes create --name <name> --colors <#hex,#hex,...> [--description <text>] [--json]
nodaro palettes update <id> [--name <name>] [--colors <#hex,...>] [--description <text> | --clear-description] [--json]
nodaro palettes delete <id> [--json]
nodaro moodboards list [--limit <n>] [--cursor <c>] [--json]
nodaro moodboards get <id> [--json]
nodaro moodboards create --name <name> --image <url[|caption]>... [--description <text>] [--json]
nodaro moodboards update <id> [--name <name>] [--description <text> | --clear-description] [--image <url[|caption]>...] [--json]
nodaro moodboards delete <id> [--json]- 팔레트에는 색상이 2~12개 있습니다.
- 무드보드에는 이미지가 1~12장 있습니다. 이미지마다
--image를 반복하고,|뒤에 캡션을 붙일 수 있습니다.update에서--image는 모든 이미지를 바꿉니다. - 무드보드를 삭제해도 연결된 이미지는 그대로 남습니다.
nodaro palettes create --name Harbour --colors "#0F4C5C,#E3B23C,#F28C7A"
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --param 'direction={"colorLook":"palette:<paletteId>"}' --watch카탈로그 팩
배포 환경은 함께 포함한 카탈로그 팩으로 피커 카탈로그를 직접 다듬을 수 있습니다. 이 명령은 그런 팩을 관리합니다. 파일을 대상으로 오프라인에서 작동하며 로그인이 필요 없습니다.
nodaro catalog snapshot --in <file>
nodaro catalog diff-upstream --baseline <f> --upstream <f> --pack <f> [--write <f>]
nodaro catalog validate --pack <file> [--exempt es,fr,...]snapshot은 파일의 전체 상세/v1/catalogs투영을 번역 파일과 함께 JSON으로 출력합니다.diff-upstream은 3방향 병합입니다. 내가 바꾸지 않은 항목에 업스트림의 수정 사항을, 번역된 11개 로캘의 문자열과 함께 반영합니다. 나와 업스트림이 모두 바꾼 항목은 충돌로 보고하고 내 버전을 유지합니다. 업스트림에 새로 생긴 항목과 업스트림에서 삭제된 항목을 나열하며, 스스로 무언가를 추가하지는 않습니다. 충돌이 있으면 코드 2로 종료합니다.validate는 팩 스냅숏에 번역된 11개 로캘의 번역이 모두 있는지 확인하거나,--exempt로 예외를 선언합니다. 예외가 아닌 로캘에 번역이 빠져 있으면 코드 1로 종료합니다.
실행과 작업
실행은 워크플로나 앱을 한 번 실행하는 것입니다. 작업은 이미지 생성 한 번처럼 노드 하나가 하는 일입니다. nodaro nodes run은 작업을 반환합니다.
nodaro executions get <id> [--watch] [--json]
nodaro executions cancel <id> [--mode cancelled|stopping]
nodaro jobs list [--status <s,s>] [--type <t,t>] [--origin <app>] [--favorited | --no-favorited] [--rating good|bad|rated|unrated] [--limit <n>] [--cursor <c>] [--json]
nodaro jobs get <id> [--json]
nodaro jobs rate <id> good|bad|clear [--json]
nodaro jobs cancel <id> [--json]executions get --watch는 실행이 완료, 실패, 취소될 때까지 폴링합니다.- 기본값인
executions cancel --mode cancelled는 실행을 즉시 멈춥니다.--mode stopping은 현재 단계의 노드가 먼저 끝나도록 합니다. jobs list는 내 작업을 최신순으로 나열합니다.--status와--type은 쉼표로 구분한 목록을 받습니다.--no-favorited는 즐겨찾기하지 않은 작업만 남깁니다. 모든 필터는 서로 조합됩니다.jobs rate는 내 작업 하나에 평가를 매깁니다.clear는 평가를 제거합니다.
갤러리
nodaro gallery browse [--type image|video|audio] [--user <id> | --favorites] [--limit <n>] [--cursor <c>] [--json]
nodaro gallery favorite <jobId> [--json]
nodaro gallery favorites [--json]browse --user는 한 사람의 작업물을 보여 줍니다. 내 ID를 쓰면 비공개 항목도 포함됩니다.browse --favorites는 내가 즐겨찾기한 내 항목만 보여 줍니다.favorite는 전환합니다. 작업을 즐겨찾기에 추가하거나, 이미 즐겨찾기라면 제거합니다.favorites는 즐겨찾기한 작업 ID를 최신순으로 출력합니다.
Webhook
Webhook 엔드포인트는 내 작업이 job.completed 또는 job.failed로 끝날 때마다 Nodaro가 서명된 POST로 호출하는 https 주소입니다. 이벤트, 본문, 서명 확인 방법은 Webhook을 참고하세요.
nodaro webhooks list [--json]
nodaro webhooks get <id> [--json]
nodaro webhooks create --url <https-url> [--events job.completed,job.failed] [--description <text>] [--json]
nodaro webhooks update <id> [--url <https-url>] [--events <list>] [--description <text> | --clear-description] [--enable | --disable] [--json]
nodaro webhooks delete <id> [--json]
nodaro webhooks rotate-secret <id> [--grace <seconds>] [--json]
nodaro webhooks deliveries <id> [--status pending|delivered|failed] [--limit <n>] [--cursor <c>] [--json]
nodaro webhooks test <id> [--wait] [--poll-interval <ms>] [--json]| 명령 | 기능 |
|---|---|
create | 엔드포인트를 등록하고 서명 시크릿(whsec_…)을 한 번만 출력합니다. 잘 보관하세요. --json을 쓰면 출력은 { data, secret }입니다. |
update --enable | 엔드포인트를 켭니다. 50번 연속 전송이 최종 실패하면 일어나는 자동 꺼짐도 해제합니다. |
delete | 엔드포인트와 그 전송 기록을 삭제합니다. |
rotate-secret | 새 시크릿을 한 번 출력합니다. 이전 시크릿은 --grace초 동안 계속 서명합니다. 기본값은 하루이며, 0이면 이전 시크릿이 즉시 멈춥니다. |
deliveries | 전송 기록을 최신순으로 나열합니다. |
test | 엔드포인트가 꺼져 있어도 ping을 한 번 보냅니다. --wait는 그 전송을 따라가며 서버가 어떻게 응답했는지 보여 줍니다. |
동영상 생성 Pro 실행 제어
동영상 생성 Pro는 긴 동영상을 세그먼트 하나씩 만들기 때문에, 실행을 멈췄다가 나중에 이어 갈 수 있습니다. Nodaro Cloud에서 실행되며, 셀프 호스팅 설치는 Nodaro Cloud 연결을 통해 실행합니다.
nodaro video-pro stop <jobId> [--json]
nodaro video-pro continue <jobId> [--from-segment N] [--watch] [--poll-interval <ms>] [--json]stop은 실행을 정상적으로 끝냅니다. 완성된 세그먼트는 유지되어 전달되고, 남은 예약분은 환불됩니다. 진행 중이던 세그먼트는 그대로 청구됩니다.continue는 세그먼트N부터 다시 생성하는 새 작업을 시작합니다. 기본값은 전달되지 않은 첫 번째 세그먼트입니다. 다시 생성한 세그먼트와 고정 Pro 요금만 지불합니다.
프롬프트 마법사
프롬프트 마법사는 대략적인 아이디어를 generate-image 같은 노드 타입에 맞는 최적화된 프롬프트로 바꿉니다.
nodaro prompt wizard [--node-type <type>] [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>]
nodaro prompt analyze --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
nodaro prompt generate --node-type <type> --selection category=value [--selection ...] [--original-prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
nodaro prompt enhance --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]| 명령 | 기능 |
|---|---|
prompt wizard | 터미널에서 안내 질문을 합니다. --node-type이 없으면 먼저 어느 노드용 프롬프트인지 묻습니다. 대화형 터미널이 필요합니다. |
prompt analyze | 스크립트용으로 마법사의 안내 질문을 반환합니다. |
prompt generate | 내 답변으로 최종 프롬프트를 만듭니다. 답변마다 --selection category=value를 한 번씩 반복하세요. |
prompt enhance | 질문 없이 한 번에 프롬프트를 다시 씁니다. |
--reasoning-effort는none,low,medium,high,xhigh,max중 하나입니다. 지원 여부는 모델에 따라 다르며, 지원하지 않거나 생략한 값은 모델의 기본값을 씁니다.xhigh와max는 한 등급 위로 청구되지만, 프리미엄 모델은 프리미엄 가격 그대로입니다. Claude 모델에서는 어떤 추론 강도든 Anthropic 자체 API에서 실행되며, 한 등급 더 위로 청구됩니다.--advanced는 Gemini와 Claude 모델에서 작동합니다. 요청을 모델 제작사의 자체 API에서 실행합니다.--temperature,--max-tokens, 전체 추론 범위를 쓸 수 있게 하며, 한 등급 위로 청구됩니다. 프리미엄 모델은 premium-direct 가격이 됩니다.
샷
샷은 저장된 빌더 상태로, 피커 선택, 프롬프트, 고른 모델, 에셋 레퍼런스를 담습니다. 샷으로 공유 링크와 원클릭 리믹스가 가능합니다.
nodaro shots get <id> [--json]
nodaro shots create [--file shot.json] [--visibility private|public] [--json]
nodaro shots update <id> [--file fields.json] [--visibility private|public] [--json]
nodaro shots delete <id>--visibility public을 설정하지 않으면 새 샷은 비공개입니다. 공개 샷의 ID를 가진 사람은 누구나 그 샷을 읽을 수 있습니다.
Recast
Recast는 분석한 동영상을 내 출연진으로 다시 생성합니다. 직접 쓴 스크립트를 가져와 Recast로 렌더링할 수도 있습니다. recast 명령은 Nodaro Cloud에서만 작동합니다.
nodaro recast skill
nodaro recast validate --file script.json [--json]
nodaro recast import --file script.json --rights-attested [--json]
nodaro recast estimate --analysis-job <id> [--fidelity faithful] [--resolution <r>] [--segment-sec <n>] [--json]
nodaro recast create --workflow <id> --analysis-job <id> [--rights-attested] [--fidelity faithful] [--resolution <r>] [--segment-sec <n>] [--json]
nodaro recast start <recastId> [--segment-sec <n>] [--json]
nodaro recast status <recastId> [--json]| 명령 | 기능 | 비용 |
|---|---|---|
recast skill | 스크립트 작성 가이드를 Markdown으로 출력합니다. | 무료 |
recast validate | 스크립트를 검사합니다. 스크립트가 유효하지 않으면 코드 1로 종료합니다. | 무료 |
recast import | 검증한 스크립트를 완료된 분석으로 가져옵니다. --rights-attested는 스크립트가 내 작업물임을 밝힙니다. 직접 작성한 Recast는 faithful 충실도로, 쓴 그대로 렌더링됩니다. | 무료 |
recast estimate | 실행 비용을 크레딧으로 견적합니다. | 무료 |
recast create | 계획을 구매하고 실행 ID를 반환합니다. 먼저 estimate를 실행하세요. | 크레딧 |
recast start | 계획된 실행을 렌더링합니다. 두 번 실행해도 문제가 없습니다. | 계획에 포함 |
recast status | 상태와 나를 기다리는 대화형 단계를 보여 줍니다. | 무료 |
CLI 1.24.0의 --segment-sec. Recast 라우트는 세그먼트 설정에 묶음 이름을 받습니다. scenes-max(이음매가 가장 적음), scenes(더 짧은 파트), max(모델이 허용하는 가장 긴 파트) 중 하나입니다. CLI 1.24.0은 --segment-sec을 숫자로 보내므로 묶음 이름을 보낼 수 없고, 10 같은 숫자는 400 validation_error로 거부됩니다. 이 옵션을 빼면 서버가 기본값인 scenes-max를 씁니다. 다른 묶음을 고르려면 Recast API를 호출하세요.
Recast가 작동하는 방식은 Recast에서, 이 명령 뒤에 있는 엔드포인트는 Recast API에서 확인하세요.
자주 묻는 질문
Nodaro CLI로 실행할 수 있는 모든 노드 타입을 보려면 어떻게 하나요?
nodaro nodes list를 실행하세요. 목록을 거르려면 --category ai-image처럼 카테고리를 추가하고, 노드 타입 하나의 전체 입력 스키마를 보려면 nodaro nodes get generate-image를 실행하세요.
CLI에서 워크플로의 일부 노드만 실행하려면 어떻게 하나요?
nodaro workflows run에 --node를 추가하고, 그 뒤에 노드 ID를 공백으로 구분해 적으세요. 그 노드들만 실행됩니다.
터미널에서 실행 중인 워크플로를 멈추려면 어떻게 하나요?
실행 ID와 함께 nodaro executions cancel을 실행하세요. 기본 모드인 cancelled는 실행을 즉시 멈춥니다. --mode stopping을 쓰면 현재 단계의 노드가 먼저 끝납니다.
CLI 명령 하나로 이미지를 여러 장 생성하려면 어떻게 하나요?
nodaro nodes run generate-image에 --count(이미지 1~4장)를 붙이거나, 이미지 모델 ID 2~4개와 함께 --models를 붙여 실행하세요. --watch를 추가하면 모든 작업이 끝날 때까지 하나하나 따라갑니다.
Nodaro Cloud가 필요한 Nodaro CLI 명령은 무엇인가요?
recast 명령은 Nodaro Cloud에서만 실행됩니다. 동영상 생성 Pro 실행 제어는 셀프 호스팅 설치에서도 Nodaro Cloud 연결을 통해 작동합니다.
작업이 끝날 때 내 서버로 호출을 받으려면 어떻게 하나요?
nodaro webhooks create --url에 내 https 주소를 붙여 실행하세요. CLI는 엔드포인트의 서명 시크릿을 한 번만 출력합니다. 엔드포인트 ID와 --wait를 붙여 nodaro webhooks test를 실행하면 서버가 어떻게 응답했는지 볼 수 있습니다.
관련 문서
CLI
Nodaro CLI를 npm이나 독립 실행형 바이너리로 설치하고, 인스턴스마다 한 번 로그인한 뒤 터미널이나 CI 작업에서 워크플로, 앱, 단일 노드를 실행하세요.
매개변수와 입력 파일
Nodaro CLI가 반복된 --param과 --input의 key=value 쌍을 요청 본문으로 바꾸는 방식, 값의 타입이 정해지는 규칙, 대신 JSON 파일을 보낼 때를 설명합니다.
출력과 종료 코드
Nodaro CLI 출력을 표나 JSON으로 읽고, --watch로 실행이 끝날 때까지 따라가고, 스크립트에서 실패, 취소, 보류된 실행의 종료 코드로 분기하세요.
에셋 명령
Nodaro CLI로 캐릭터, 장소, 오브젝트를 만들고, 검색하고, 학습시키고, 대표 이미지를 승인하고, 각 에셋에 베리언트와 모션 클립을 추가하는 방법입니다.
워크플로
API로 저장된 Nodaro 워크플로를 새 입력값으로 실행하고 결과를 기다리거나 폴링하세요. 워크플로 목록, 생성, 수정, 내보내기, 이동도 다룹니다.
최종 업데이트