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

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

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

オブジェクトのツール

list_objects

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

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

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

get_object

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

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

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

generate_object

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

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

戻り値：ジョブ ID です。

approve_object_main_image

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

権限：assets:write。クレジット：説明を書くための、短い LLM の実行 1 回分です。

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

recaption_object

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

権限：assets:write。クレジット：短い LLM の実行 1 回分です。

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

generate_object_motion

オブジェクトを動かして、短いクリップにします。たとえば「slow 360-degree rotation」「object hovering with subtle bob」「parallax pan from left to right」のような動きです。

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

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

クリーチャーのツール

list_creatures

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

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

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

get_creature

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

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

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

generate_creature

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

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

戻り値：ジョブ ID です。

approve_creature_main_image

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

権限：assets:write。クレジット：説明を書くための、短い LLM の実行 1 回分です。

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

recaption_creature

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

権限：assets:write。クレジット：短い LLM の実行 1 回分です。

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

generate_creature_motion

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

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

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