NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較
CLI

コマンド

プロジェクト、ワークフロー、アプリ、ノード、モデル、プリセット、パレット、ジョブ、ギャラリー、Webhook、課金、Recast のための、Nodaro CLI のコアコマンドすべてと、そのオプションです。

コアとなる Nodaro CLI コマンドは、プロジェクトとワークフローの管理、公開済みアプリと単一ノードの実行、実行とジョブの確認を行います。このページでは、それぞれのコマンドをオプションとともに一覧にしています。アセット、メディア、ワークスペースのコマンドには専用のページがあり、最初のテーブルに記載しています。

どの例も、CLI をインストールしてログイン済みであることを前提としています。

コマンドグループ

グループ内容説明の場所
authログイン、プロファイルの表示と削除CLI
projectsプロジェクトの作成、読み取り、更新、削除このページ
sessionsプロジェクト内の生成セッションこのページ
workflowsワークフローの管理、エクスポート、インポート、実行、共有このページ
apps公開済みアプリの閲覧と実行このページ
nodesノードタイプの一覧表示と単一ノードの実行このページ
modelsモデルカタログの閲覧と ID の料金の確認このページ
billingプランと価格、サブスクリプション、クレジットの使用状況と履歴このページ
pickersピッカーカタログの読み取りと、説明文からのピッカーの自動入力このページ
presets自分のノードプリセット、お気に入り、フォルダー、および標準のカタログこのページ
palettes、moodboards画像生成で使う、自分のカラーパレットとムードボードこのページ
catalogデプロイ環境のカタログパックの、オフラインでの保守このページ
executions、jobs実行の確認、絞り込み、評価、キャンセルこのページ
gallery公開ギャラリーとお気に入りこのページ
webhooksジョブが終わったときに Nodaro が呼び出すエンドポイントこのページ
video-pro動画生成 Pro の実行の停止と継続このページ
prompt大まかなアイデアからの、最適化されたプロンプトの作成このページ
shotsショットの共有レコードの作成と読み取りこのページ
recastRecast の実行の計画とレンダリング、またはスクリプトのインポートこのページ
trends既製の Video Remake のレシピを、自分の写真で実行このページ
video-remakeNodaro Prism のドラフトをフル品質で仕上げるこのページ
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] [--cover <jobId> | --auto-cover] [--json]
nodaro sessions import <id> --jobs <id,id,...> [--json]
nodaro sessions remove <id> <jobId> [--json]
nodaro sessions delete <id> [--json]
  • import は、ジョブをセッションにリンクします。すべて成功するか、すべて失敗するかのどちらかです。自分のものでないジョブが 1 件でもあると、呼び出し全体が失敗します。
  • remove は、リンクだけを削除します。ジョブは残り、それを持つほかのセッションも残ります。
  • delete は、セッションを削除します。そのジョブは残ります。
  • update --cover は、プレビューの先頭にするセッションのアイテムを 1 つ選びます。--auto-cover で、最新のアイテムに戻ります。

ワークフロー

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]
nodaro workflows run <id> --continue-from <executionId> --from-failed [--node n1 n2 ...] [--idempotency-key <key>] [--watch]
nodaro workflows run <id> --continue-from <executionId> --node n1 n2 ... [--override n1.quality=final ...] [--watch]
nodaro workflows run <id> --next <json|file|-> [--idempotency-key <key>] [--watch]
nodaro workflows render-final <id> --from <executionId> [--render <nodeId>] [--estimate] [--watch] [--json]
オプション内容
create --fileエクスポートしたワークフローバンドルから、ワークフローを作成します。
update --fileJSON ファイル内のノード、エッジ、設定を、ワークフローに書き込みます。
export --with-assetsそのワークフローが使うキャラクター、オブジェクト、ロケーションのデータを、バンドルに追加します。
export --outputバンドルを表示する代わりに、ファイルに書き込みます。
run --nodeスペースで区切って指定したノード ID だけを実行します。
run --watch実行が終わるまで追跡します。
run --continue-from --from-failed失敗した実行を、止まった所から続けます。--node を省略すると、最初の実行が開始されたときのノードと、失敗したままのすべてのノードが対象になります。--node を指定すると、指定したノードはすべて数えられます。チェーンのどの実行でも実行されなかったノードは、実行されて課金されます。ソース、トリガー、スキップされたノードは実行されません。失敗した実行を続けるを参照してください。
run --continue-from --node完了した実行を続け、指定したノードだけを実行します。ほかのすべてのノードは、その実行の結果を引き渡します。
run --overrideこの実行に限ったノードごとの設定で、nodeId.field=value の形で書きます。複数の設定には、繰り返して指定します。
run --idempotency-keyIdempotency-Key ヘッダーとして送信されます(8 文字以上)。同じキーを 2 回送っても、開始される実行は 1 回です。
run --nextcontinuation_preview_pending の応答の next を、そのまま送信します。--from-failed が拒否されると、保留中の実行を仕上げるコマンドが表示されます。
render-finalプレビューで止まった実行を Final でレンダリングし、その後のすべてのノードを実行して、その実行を続けます。--render のデフォルトは、ワークフローにある唯一のレンダーです。--estimate はノードとクレジットを見積もるだけで、何も実行しません。

