アセットコマンド
Nodaro CLI でキャラクター、ロケーション、オブジェクトを作成、検索、学習し、メイン画像を承認して、各アセットにバリエーションとモーションクリップを追加します。
Nodaro CLI のアセットコマンドは、キャラクター、ロケーション、オブジェクトを管理します。これらは、生成のたびに人物、場所、小道具を同じ状態に保つ、再利用可能なアイデンティティです。各アセットには、生成して承認するメイン画像があり、バリエーションとモーションクリップは後から追加します。同じアセットは、エディターのキャラクターアセット、ロケーションアセット、オブジェクト/小道具アセットノードにも登場します。
アセットの作り方
レコードを作成する
create は、アセットの名前、説明、スタイルを保存します。
候補を生成する
generate は、候補となるメイン画像を 1、2、4 のいずれかの枚数で作成します。--watch を付けると、完了を待ちます。
1 つを承認する
approve-portrait(キャラクター用)または approve-main-image(ロケーションとオブジェクト用)は、完了した候補のジョブから、メイン画像を設定します。続けて Nodaro が、その画像からアセットの説明を作成します。
バリエーションとモーションを追加する
generate-asset は、表情や季節のようなバリエーションを追加します。generate-motion は、メイン画像を短いクリップにアニメーション化します。
どの生成にも、エディターの対応するノードと同じようにクレジットがかかります。アセットがどうやってアイデンティティを安定させるかは、キャラクターの一貫性を参照してください。
キャラクター
nodaro characters list [--project <id>] [--archived] [--search <words> | --q <words>] [--limit <n>] [--json]
nodaro characters get <id>
nodaro characters create --name <name> [--description "..."] [--gender <gender>] [--style realistic|anime|3d-pixar|illustration] [--base-outfit "..."] [--seed-prompt "..."] [--node-id <id>] [--project <id>]
nodaro characters update <id> [--name <name>] [--description "..."] [--gender <gender>] [--style realistic|anime|3d-pixar|illustration] [--base-outfit "..."] [--seed-prompt "..."]
nodaro characters delete <id>
nodaro characters restore <id>
nodaro characters duplicate <id> [--node-id <id>] [--project <id>]
nodaro characters usage <id>
nodaro characters generate <id> [--seed-prompt "..."] [--description "..."] [--name <name>] [--count 1|2|4] [--provider <p>] [--watch]
nodaro characters generate-asset <id> --asset-type expressions|poses|lighting|angles|headAngles|bodyAngles|custom --variant <name> [--user-prompt "..."] [--description "..."] [--column <col>] [--attach-name <name>] [--provider <p>] [--watch]
nodaro characters generate-motion <id> --motion-prompt "..." [--attach-name <name>] [--description "..."] [--motion-description "..."] [--provider <p>] [--watch]
nodaro characters approve-portrait <id> --job <jobId>
nodaro characters recaption <id>
nodaro characters train <id> [--image <url> ...] [--watch] [--poll-interval <ms>] [--json]
nodaro characters training <id> [--watch] [--poll-interval <ms>] [--json]
nodaro characters delete-lora <id> [--json]| コマンド | 説明 |
|---|---|
list | 自分のキャラクターを一覧表示します。--archived を付けると、アーカイブしたキャラクターを表示します。--project で、1 つのプロジェクトに絞り込みます。--search または --q を付けると、名前または説明にすべての語(最大 5 語)を含むキャラクターだけを残します。大文字・小文字は問いません。各語は書いたとおりに照合され、ワイルドカードは使えません。 |
delete | キャラクターをアーカイブします。restore で元に戻せます。 |
duplicate | キャラクターを新しいレコードにコピーします。 |
usage | そのキャラクターを使っているワークフローを一覧表示します。 |
generate | ポートレートの候補を 1、2、4 のいずれかの枚数で作成します。 |
approve-portrait | 完了した候補のジョブからポートレートを設定し、続けてキャラクターの説明を作成します。 |
generate-asset | バリエーションを 1 つ作成します。表情、ポーズ、ライティング、アングル、頭部のアングル、全身のアングル、カスタムのいずれかです。 |
generate-motion | ポートレートをモーションクリップにアニメーション化します。 |
recaption | 現在のポートレートから、説明を作成し直します。 |
train | Nodaro Cloud で、キャラクターの高精度な学習を開始します。--image を繰り返して指定すると、それらの画像(4 枚以上)だけで学習します。--watch で学習のジョブを追跡します。 |
training | 学習の状態を表示します。untrained、queued、training、succeeded、failed、cancelled のいずれかです。--watch を付けると、成功時は 0、学習が失敗したか開始できなかった場合は 2、キャンセルまたは削除された場合は 130 で終了します。 |
delete-lora | 学習済みのモデルを削除します。実行中の学習はキャンセルされ、クレジットが返還されます。元に戻すことはできません。 |
学習には 1,650 クレジットかかり、約 15 分かかります。失敗した場合はクレジットが返還されます。もう一度学習すると、再び全額がかかります。キャラクターの学習を参照してください。
ロケーション
nodaro locations list [--archived] [--search <words> | --q <words>] [--json]
nodaro locations get <id> [--json]
nodaro locations create <name> --node-id <id> [--description "..."] [--category indoor|outdoor|urban|nature|fantasy|sci-fi|historical|futuristic|other] [--style realistic|anime|3d-pixar|illustration] [--project <id>] [--json]
nodaro locations update <id> [--name <name>] [--description "..."] [--category <category>] [--style <style>] [--style-lock true|false] [--canonical-description "..."] [--expected-updated-at <iso>] [--json]
nodaro locations delete <id> [--json]
nodaro locations restore <id> [--json]
nodaro locations generate --name <name> [--description "..."] [--user-prompt "..."] [--category <category>] [--style <style>] [--provider <p>] [--count 1|2|4] [--attach-to-location-id <id>] [--watch] [--json]
nodaro locations generate-asset <id> --asset-type timeOfDay|weather|seasons|angles|lighting|custom --variant <name> [--user-prompt "..."] [--description "..."] [--column <col>] [--attach-name <name>] [--provider <p>] [--watch] [--json]
nodaro locations generate-motion --name <name> --motion-prompt "..." --source-image-url <url> [--provider kling|kling-turbo|kling-3.0|wan-i2v|wan-2.7-i2v|seedance-2] [--style realistic|anime|3d-pixar|illustration] [--canonical-description "..."] [--attach-to-location-id <id>] [--attach-name <name>] [--aspect-ratio 1:1|3:4|16:9|9:16] [--watch] [--json]
nodaro locations approve-main-image <id> --candidate-job-id <jobId> [--json]
nodaro locations recaption <id> [--json]list --searchまたは--qは、キャラクターと同じように、名前または説明にすべての語を含むロケーションだけを残します。generateは、候補となるエスタブリッシングショットを作成します。--attach-to-location-idを指定し、--countを 1 にすると、ジョブの完了時に、結果がロケーションのメイン画像になります。候補が複数の場合は、approve-main-imageで 1 つを選びます。generate-assetは、バリエーションを 1 つ作成します。時間帯、天候、季節、アングル、ライティング、カスタムのいずれかです。generate-motionは、元になる画像を、一覧にある動画モデルのいずれかでクリップにアニメーション化します。--style-lockは、バリエーションの生成が、ロケーションの基準となるスタイルに固定されるかどうかを設定します。--expected-updated-atは、更新がより新しい変更を上書きしないように保護します。その時刻より後にレコードが変更されていた場合、更新はconcurrent_modificationで拒否されます。もう一度読み取ってから、再試行してください。
オブジェクト
nodaro objects list [--project <id>] [--archived] [--search <words> | --q <words>] [--json]
nodaro objects get <id> [--json]
nodaro objects create <name> --node-id <id> [--description "..."] [--category furniture|vehicle|weapon|food|clothing|electronics|nature|tool|animal|other] [--style realistic|anime|3d-pixar|illustration] [--project <id>] [--json]
nodaro objects update <id> [--name <name>] [--description "..."] [--category <category>] [--style <style>] [--style-lock true|false] [--canonical-description "..."] [--expected-updated-at <iso>] [--json]
nodaro objects delete <id> [--permanent] [--json]
nodaro objects restore <id> [--json]
nodaro objects generate --name <name> [--description "..."] [--user-prompt "..."] [--category <category>] [--style <style>] [--provider <p>] [--count 1|2|4] [--attach-to-object-id <id>] [--seed-prompt-hint "..."] [--watch] [--json]
nodaro objects generate-asset --asset-type angles|materials|variations|motion|custom --variant <name> --attach-to-object-id <id> [--attach-to-column <col>] [--name <name>] [--description "..."] [--seed-prompt-hint "..."] [--watch] [--json]
nodaro objects generate-motion --name <name> --motion-prompt "..." --source-image-url <url> [--provider kling-turbo|kling|kling-3.0|minimax|hailuo-2.3|wan-i2v|seedance|bytedance-lite] [--style realistic|anime|3d-pixar|illustration] [--canonical-description "..."] [--attach-to-object-id <id>] [--attach-name <name>] [--aspect-ratio 1:1|3:4|16:9|9:16|4:3] [--seed-prompt-hint "..."] [--watch] [--json]
nodaro objects approve-main-image <id> --candidate-job-id <jobId> [--expected-updated-at <iso>] [--json]
nodaro objects recaption <id> [--json]list --searchまたは--qは、キャラクターと同じように、名前または説明にすべての語を含むオブジェクトだけを残します。deleteはオブジェクトをアーカイブします。delete --permanentは、すでにアーカイブされているオブジェクトを消去します。restoreは、アーカイブしたオブジェクトを元に戻します。generateは、候補となるメイン画像を 1、2、4 のいずれかの枚数で作成します。--attach-to-object-idを指定し、--countを 1 にすると、ジョブの完了時に、結果がオブジェクトのメイン画像になります。generate-assetは、バリエーションを 1 つ作成し、指定したオブジェクトに関連付けます。アングル、素材、variations、モーション、カスタムのいずれかです。generate-motionは、オブジェクトのメイン画像をクリップにアニメーション化します。デフォルトのモデルはkling-turbo、デフォルトのアスペクト比は1:1です。
例:キャラクターを最初から最後まで作成する
# 1. Create the character
nodaro characters create --name Kira --description "young protagonist with auburn hair" \
--style realistic --seed-prompt "kira portrait, warm natural lighting"
# 2. Generate four portrait candidates and wait for them
nodaro characters generate <characterId> --count 4 --watch
# 3. Approve the candidate you like
nodaro characters approve-portrait <characterId> --job <candidateJobId>
# 4. Add a smiling expression
nodaro characters generate-asset <characterId> --asset-type expressions --variant smile --watchよくある質問
CLI から、ポートレート付きのキャラクターを作成するにはどうすればよいですか?
nodaro characters create でレコードを作成し、nodaro characters generate と --count 4 でポートレートの候補を生成します。気に入った候補は、nodaro characters approve-portrait とそのジョブ ID で承認します。
削除したキャラクターは完全になくなりますか?
いいえ。delete はキャラクター、ロケーション、オブジェクトをアーカイブするだけで、restore コマンドで元に戻せます。完全に消去できるのはオブジェクトだけで、すでにアーカイブ済みのオブジェクトに delete --permanent を使います。
アセットのバリエーションとは何ですか?
バリエーションとは、同じアセットの追加の画像のことです。たとえば、キャラクターの表情やポーズ、ロケーションの時間帯や季節、オブジェクトの素材などです。generate-asset コマンドで生成します。
CLI からキャラクターを学習させるにはどうすればよいですか?
Nodaro Cloud で、キャラクター ID と --watch を付けて nodaro characters train を実行します。学習には 1,650 クレジットかかり、約 15 分かかります。失敗した場合はクレジットが返還されます。
recaption は何をしますか?
現在のメイン画像から、アセットの説明を作成し直します。ポートレートやメイン画像の承認ですでに行われる処理なので、recaption を実行するのは、説明の作成に失敗した場合か、画像が変わった場合だけにしてください。
関連ページ
コマンド
キャラクターの一貫性
キャラクターアセット
キャラクター
出力と終了コード
最終更新