Nodaro ドキュメントCLI
コマンド
プロジェクト、ワークフローと共有、アプリ、ノード、モデル、ピッカー、実行、ジョブ、プロンプト、Recast のための、Nodaro CLI のコアコマンドすべてと、そのオプションです。
コアとなる Nodaro CLI コマンドは、プロジェクトとワークフローの管理、公開済みアプリと単一ノードの実行、実行とジョブの確認を行います。このページでは、それぞれのコマンドをオプションとともに一覧にしています。アセット、メディア、ワークスペースのコマンドには専用のページがあり、最初のテーブルに記載しています。
どの例も、CLI をインストールしてログイン済みであることを前提としています。
コマンドグループ
| グループ | 内容 | 説明の場所 |
|---|---|---|
auth | ログイン、プロファイルの表示と削除 | CLI |
projects | プロジェクトの作成、読み取り、更新、削除 | このページ |
workflows | ワークフローの管理、エクスポート、インポート、実行、共有 | このページ |
apps | 公開済みアプリの閲覧と実行 | このページ |
nodes | ノードタイプの一覧表示と単一ノードの実行 | このページ |
models | モデルカタログの閲覧 | このページ |
pickers | ピッカーカタログの読み取りと、説明文からのピッカーの自動入力 | このページ |
catalog | デプロイ環境のカタログパックの、オフラインでの保守 | このページ |
executions、jobs | 実行の確認とキャンセル | このページ |
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]ワークフロー
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は、任意のアドレスを受け付けます。相手はまだアカウントを持っている必要はありません。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は、1 ページあたり最大 50 個のアプリを返します。あるページの--cursorを渡すと、次のページを取得できます。apps getは、アプリの入力名を表示します。これを--inputのキーとして使います。--inputは、アプリの入力を 1 つ設定します。入力ごとに繰り返すか、--params-fileで JSON ファイルにまとめて指定します。--overrideは、その実行に限って、ノードの生のフィールドを<nodeId>.<field>=<value>の形で設定します。promptPrefixなど、アプリが公開していないフィールドも設定できます。プロンプトの前後のテキストを参照してください。
オーバーライドで、送信系のノードがデータを送信または取得する宛先（Webhook 出力（Webhook Output）のアドレスなど）を変更することはできません。そのような実行は、代わりに 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]--categoryは、input、parameter、ai-image、ai-video、ai-audio、ai-text、processing、composition、output、control、entity、trigger、utilityのいずれかです。nodes getは、1 つのノードタイプの入力スキーマ、つまり--paramが受け付けるフィールドを表示します。--watchは、レスポンスにジョブ ID がある場合、ジョブが終わるまでポーリングします。--poll-intervalは、ポーリングの間隔をミリ秒単位で設定します。デフォルトは 2000 です。
--param と --params-file の書式は、パラメーターと入力ファイルにあります。
モデル
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 は、完全な機能表、クレジットの料金、プロンプトのヒントを返します。同じカタログは、モデルでも閲覧できます。
ピッカー
ピッカーは、ムード（Mood）やフレーミング（Framing）のような、クリエイティブコントロールのノードです。これらのコマンドは、有効な値のカタログを読み取ります。ピッカーカタログを参照してください。
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 | 1 つのカタログを返します。各オプションには id、label、category、term、icon があり、画像がある場合は imageUrl も付きます。 |
--full | 各オプションの説明と、それが追加するプロンプトの断片を加えます。 |
--category | 単一次元のピッカーを、1 つのカテゴリーに絞り込みます。 |
--field | フレーミングの shotSize のような、多次元ピッカーの 1 つの次元を返します。 |
pickers analyze | AI Fill：自由記述のテキストから、ピッカーの値を選びます。LLM 呼び出しで、クレジットが課金されます。 |
--target | 入力するピッカーのノードタイプを、カンマ区切りで指定します。デフォルトは、解析できるすべてのピッカーです。 |
term は、プロンプトヒントがコンパクトのときにプロンプトに追加される、短い専門用語です。auto や none のような、何も追加しないオプションでは空です。人物（Person）とスタイリング（Styling）は、sections も返します。それぞれのトピックには、丸い画像が付きます。
カタログパック
デプロイ環境は、同梱されたカタログパックで、ピッカーカタログを独自に整備できます。これらのコマンドは、そのようなパックを保守します。ファイルに対してオフラインで動作し、ログインは不要です。
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 で終了します。
実行とジョブ
実行（execution）は、ワークフローまたはアプリの 1 回の実行です。ジョブ（job）は、1 回の画像生成のような、1 つのノードの作業です。nodaro nodes run は、ジョブを返します。
nodaro executions get <id> [--watch] [--json]
nodaro executions cancel <id> [--mode cancelled|stopping]
nodaro jobs get <id> [--json]
nodaro jobs cancel <id> [--json]executions get --watchは、実行が完了、失敗、キャンセルのいずれかになるまでポーリングします。- デフォルトの
executions cancel --mode cancelledは、実行を即座に停止します。--mode stoppingでは、現在の階層のノードを先に完了させます。
動画生成 Pro の実行制御
動画生成 Pro（Generate Video Pro）は、長い動画を 1 セグメントずつ作るので、実行を停止して後から続けられます。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>]
nodaro prompt analyze --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--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>] [--json]
nodaro prompt enhance --node-type <type> --prompt "..." [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--json]| コマンド | 内容 |
|---|---|
prompt wizard | ターミナルで、ガイド付きの質問をします。--node-type を指定しない場合、最初にどのノード向けのプロンプトかを尋ねます。対話形式のターミナルが必要です。 |
prompt analyze | スクリプト向けに、ウィザードのガイド付きの質問を返します。 |
prompt generate | 回答から最終的なプロンプトを組み立てます。--selection category=value を、回答ごとに 1 回繰り返します。 |
prompt enhance | 質問なしで、プロンプトを 1 ステップで書き直します。 |
--reasoning-effortは、none、low、medium、high、xhigh、maxのいずれかです。対応状況はモデルによって異なり、非対応または未指定の場合はモデルのデフォルトが使われます。xhighとmaxは、1 段階上の料金になります。--advancedは、Gemini モデルでのみ動作します。--temperature、--max-tokens、そして推論の全範囲を有効にし、1 段階上の料金になります。
ショット
ショットは、保存されたビルダーの状態です。ピッカーの選択内容、プロンプト、選んだモデル、アセットのリファレンスが含まれます。ショットは、共有リンクとワンクリックのリミックスを支えています。
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 | 計画済みの実行をレンダリングします。2 回実行しても問題ありません。 | プランに含まれる |
recast status | ステータスと、対応待ちの対話的なステップを表示します。 | 無料 |
recast の仕組みについては Recast を、これらのコマンドの背後にあるエンドポイントについては Recast API を参照してください。
よくある質問
関連ページ
CLI
Nodaro CLI を npm またはスタンドアロンのバイナリでインストールし、インスタンスごとに 1 回ログインして、ターミナルや CI ジョブからワークフロー、アプリ、単一ノードを実行します。
パラメーターと入力ファイル
Nodaro CLI が、繰り返し指定した --param と --input の key=value をリクエストボディに変換する仕組み、値の型の決まり方、JSON ファイルを使うべき場面を説明します。
出力と終了コード
Nodaro CLI の出力をテーブルまたは JSON で読み取り、--watch で実行の終了まで追跡し、失敗・キャンセル・保留の終了コードでスクリプトを分岐させます。
アセットコマンド
Nodaro CLI でキャラクター、ロケーション、オブジェクトを作成し、メイン画像を生成して承認し、各アセットにバリエーションとモーションクリップを追加します。
ワークフロー
API から保存済みの Nodaro のワークフローを実行し、新しい入力値を渡して、結果を待つかポーリングします。ワークフローの一覧表示、作成、更新、エクスポート、移動も行えます。
最終更新