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

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

Source: https://nodaro.ai/ja/docs/mcp/tools/objects-and-creatures

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

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `search` | string | オブジェクトの名前の一部です。大文字と小文字は区別されず、最大 100 文字です。ユーザーがオブジェクトの名前を挙げたときに使います。 |
| `limit` | integer | 1〜100 です。デフォルトは `50` です。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `id` | string | **必須**。`list_objects` で取得したオブジェクトの ID です。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `name` | string | **必須**。オブジェクトの名前です。 |
| `kind` | string | `main`（デフォルト）か `asset` です。 |
| `description`, `style` | string | オブジェクトの見た目です。 |
| `category` | string | `furniture`、`vehicle`、`weapon`、`food`、`clothing`、`electronics`、`nature`、`tool`、`animal`、`other` のいずれかです。 |
| `asset_type` | string | `asset` の場合に使います。`angles`、`materials`、`variations`、`custom` のいずれかです。 |
| `variant` | string | `asset` の場合に使います。たとえば `front`、`wood`、`weathered` です。 |
| `model` | string | 画像モデルです。デフォルトは `nano-banana` です。 |
| `source_image_url` | string | 元になる画像です。 |

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `object_id` | string | **必須**。対象のオブジェクトです。 |
| `candidate_job_id` | string | **必須**。このオブジェクトのために生成された、自分の完了済みの画像ジョブです。別のオブジェクトのために作ったジョブでは、`candidate_object_mismatch` が返されます。 |
| `expected_updated_at` | string | オブジェクトの `updatedAt` です。その後オブジェクトが変更されていた場合、新しい値とともに `concurrent_modification` が返されます。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `object_id` | string | **必須**。対象のオブジェクトです。 |

**戻り値**：新しい説明です。オブジェクトにメイン画像がない場合は `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 クレジットです。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `motion_prompt` | string | **必須**。オブジェクトまたはカメラの動きで、最大 2,000 文字です。 |
| `source_image_url` | string | **必須**。最初のフレームです。通常は、オブジェクトの承認済みのメイン画像を使います。 |
| `name` | string | **必須**。オブジェクトの名前です。プロンプトのコンテキストとして使われます。 |
| `provider` | string | `kling-turbo`（デフォルト）、`kling`、`kling-3.0`、`minimax`、`hailuo-2.3`、`wan-i2v`、`seedance`、`bytedance-lite` のいずれかです。 |
| `aspect_ratio` | string | `1:1`（デフォルト。商品を見せる構図向け）、`3:4`、`16:9`、`9:16`、`4:3` のいずれかです。 |
| `attach_to_object_id` | string | クリップを、オブジェクトのモーションクリップに保存します。所有者の確認は、クレジットが確保される前に行われます。 |
| `attach_name` | string | 保存するクリップの名前です。 |
| `refine_from_video_url` | string | 既存のクリップを、新しいプロンプトを使って動画から動画へ調整します。たとえば「same shot but faster rotation」です。 |
| `canonical_description`, `category`, `style` | string | プロンプトに加える追加のコンテキストです。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `search` | string | クリーチャーの名前の一部です。大文字と小文字は区別されず、最大 100 文字です。 |
| `limit` | integer | 1〜100 です。デフォルトは `50` です。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `id` | string | **必須**。`list_creatures` で取得したクリーチャーの ID です。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `name` | string | **必須**。クリーチャーの名前です。 |
| `kind` | string | `main`（デフォルト）か `asset` です。 |
| `species` | string | `dragon`、`wolf`、`griffin` などの自由入力のテキストで、最大 200 文字です。 |
| `category` | string | `mammal`、`mythical`、`reptile` などの自由入力のテキストです。 |
| `style` | string | `realistic`、`anime`、`3d-pixar`、`illustration` などの自由入力のテキストです。 |
| `description` | string | クリーチャーの見た目です。 |
| `asset_type` | string | `asset` の場合に使います。`angles`、`poses`、`variations`、`custom` のいずれかです。 |
| `variant` | string | `asset` の場合に使います。たとえば `front`、`standing`、`weathered` です。 |
| `model` | string | 画像モデルです。デフォルトは `nano-banana` です。 |
| `source_image_url` | string | 元になる画像です。 |

**戻り値**：ジョブ ID です。

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `creature_id` | string | **必須**。対象のクリーチャーです。 |
| `candidate_job_id` | string | **必須**。このクリーチャーのために生成された、自分の完了済みの画像ジョブです。別のクリーチャーのために作ったジョブでは、`candidate_creature_mismatch` が返されます。 |
| `expected_updated_at` | string | クリーチャーの `updatedAt` です。その後クリーチャーが変更されていた場合、`concurrent_modification` が返されます。 |

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

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

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `creature_id` | string | **必須**。対象のクリーチャーです。 |

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

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

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

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

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

## Frequently asked questions

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

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

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

候補のジョブは、そのオブジェクトまたはクリーチャーのために生成されたものである必要があります。別のオブジェクトやクリーチャーのために作った候補や、どれにも関連付けられていない候補では、candidate_object_mismatch または candidate_creature_mismatch が返されます。

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

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

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

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