バンドルの形式は、エディターがエクスポートするものと同じです。ワークフローのインポートとエクスポートを参照してください。

ワークフローの共有と移動

これらのコマンドは、組織とワークスペースのあるインスタンスで動作します。

nodaro workflows share <id> [--visibility workspace|private] [--json]
nodaro workflows move <id> --project <projectId> [--json]
nodaro workflows shared-with-me [--json]
nodaro workflows mcp-conversations [--month YYYY-MM] [--source claude,claude-code,chatgpt] [--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 が返されます。
  • mcp-conversations は、1 か月分の MCP 会話を一覧表示します。各会話は、アシスタントが組み立てたワークフローです。デフォルトの月は、会話がある最新の月です。--source で、一部のアシスタントだけを残します。MCP 会話がワークフローになる仕組みを参照してください。
  • 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>
nodaro apps run-retry <slug> <runId> [--dry-run] [--app-version <n>] [--watch] [--json]
  • apps list は、1 ページあたり最大 50 個のアプリを返します。あるページの --cursor を渡すと、次のページを取得できます。
  • apps get は、アプリの入力名を表示します。これを --input のキーとして使います。
  • --input は、アプリの入力を 1 つ設定します。入力ごとに繰り返すか、--params-file で JSON ファイルにまとめて指定します。
  • apps run-retry は、失敗した実行を止まった所から再試行します。完了しなかったステップだけが実行され、それらの分だけが課金されます。完了したステップは、それぞれの結果を引き渡します。その実行が実行したバージョンで、その実行が適用した入力を使って実行され、独自の入力は受け付けません。失敗した実行を再試行するを参照してください。
  • --dry-run は、再試行で実行されるステップと課金額を一覧表示し、何も開始しません。
  • --app-version は、再試行で実行されると想定するアプリのバージョンです。デフォルトはアプリの最新バージョンです。実行のあとでアプリが変更されている場合、再試行は app_run_version_changed で拒否されます。その場合、CLI は 2 つの進め方を表示します。nodaro apps run で最初からやり直すか、--app-version <そのバージョン> で実行自体のバージョンのまま続けるかです。失敗ではなく停止された実行は、最初からやり直されます。
  • --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]
nodaro nodes run generate-video|text-to-video ... [--reference-task-type auto|reference|edit|extend]
  • --category は、input、parameter、ai-image、ai-video、ai-audio、ai-text、processing、composition、output、control、entity、trigger、utility のいずれかです。
  • nodes get は、1 つのノードタイプの入力スキーマ、つまり --param が受け付けるフィールドを表示します。
  • nodes run は、ノード自身のルートに POST します。ほとんどのノードタイプでは 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

1 回の呼び出しで複数の画像

generate-image に限り、--count <n> で 1〜4 枚の画像を、それぞれ別のジョブとして作成します。--models a,b は、provider の代わりに、2〜4 個の画像モデルで同じリクエストを実行します。両方を指定すると、--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 --watch

CLI は、すべてのジョブ ID をモデルごとにまとめて、バッチ ID とともに表示します。--watch は、各ジョブが確定するまで、すべてのジョブを追跡します。すべて完了した場合は 0、いずれかが失敗またはキャンセルされた場合は 2、それ以外が完了し、一部がレビュー待ちの場合は 3 で終了します。--json --watch は、すべての最終的な状態を表示します。これらのフラグは、--param や --params-file の count と models より優先されます。

動画のリファレンスメディアの用途

