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

オブジェクトとクリーチャー

保存したオブジェクトとクリーチャーの一覧表示と読み取り、画像とバリエーションの生成、メイン画像の承認、回転や待機モーションのクリップ作成を、AI アシスタントから行えます。

オブジェクトとクリーチャーのツールを使うと、アシスタントはライブラリの小道具、商品、クリーチャーを扱えます。これらは見た目が固定されたアイテムや生き物で、どのショットでも同じ姿を保ちます。アシスタントは、それらの一覧表示と読み取り、画像とバリエーションの生成、メイン画像の承認、短いモーションクリップの作成を行います。オブジェクトとクリーチャーの仕組みは同じで、クリーチャーには自由入力の種族が加わります。アプリで同じ作業を行う方法は、オブジェクトと小道具と動物とクリーチャーを読んでください。

オブジェクトとクリーチャーは、アプリで作成します。それらを作成する MCP ツールはありません。

オブジェクトのツール

list_objects

オブジェクトを一覧表示します。オブジェクトとは、複数のショットで再利用する小道具、アクセサリー、物理的なアイテムです。各行には、名前、説明、メイン画像、バリエーションの数が含まれます。新しい順に並びます。

権限:assets:read。クレジット:無料。

パラメーター型説明
searchstring最大 5 語、最大 200 文字です。すべての語がオブジェクトの名前か説明に含まれている必要があります。大文字と小文字は区別されません。空の値は検索なしとして扱われます。ユーザーがオブジェクトの名前を挙げたときに使います。
limitinteger1〜100 です。デフォルトは 50 です。

戻り値:オブジェクトの一覧です。バリエーションの URL は、get_object で取得します。

get_object

1 つのオブジェクトの情報をすべて返します。名前と URL が付いたすべてのバリエーションと、リファレンス写真です。

権限:assets:read。クレジット:無料。

パラメーター型説明
idstring必須。list_objects で取得したオブジェクトの ID です。

戻り値:オブジェクトです。オブジェクトが存在しない場合や、自分のものではない場合は、エラーになります。

generate_object

オブジェクトの画像(kind: "main")またはバリエーション(kind: "asset")を生成します。結果は、オブジェクトには保存されません。

権限:workflows:execute。クレジット:画像モデルの料金です。

パラメーター型説明
namestring必須。オブジェクトの名前です。
kindstringmain(デフォルト)か asset です。
description, stylestringオブジェクトの見た目です。
categorystringfurniture、vehicle、weapon、food、clothing、electronics、nature、tool、animal、other のいずれかです。
asset_typestringasset の場合に使います。angles、materials、variations、custom のいずれかです。
variantstringasset の場合に使います。たとえば front、wood、weathered です。
modelstring画像モデルです。デフォルトは gpt-image-2 です。
source_image_urlstring元になる画像です。

戻り値:ジョブ ID です。

approve_object_main_image

完成した候補をオブジェクトのメイン画像にします。また、ビジョンモデルに、形、素材、状態、用途を説明させ、基準となる説明として保存します。

権限:assets:write。クレジット:説明を書くための、Claude Sonnet 4.6 のビジョンの呼び出し 1 回分で、使ったトークンに応じて課金されます(LLM 呼び出しの課金のしくみ)。承認がクレジットのために拒否されることはありません。説明に足りる残高がない場合でも画像は承認され、説明の作成は省略されます。説明は、後で recaption_object を実行して書きます。

パラメーター型説明
object_idstring必須。対象のオブジェクトです。
candidate_job_idstring必須。generate_object の結果など、自分の完了済みの画像ジョブです。別のオブジェクトのために作ったジョブでは、candidate_object_mismatch が返されます。
expected_updated_atstringオブジェクトの updatedAt です。その後オブジェクトが変更されていた場合、新しい値とともに concurrent_modification が返されます。

戻り値:メイン画像の URL と説明です。説明の作成に失敗しても、画像は設定され、説明は空になります。その場合は recaption_object を実行します。

recaption_object

ビジョンモデルに、現在のメイン画像を 80〜120 語程度でもう一度説明させ、基準となる説明として保存します。

権限:assets:write。クレジット:Claude Sonnet 4.6 のビジョンの呼び出し 1 回分で、承認時の説明と同じように、使ったトークンに応じて課金されます。

パラメーター型説明
object_idstring必須。対象のオブジェクトです。

戻り値:新しい説明です。オブジェクトにメイン画像がない場合は main_image_required、説明の作成に失敗した場合は caption_failed が返されます。

generate_object_motion

オブジェクトを動かして、短いクリップにします。たとえば「slow 360-degree rotation」「object hovering with subtle bob」「parallax pan from left to right」(ゆっくり 360 度回転、浮かんで小さく揺れる、左から右へのパララックスパン)のような動きです。

権限:workflows:execute。クレジット:動画モデルの料金です。デフォルトの Kling 2.5 Turbo Pro では、5 秒のクリップが 138 クレジットです。

パラメーター型説明
motion_promptstring必須。オブジェクトまたはカメラの動きで、最大 2,000 文字です。
source_image_urlstring必須。最初のフレームです。通常は、オブジェクトの承認済みのメイン画像を使います。
namestring必須。オブジェクトの名前です。プロンプトのコンテキストとして使われます。
providerstringkling-turbo(デフォルト)、kling、kling-3.0、minimax、hailuo-2.3、wan-i2v、seedance-2-mini、bytedance-lite のいずれかです。
aspect_ratiostring1:1(デフォルト。商品を見せる構図向け)、3:4、16:9、9:16、4:3 のいずれかです。
attach_to_object_idstringクリップを、オブジェクトのモーションクリップに保存します。所有者の確認は、クレジットが確保される前に行われます。
attach_namestring保存するクリップの名前です。
refine_from_video_urlstring既存のクリップを、新しいプロンプトを使って動画から動画へ調整します。たとえば「same shot but faster rotation」(同じショットで、回転だけ速く)です。
canonical_description, category, stylestringプロンプトに加える追加のコンテキストです。

戻り値:ジョブ ID です。クリップの準備ができると、カードで再生されます。

クリーチャーのツール

list_creatures

クリーチャーを一覧表示します。クリーチャーとは、見た目が固定された動物や、人間以外の生き物です。各行には、名前、説明、メイン画像、バリエーションの数が含まれます。新しい順に並びます。

権限:assets:read。クレジット:無料。

パラメーター型説明
searchstring最大 5 語、最大 200 文字です。すべての語がクリーチャーの名前か説明に含まれている必要があります。大文字と小文字は区別されません。空の値は検索なしとして扱われます。
limitinteger1〜100 です。デフォルトは 50 です。

戻り値:クリーチャーの一覧です。バリエーションの URL は、get_creature で取得します。

get_creature

1 つのクリーチャーの情報をすべて返します。名前と URL が付いたすべてのバリエーション、リファレンス写真、保存されているボイスです。

権限:assets:read。クレジット:無料。

パラメーター型説明
idstring必須。list_creatures で取得したクリーチャーの ID です。

戻り値:クリーチャーです。クリーチャーが存在しない場合や、自分のものではない場合は、エラーになります。

generate_creature

クリーチャーの画像(kind: "main")またはバリエーション(kind: "asset")を生成します。結果は、クリーチャーには保存されません。

権限:workflows:execute。クレジット:画像モデルの料金です。

パラメーター型説明
namestring必須。クリーチャーの名前です。
kindstringmain(デフォルト)か asset です。
speciesstringdragon、wolf、griffin などの自由入力のテキストで、最大 200 文字です。
categorystringmammal、mythical、reptile などの自由入力のテキストです。
stylestringrealistic、anime、3d-pixar、illustration などの自由入力のテキストです。
descriptionstringクリーチャーの見た目です。
asset_typestringasset の場合に使います。angles、poses、variations、custom のいずれかです。
variantstringasset の場合に使います。たとえば front、standing、weathered です。
modelstring画像モデルです。デフォルトは gpt-image-2 です。
source_image_urlstring元になる画像です。

戻り値:ジョブ ID です。

approve_creature_main_image

完成した候補をクリーチャーのメイン画像にします。また、ビジョンモデルに、種族、体のつくり、色、状態を説明させ、基準となる説明として保存します。