generate-video と text-to-video では、--reference-task-type <auto|reference|edit|extend> がボディの referenceTaskType を設定します。CLI は、API を呼び出す前に、値がこの 4 つのいずれかであることを確認します。モデルとリクエストがこの値を使うかどうかはプラットフォームが決め、この値を受け付けないモデルは無視します。Seedance 2.5 のリファレンスタスクタイプを参照してください。このフラグは、--param や --params-file の referenceTaskType より優先され、--param referenceTaskType=edit もそのまま使えます。ほかのノードタイプは、video-to-video も含めてこのフラグを拒否します。そこでは編集が常に編集として実行されるためです。

nodaro nodes run generate-video --params-file body.json --reference-task-type extend --watch

モデル

nodaro models list [--kind image|video|audio] [--mode <mode>] [--family <vendor>] [--featured] [--json]
nodaro models cost <id…> [--json]
  • --mode は、t2i、i2v、t2v、tts のような操作で絞り込みます。
  • --family は、Google や Bytedance のようなモデルの開発元で絞り込みます。
  • --featured は、注目のモデルだけを表示します。

このテーブルには、各モデルの ID、種類、ファミリー、開発元、モード、クレジットのティアが表示されます。開発元は、モデルを作った企業です。インスタンスが独自のラベルで提供するモデルでは - です。テーブルでは、注目のモデルと、Nodaro がプロンプトのガイダンスを用意しているモデルファミリーにも印が付きます。--json は、完全な機能表、クレジットの料金、プロンプトのヒントを返します。また、各モデルの maker を { id, name }(独自ラベルのモデルにはありません)として、開発元の logoUrl とともに返します。インスタンスがロゴを公開していない場合、logoUrl は null です。同じカタログは、モデルでも閲覧できます。

models cost は、POST /v1/credits/model-costs から、各 ID に請求される料金を表示します。ID は、モデル ID、クレジット ID、または従量課金の LLM の料金キー <feature>:<model>[:direct | :effort-<level>] です。従量課金の LLM の呼び出しは使ったトークンに応じて課金されるため、その数値は見積もりで、≈N と表示されます。料金のない ID には、- とその理由が表示されます。LLM の呼び出しを参照してください。

課金

これらのコマンドは、プランと価格、サブスクリプション、およびクレジットの使用状況と履歴を読み取ります。プランの購入と変更は、Nodaro アプリで行います。

nodaro billing plans [--base-url <url>] [--json]
nodaro billing subscription [--json]
nodaro billing account [--json]
nodaro billing surface [--base-url <url>] [--json]
nodaro billing summary [--since <when>] [--until <when>] [--bucket day|week|month] [--json]
nodaro billing history [--kind <k>] [--model <id>] [--since <iso>] [--until <iso>] [--search <words>] [--limit <n>] [--cursor <c>] [--csv] [--json]
コマンド表示する内容
billing plans販売中のプランとクレジットパック、およびその価格です。Nodaro Cloud 限定です。ログインは不要です。
billing subscriptionサブスクリプションと、アカウントの利用権限が従うティアです。Nodaro Cloud 限定です。
billing accountデプロイメントの課金プロバイダーが報告する、プランと残高です。単位はそのプロバイダーのものです。
billing surfaceデプロイメントの課金方法です。使用量を計測するかどうかと、料金を表示する単位です。ログインは不要です。
billing summary期間内のクレジットの使用状況です(デフォルトは直近 30 日)。合計、モデル別、カテゴリ別、時系列、セッション別、ワークフロー別に表示します。Nodaro Cloud のみです。
billing history残高のすべての動きを、新しい順に、それぞれの後の残高とともに表示します。--csv は、絞り込んだ履歴全体を CSV で出力します。Nodaro Cloud のみです。

plans と surface は、認証情報を送りません。--base-url のインスタンス、なければプロファイルのインスタンス、それもなければ https://app.nodaro.ai に問い合わせます。課金のないセルフホスティングのインスタンスでは、plans と subscription は 404 を返します。フィールドについては、client.billing を参照してください。summary と history が読み取る内容は、使用状況の集計と残高のすべての動きを参照してください。

ピッカー