権限:assets:write。クレジット:説明を書くための、Claude Sonnet 4.6 のビジョンの呼び出し 1 回分で、使ったトークンに応じて課金されます(LLM 呼び出しの課金のしくみ)。承認がクレジットのために拒否されることはありません。説明に足りる残高がない場合でも画像は承認され、説明の作成は省略されます。説明は、後で recaption_creature を実行して書きます。

パラメーター型説明
creature_idstring必須。対象のクリーチャーです。
candidate_job_idstring必須。generate_creature の結果など、自分の完了済みの画像ジョブです。別のクリーチャーのために作ったジョブでは、candidate_creature_mismatch が返されます。
expected_updated_atstringクリーチャーの updatedAt です。その後クリーチャーが変更されていた場合、concurrent_modification が返されます。

戻り値:メイン画像の URL と説明です。説明の作成に失敗した場合は、recaption_creature を実行します。

recaption_creature

ビジョンモデルに、現在のメイン画像を 80〜120 語程度でもう一度説明させ、基準となる説明として保存します。

権限:assets:write。クレジット:Claude Sonnet 4.6 のビジョンの呼び出し 1 回分で、承認時の説明と同じように、使ったトークンに応じて課金されます。

パラメーター型説明
creature_idstring必須。対象のクリーチャーです。

戻り値:新しい説明です。クリーチャーにメイン画像がない場合は main_image_required、説明の作成に失敗した場合は caption_failed が返されます。

generate_creature_motion

クリーチャーを動かして、短い待機モーションのクリップにします。たとえば「creature breathing with subtle idle sway」(呼吸しながら、待機中にわずかに体を揺らすクリーチャー)、忍び歩き、羽ばたき、パララックスのパンなどです。

権限:workflows:execute。クレジット:動画モデルの料金です。デフォルトの Kling 2.5 Turbo Pro では、5 秒のクリップが 138 クレジットです。

パラメーター型説明
motion_promptstring必須。クリーチャーまたはカメラの動きで、最大 2,000 文字です。
source_image_urlstring必須。最初のフレームです。通常は、クリーチャーの承認済みのメイン画像を使います。
namestring必須。クリーチャーの名前です。
providerstringkling-turbo(デフォルト)、kling、kling-3.0、minimax、hailuo-2.3、wan-i2v、seedance-2-mini、bytedance-lite のいずれかです。
aspect_ratiostring1:1(デフォルト)、3:4、16:9、9:16、4:3 のいずれかです。
attach_to_creature_idstringクリップを、クリーチャーのモーションクリップに保存します。所有者の確認は、クレジットが確保される前に行われます。
attach_namestring保存するクリップの名前です。
refine_from_video_urlstring既存のクリップを、新しいプロンプトを使って動画から動画へ調整します。
canonical_description, category, stylestringプロンプトに加える追加のコンテキストです。

戻り値:ジョブ ID です。クリップの準備ができると、カードで再生されます。

よくある質問

アシスタントは、新しいオブジェクトやクリーチャーを作成できますか?

保存されるデータとしては作成できません。オブジェクトやクリーチャーを作成するツールはないため、アプリで作成してください。作成した後は、アシスタントがそれらを一覧表示して読み取り、画像やクリップを生成し、そのために作ったメイン画像を承認できます。

メイン画像の承認が、不一致のエラーで失敗するのはなぜですか?

別のオブジェクトやクリーチャーのために作った候補のジョブでは、candidate_object_mismatch または candidate_creature_mismatch が返されます。generate_object の結果のように、どれにも関連付けられていない候補は承認できます。

商品のモーションクリップとして、どのようなものを作れますか?

ゆっくりとした 360 度の回転、小さく上下しながらの浮遊、パララックスのパンなどの短いクリップです。generate_object_motion は、デフォルトで正方形のフレームと Kling 2.5 Turbo Pro を使います。

オブジェクトとクリーチャーの違いは何ですか?

オブジェクトは、小道具、商品、乗り物などの物理的なアイテムです。クリーチャーは、動物や人間以外の生き物です。クリーチャーには、ドラゴンやオオカミなどの種族を自由に入力でき、素材のバリエーションの代わりにポーズのバリエーションがあります。

最終更新

目次