ピッカーは、ムードやフレーミングのような、クリエイティブコントロールのノードです。これらのコマンドは、有効な値のカタログを読み取ります。ピッカーカタログを参照してください。

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 get1 つのカタログを返します。各オプションには id、label、category、term、icon があり、画像がある場合は imageUrl も付きます。
--full各オプションの説明と、それが追加するプロンプトの断片を加えます。
--category単一次元のピッカーを、1 つのカテゴリーに絞り込みます。
--fieldフレーミングの shotSize のような、多次元ピッカーの 1 つの次元を返します。
pickers analyzeAI Fill(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 で使います。パレットは palette:<id> として direction.colorLook に、ムードボードは moodboard:<id> として direction.style に入れます。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 で終了します。

実行とジョブ

実行は、ワークフローまたはアプリの 1 回の実行です。ジョブは、1 回の画像生成のような、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>] [--source <s,s>] [--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 rename <id> <title> [--json]
nodaro jobs rename <id> --clear [--json]
nodaro jobs cancel <id> [--json]
  • executions get --watch は、実行が完了、失敗、キャンセルのいずれかになるまでポーリングします。
  • デフォルトの executions cancel --mode cancelled は、実行を即座に停止します。--mode stopping では、現在の階層のノードを先に完了させます。
  • jobs list は、自分のジョブを新しい順に一覧表示します。--status、--type、--source は、カンマ区切りのリストを受け付けます。--source mcp は、Claude や ChatGPT などの MCP クライアントが作成したものを一覧表示します。--no-favorited は、お気に入りにしていないジョブを残します。どのフィルターも、ほかのフィルターと組み合わせられます。
  • jobs rate は、自分のジョブの 1 つに評価を付けます。clear で評価を削除します。
  • jobs rename は、自分のジョブの 1 つに、120 文字までの 1 行の名前を付けます。名前は title として読み取れます。--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 は、1 人の作品を表示します。自分の 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 秒の間、署名に使われ続けます。デフォルトは 1 日で、0 にすると古いシークレットはすぐに無効になります。
deliveries配信ログを新しい順に一覧表示します。
testエンドポイントが無効になっていても、ping を 1 回だけ送ります。--wait はその配信を追跡し、サーバーがどう応答したかを表示します。

動画生成 Pro の実行制御

動画生成 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>] [--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 を、回答ごとに 1 回繰り返します。
prompt enhance質問なしで、プロンプトを 1 ステップで書き直します。
  • --reasoning-effort は、none、low、medium、high、xhigh、max のいずれかです。対応状況はモデルによって異なり、非対応または未指定の場合はモデルのデフォルトが使われます。呼び出しは使ったトークンに応じてモデルの単価で課金されるため、強度を上げると、書かれるトークンの分だけ高くなります。Claude モデルでは、どの推論の強度でも Anthropic 自身の API で、そのレーンの単価で実行されます。
  • --advanced は、Gemini と Claude のモデルで動作します。リクエストをモデル開発元の API で直接実行します。--temperature、--max-tokens、そして推論の全範囲を有効にします。呼び出しは、そのレーンの単価で課金されます。

ショット

ショットは、保存されたビルダーの状態です。ピッカーの選択内容、プロンプト、選んだモデル、アセットのリファレンスが含まれます。ショットは、共有リンクとワンクリックのリミックスを支えています。

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ステータスと、対応待ちの対話的なステップを表示します。無料

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 を参照してください。

トレンドは、既製の Video Remake のレシピです。人物、ペット、商品、場所のスロットを持つ短いクリップで、スロットを自分の写真で埋めます。トレンドのコマンドは、Nodaro Cloud でのみ動作します。

nodaro trends list [--search <text>] [--tag <tag>] [--favorites] [--locale <l>] [--limit <n>] [--cursor <c>] [--json]
nodaro trends get <slug> [--locale <l>] [--json]
nodaro trends estimate <slug> --slot <key>=<url>[,<url>] [--slot ...] [--choice <key>.<chip>=new|original] [--example <n>] [--details "…"] [--preview] [--resolution 480p|720p|1080p] [--draft] [--json]
nodaro trends run <slug> [the estimate options] [--session <id>] [--idempotency-key <key>] [--json]
nodaro trends runs [--trend <slug>] [--limit <n>] [--cursor <c>] [--json]
nodaro trends favorite <slug>
nodaro trends unfavorite <slug>
コマンド内容料金
trends list公開済みのトレンドを一覧表示します。--limit の範囲は 1〜60 です。無料
trends getトレンドのスロット(キー、種類、必須かどうか)、例、プレビュー、エンジン、解像度を表示します。無料
trends estimate実行の見積もりを出します。おおよそ何クレジットかかるか、実行中に何クレジットが確保されるかを示します。無料
trends run実行を開始し、ジョブ ID を表示します。nodaro jobs get <id> で追跡します。先に estimate を実行してください。クレジット
trends runs自分のトレンドの実行を、新しい順に一覧表示します。クレジットの列は、精算後に各実行に課金された額で、実行したすべてのステップ(リファレンスの準備、マスク、動画)を含みます。実行自身の確保が精算されるまでは空です。無料
trends favorite、trends unfavoriteトレンドをお気に入りに追加するか、お気に入りから外します。無料
  • --slot はスロットごとに 1 回ずつ繰り返し、それぞれ 1〜3 枚の写真を指定します。写真は新しい http または https の URL が始まる位置で区切られるので、カンマを含む URL も分割されません。スロットのキーは、a〜z、0〜9、_ からなる 1〜32 文字です。
  • --choice は、クリップの特徴をそのまま残す(original)か、自分の写真から新しく作る(new)かを指定します。対象は、人物の body、outfit、hair、ペットの body、coat、商品の shape、finish です。
  • --resolution は、trends get に示される、トレンドが提供する解像度のどれかです。デフォルトはトレンドの先頭の解像度で、480p、または Nodaro Pulse のトレンドでは 720p です。
  • --draft を指定しない限り、実行は通常の実行です。--draft は、フル品質で 1080p に仕上げられる 480p のドラフトを作ります。Nodaro Prism のトレンドでのみ使えます。--no-draft も引き続き受け付けます。
  • --session は受け付けられますが、まだ適用されません。トレンドの実行は、まだセッションに保存されません。

これらのコマンドの背後にあるエンドポイントについては、Trends API を参照してください。

Video Remake のフル品質

Nodaro Prism のドラフトは、完了から 7 日以内であれば、同じテイクとして 1080p で仕上げられます。ドラフトとは、draft: true、または trends コマンドの --draft で作った Video Remake やトレンドの実行です。通常の実行と、すべての Nodaro Pulse の実行にはフル品質がありません。代わりに 1080p でもう一度実行してください。コマンドは Nodaro Cloud でのみ動作します。

nodaro video-remake full-quality estimate <jobId> [--json]
nodaro video-remake full-quality run <jobId> [--session <id>] [--json]
コマンド動作料金
video-remake full-quality estimateフル品質版を見積もります。おおよそのクレジット、ラベル付きの見積もりの各部分、実行を仕上げられる期限を表示します。以前の試行の 1080p レンダリングを再利用する場合、その分は 0 です。無料
video-remake full-quality run開始し、新しいジョブ ID を表示します。nodaro jobs get <id> で追跡します。先に estimate を実行してください。クレジット

フル品質は、1 つのドラフトにつき 1 つです。すでにある場合、run はそのジョブを表示し、何も課金しません。full_quality_pending は、以前の試行の 1080p レンダリングが審査中か、まだ始まっていないことを意味します。最終的なものではないので、後でもう一度コマンドを実行してください。フル品質を参照してください。

よくある質問

Nodaro CLI が実行できるすべてのノードタイプを一覧表示するには、どうすればよいですか?

nodaro nodes list を実行します。--category ai-image のようにカテゴリーを指定すると一覧を絞り込め、nodaro nodes get generate-image を実行すると、1 つのノードタイプの完全な入力スキーマを確認できます。

CLI から、ワークフローの一部のノードだけを実行するには、どうすればよいですか?

nodaro workflows run に --node を追加し、続けてノード ID をスペース区切りで指定します。指定したノードだけが実行されます。

ターミナルから、実行中のワークフローを停止するには、どうすればよいですか?

実行 ID を指定して nodaro executions cancel を実行します。デフォルトのモードである cancelled は、実行を即座に停止します。--mode stopping を指定すると、現在の階層のノードが完了するまで待ってから停止します。

1 つの CLI コマンドで複数の画像を生成するには、どうすればよいですか?

nodaro nodes run generate-image を、--count(1〜4 枚の画像)または 2〜4 個の画像モデル ID を指定した --models とともに実行します。--watch を追加すると、各ジョブが確定するまで、すべてのジョブを追跡します。

Nodaro Cloud が必要な Nodaro CLI コマンドは、どれですか?

recast、trends、video-remake のコマンドは、Nodaro Cloud だけで動作します。characters train、training、delete-lora と、billing plans、subscription、summary、history も同じです。動画生成 Pro の実行制御は、Nodaro Cloud への接続を通じて、セルフホスティング環境でも動作します。

ジョブが終わったときに、自分のサーバーに呼び出しを受けるには、どうすればよいですか?

nodaro webhooks create --url に自分の https のアドレスを指定して実行します。CLI は、エンドポイントの署名シークレットを一度だけ表示します。エンドポイント ID と --wait を指定して nodaro webhooks test を実行すると、サーバーがどう応答したかを確認できます。

最終更新

目次