# 画像

> Nodaro の画像ツールで、AI アシスタントから画像の生成、変換、編集、マスク作成、合成、説明を行います。各ツールのパラメーター、デフォルト、クレジットも紹介します。

Source: https://nodaro.ai/ja/docs/mcp/tools/image

**画像ツール**を使うと、アシスタントは Nodaro で画像を作成、変更できます。できるのは、プロンプトからの生成、既存の画像の変換や編集、マスクの切り出し、複数の画像やレイヤーの合成、画像に写っている内容の説明です。各ツールはジョブを開始してその ID を返し、結果はライブラリに保存されます。画像ツールには、すべて `workflows:execute` 権限が必要です。

| ツール | 機能 | クレジット |
| --- | --- | --- |
| [`generate_image`](#generate_image) | テキストから画像を生成。リファレンスと任意のインペイントに対応 | モデルの料金 |
| [`modify_image`](#modify_image) | 既存の画像を編集、スタイル変更、変換 | モデルの料金 |
| [`image_to_image`](#image_to_image) | プロンプトによる画像から画像への変換。マスクと複数のリファレンスに対応 | モデルの料金 |
| [`edit_image`](#edit_image) | アップスケール、背景の削除、部分的な編集 | 操作の料金 |
| [`generate_mask`](#generate_mask) | 説明した対象の白黒マスク | 50 |
| [`image_collage`](#image_collage) | 2〜30 枚の画像を 1 枚の大きな画像に | 2K で 20、4K で 40 |
| [`image_overlay`](#image_overlay) | AI を使わずに、ロゴ、テキスト、QR コード、図形を画像に配置 | 10、追加のサイズ 1 つにつき 2 |
| [`suggest_overlay_placement`](#suggest_overlay_placement) | ロゴやテキストを画像のどこに置くべきかの提案 | 画像の説明 1 回分 |
| [`image_to_text`](#image_to_text) | 画像についての説明や回答 | デフォルトのモデルで 3 |
| [`save_image_defaults`](#save_image_defaults) | 自分用のデフォルトの画像モデルと設定 | 無料 |

## `generate_image`
Nodaro の画像モデルの 1 つを使って、テキストプロンプトから画像を作ります。「…の画像を作って」のような依頼で使われるツールで、[**画像生成**（Generate Image）](https://nodaro.ai/docs/nodes/image/generate-image)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：選んだ解像度または品質での、モデルの料金です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | 画像の説明で、最大 4,000 文字です。プリセットがプロンプトを指定する場合を除き、必須です。 |
| `model` | string | モデル ID です。デフォルトは `nano-banana-2` です。不明な ID はデフォルトに戻ります。[`list_models`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_models) を参照してください。 |
| `aspect_ratio` | string | たとえば `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9` です。デフォルトは `16:9` です。`16x9` のような形式も使えます。モデルが対応していない比率は、対応している比率に置き換わります。 |
| `resolution` | string | 対応しているモデルでは `1K`、`2K`、`4K` です。最も近い対応値が使われます。 |
| `quality` | string | 品質の設定があるモデルでは、`medium` または `high` です。 |
| `negative_prompt` | string | 避けたい内容で、最大 2,000 文字です。 |
| `reference_image_urls` | array | 人物、キャラクター、商品、スタイルを保つためのリファレンス画像で、URL または Nodaro の ID で最大 14 個指定します。応答で、添付された数を確認できます。 |
| `presetId` | string | [`list_node_presets`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets) で取得したプリセットです。指定したフィールドは、プリセットより優先されます。 |
| `structured` | object | プロンプトに加える構造化された詳細です。`person`（年齢、性別、表情、目、髪、職業）、`styling`（美的スタイル、カラールック、ライティング、ムード）、`setting`（雰囲気、背景、時代）、`camera`（フォーマット、フレーミング、動き）、`lens`（絞り、焦点距離）、`mood` です。 |
| `described_references` | array | 名前は挙げられるものの、画像がない被写体のための `{ name, description }` の項目で、最大 10 個です。各項目がプロンプトの 1 行になるので、プロンプト内の名前は、説明付きの被写体としてモデルに届きます。 |
| `connected_references`、`reference_order` | array | 上級者向けです。エディター独自の形式による、ラベル付きで順序のあるリファレンスで、最大 14 個です。 |
| `base_image_url`、`mask_url` | string | インペイント用です。編集する画像とマスクで、白い部分が変更され、黒い部分は保たれます。マスクした領域が再生成され、画像の上に戻されます。 |
| `strength` | number | インペイントの強さで、0（控えめ）〜1（完全に描き直し）です。対応しているモデルで使えます。 |
| `guidance_scale` | number | 0〜20 です。対応しているモデルで使えます。 |

**戻り値**：ジョブ ID です。MCP Apps に対応したクライアントでは、画像ができるとカードに表示されます。

## `modify_image`
既存の画像を、プロンプトで編集、スタイル変更、変換します。色の変更、背景の差し替え、スタイルの適用、フレームの拡張や一部の描き直しができます。[**画像修正**（Modify Image）](https://nodaro.ai/docs/nodes/image/modify-image)ノードと同じように動作します。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。加えたい変更で、最大 8,000 文字です。 |
| `image_url` または `image_asset_id` | string | **必須（どちらか一方）**。公開された `https` の URL、または結果が画像である Nodaro のジョブの ID です。 |
| `model` | string | デフォルトは `nano-banana-2` です。複数の編集で顔やキャラクターを同じに保つ場合や、画像内の文字には `nano-banana-pro` を、文字の多い編集には `gpt-image-2-i2i` を使います。不明な ID はデフォルトに戻ります。 |
| `aspect_ratio` | string | 出力の形です。対応していない値は、対応している値に置き換わります。 |
| `resolution` | string | 最も近い対応値が使われます。 |
| `quality` | string | 品質の設定があるモデルでは、`medium`、`high`、`basic` のいずれかです。 |
| `negative_prompt` | string | 避けたい内容で、最大 2,000 文字です。 |
| `structured` | object | `generate_image` と同じ構造化された詳細です。 |

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

## `image_to_image`
プロンプトで画像を変換します。マスクや、複数のリファレンスを 1 枚の画像に構成するためのオプションがあります。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。変換の内容で、最大 2,000 文字です。 |
| `image_url` または `image_asset_id` | string | 元画像です。 |
| `model` | string | デフォルトは `nano-banana` です。ほかに、`nano-banana-2`、フォトリアルな編集向けの `flux-kontext`、創造的な描き直し向けの `gpt-image-i2i`、`flux-i2i`、`ideogram-remix` などがあります。不明な ID は `nano-banana` に戻ります。 |
| `reference_image_urls` | array | 複数のリファレンスを受け付けるモデル向けの追加のリファレンス画像で、URL または Nodaro の ID で最大 13 個指定します。 |
| `mask_url` | string | インペイント用のマスクです。白い部分が変更され、黒い部分は保たれます。 |
| `strength` | number | 0（控えめ）〜1（完全に描き直し）です。 |
| `aspect_ratio` | string | 出力の形です。 |
| `resolution` | string | `1K`、`2K`、`4K` のいずれかです。 |
| `quality` | string | `medium`、`high`、`basic` のいずれかです。 |
| `seed` | integer | 固定のシードです。対応しているモデルで使えます。 |
| `negative_prompt` | string | 避けたい内容で、最大 5,000 文字です。 |

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

## `edit_image`
画像をアップスケールする、背景を削除する、または部分的な編集を加えます。操作は `model` で選びます。

**権限**：`workflows:execute`。**クレジット**：操作の料金です（下の表を参照）。

| `model` | 操作 | 必要なもの |
| --- | --- | --- |
| `recraft-upscale`（デフォルト） | くっきりしたアップスケール | 画像 |
| `topaz-image-upscale` | 1 倍、2 倍、4 倍のアップスケール | 画像と `upscale_factor` |
| `recraft-remove-bg` | 背景を削除し、透明度付きの PNG を返す | 画像 |
| `nano-banana-edit` | マスクの内側、またはフレームの外側をプロンプトで編集 | 画像、`prompt`、任意の `mask_url` |
| `grok-upscale` | 以前の Grok の生成を創造的にアップスケール | `kie_task_id` |
| `grok-2-segment` | 以前の Grok Imagine 2 の画像から、名前付きの領域のマップを無料で作成 | `kie_task_id` |
| `grok-2-edit` | 以前の Grok Imagine 2 の画像をプロンプトで編集。一部の領域だけを編集することも可能 | `kie_task_id`、`prompt`、任意の `mask_indexes` |

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Recraft Crisp Upscale](https://nodaro.ai/docs/models/image/recraft-crisp-upscale) | Recraft | Image upscaling | 2 | Light-weight image upscale (Recraft Crisp). |
| [Topaz Image Upscale](https://nodaro.ai/docs/models/image/topaz-image-upscale) | Topaz | Image upscaling | from 25 | High-quality image upscale at 1x (enhance only), 2x or 4x. Best for production-ready output. |
| [Recraft Remove BG](https://nodaro.ai/docs/models/image/recraft-remove-bg) | Recraft | Background removal | 3 | Remove image background. Cheap utility. |
| [Nano Banana Edit](https://nodaro.ai/docs/models/image/nano-banana-edit) | Google | Image editing | 10 | Image-to-image edits via Google's Nano Banana family. Good general-purpose editor. |
| [Grok Upscale](https://nodaro.ai/docs/models/image/grok-upscale) | xAI | Image upscaling | 25 | Upscale a previously-generated Grok image. Requires the prior task id. |
| [Grok Imagine 2 Segment Map](https://nodaro.ai/docs/models/image/grok-imagine-2-segment-map) | xAI | Image editing | 0 | FREE semantic segment map of a prior grok-2 generation — named region masks whose indexes feed grok-2-edit's region targeting. |
| [Grok Imagine 2 Edit](https://nodaro.ai/docs/models/image/grok-imagine-2-edit) | xAI | Image editing | 10 | Prompt-edit a prior grok-2 generation by task id. Optional mask indexes (from grok-2-segment) restrict the edit to named regions. |

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `model` | string | 上の表の操作です。デフォルトは `recraft-upscale` です。 |
| `image_url` または `image_asset_id` | string | 元画像です。3 つの Grok の操作を除く、すべての操作で使います。 |
| `prompt` | string | `nano-banana-edit` と `grok-2-edit` では必須です。最大 2,000 文字です。 |
| `mask_url` | string | `nano-banana-edit` 用です。白い部分が変更されます。 |
| `upscale_factor` | string | `topaz-image-upscale` 用で、`1`、`2`、`4` のいずれかです。デフォルトは `2` です。 |
| `target_resolution` | string | `topaz-image-upscale` のアップスケール倍率を指定する、古い方法です。`2K` は `2` に、`4K` と `8K` はどちらも `4` になります。代わりに `upscale_factor` を使ってください。 |
| `kie_task_id` | string | Grok の操作用です。以前の Grok の生成のタスク ID で、`get_job` がその生成の出力に `kieTaskId` として返します。 |
| `mask_indexes` | array | `grok-2-edit` 用です。`grok-2-segment` の実行で得た、変更する領域の `index` の値です。 |
| `negative_prompt`、`seed`、`style` | | 任意です。これらを使う操作で指定できます。 |

Grok Imagine 2 の画像の一部の領域だけを編集するには、2 つのステップで作業します。まず、その画像の `kie_task_id` を指定して `grok-2-segment` を実行し、ジョブの `segments` から名前付きの領域を読み取ります。次に、同じ `kie_task_id`、プロンプト、変更する領域の `mask_indexes` を指定して、`grok-2-edit` を実行します。領域のマップは無料です。

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

## `generate_mask`
「the person」や「sky and clouds」のように説明した対象の、白黒のマスクを作ります。白い部分が、選択された領域です。マスクは、`image_to_image`、`edit_image`、または `generate_image` のインペイント用のフィールドで使います。[**マスク生成**（Generate Mask）](https://nodaro.ai/docs/nodes/image/generate-mask)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：50。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。選択する対象で、最大 500 文字です。 |
| `image_url` または `image_asset_id` | string | 元画像です。 |
| `threshold` | number | 検出の信頼度で、0〜1 です。デフォルトは `0.3` です。 |

**戻り値**：ジョブ ID です。結果は PNG のマスクです。

## `image_collage`
2〜30 枚の画像を、1 枚の大きな画像にまとめます。画像が切り取られることはありません。`smart` レイアウトは、各画像を元の形のまま行に並べます。`grid` レイアウトは同じ大きさのセルを使い、空いた部分を背景色で埋めます。[**画像コラージュ**（Image Collage）](https://nodaro.ai/docs/nodes/image/image-collage)ノードと同じように動作し、絵コンテやコンタクトシートに向いています。

**権限**：`workflows:execute`。**クレジット**：`2K` で 20、`4K` で 40。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `images` | array | **必須**。2〜30 個の項目で、それぞれ `{ url }` または `{ asset_id }` です。各項目には、`size`（smart レイアウトでの相対的なサイズ。`0` は自動、`1` は大、`2` は中、`3` は小）と、`label`（最大 80 文字のキャプション）を追加できます。 |
| `layout` | string | `smart`（デフォルト）または `grid` です。 |
| `resolution` | string | 長辺の長さで、`2K` または `4K`（デフォルト。3,840 ピクセル）です。 |
| `aspect_ratio` | string | `16:9` や `9:16` など、任意の `W:H` です。デフォルトは `4:3` です。`grid` ではこの比率に正確に合わせ、`smart` では目標値として扱います。`smart` では、高さは行に合わせて決まります。 |
| `gap` | integer | 画像の間と周りの余白で、0〜200 ピクセルです。デフォルトは `24` です。 |
| `background_color` | string | `#RRGGBB` 形式の色です。デフォルトは `#ffffff` です。 |
| `numbered` | boolean | 各画像の角に、`images` の順で 1、2、3…と番号を入れます。 |
| `badge_position` | string | 番号とラベルを入れる角で、`top-left`（デフォルト）または `top-right` です。 |

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

## `image_overlay`
ベース画像の上に、1〜12 個のレイヤー（ロゴ、切り抜き画像、テキスト、QR コード、図形）をピクセル単位で正確に配置します。AI モデルは実行されないので、結果は毎回同じです。[**画像オーバーレイ**（Image Overlay）](https://nodaro.ai/docs/nodes/image/image-overlay)ノードと同じように動作します。すべてのオプションは、そのノードのページで説明しています。

**権限**：`workflows:execute`。**クレジット**：10。`variants` で追加するプラットフォームのサイズ 1 つにつき、2 が加算されます。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `image_url` または `image_asset_id` | string | ベース画像です。 |
| `layers` | array | **必須**。1〜12 個のレイヤーです。下のレイヤーのフィールドを参照してください。レイヤーが `z_index` を設定していない限り、配列の順が重なり順になります。 |
| `canvas` | object | 出力サイズです。16〜8,192 ピクセルの `width` と `height`、および `background_color` を指定します。ベースは、`base_fit`（`contain` または `cover`）に従ってキャンバスに配置されます。ベース画像のサイズを保つ場合は、省略します。 |
| `variants` | array | 同時にレンダリングする、追加のプラットフォームのサイズです。`youtube-thumbnail`、`youtube-banner`、`linkedin-company`、`linkedin-personal`、`x-header`、`facebook-cover`、`instagram-post`、`instagram-portrait`、`instagram-story`、`open-graph`、`presentation`、`a4-print` から選びます。 |
| `qr_text` | string | `qr.fromInput` が `true` のすべての QR レイヤーに、この値が入ります。 |
| `mask_mode` | string | ジョブが `maskUrl` としても返すマスクで、白い部分は変更してよい領域です。`around`（デフォルト。AI で仕上げるための、レイヤーの周りのリング）、`layers`、`outside`、`none` のいずれかです。 |
| `mask_spread` | integer | `around` のリングの幅で、1〜400 ピクセルです。デフォルトは `48` です。 |
| `output_format` | string | `png`（デフォルト。透明度を保持）、`jpg`、`webp` のいずれかです。 |

主なレイヤーのフィールドは次のとおりです。

| レイヤーのフィールド | 説明 |
| --- | --- |
| `kind` | `image`（デフォルト。`url` か `asset_id` が必要）、`text`、`qr`、`shape` のいずれかです。 |
| `anchor` | `top-left` から `bottom-right` までの 9 つの位置のいずれかです。デフォルトは `center` です。 |
| `x`、`y` | アンカーからのオフセットで、ベースの幅と高さに対するパーセントで指定します。右または下のアンカーでは、負の値でレイヤーが内側に移動します。 |
| `width`、`height` | ベースの幅と高さに対するパーセントです。幅のデフォルトは 25% です。高さを設定しない限り、高さはレイヤーの形に合わせて決まります。 |
| `opacity`、`rotation`、`blend` | 不透明度（0〜1）、回転（度）、ブレンド（`over`、`multiply`、`screen`）です。 |
| `fit`、`shadow`、`rounded_corners`、`z_index` | レイヤーがボックスをどう埋めるか（`contain`、`cover`、`stretch`）、ドロップシャドウ、角の丸み、重なり順です。 |
| `effects` | 画像レイヤーのみです。円形のマスク、境界のぼかし、縁取り、光彩のいずれかです。 |
| `text` | テキストレイヤー用です。`text`、`fontId`（`inter`、`montserrat`、`space-grotesk`、`playfair-display`、`oswald`、`bebas-neue`、`anton`、`pacifico`、`rubik`、`heebo`。`rubik` と `heebo` はヘブライ語に対応）、ベースの高さに対するパーセントで指定する `fontSize`、`fontWeight`、`color`、`align`、`letterSpacing`、`lineHeight`、`uppercase`、縁取り、背景ボックスを指定します。 |
| `qr` | QR レイヤー用です。エンコードする `text`、または `fromInput: true` と、色、余白を指定します。 |
| `shape` | 図形レイヤー用です。`rect`、`rounded`、`pill`、`circle`、`ribbon`、`triangle`、`diamond`、`hexagon`、`star`、`burst`、`arrow` のいずれかと、色、縁取りを指定します。 |

右下の角に透かしを入れる場合は、`anchor: "bottom-right"`、`x: -4`、`y: -6`、`width: 12` にします。SVG のロゴは、目的のサイズでくっきりとレンダリングされます。

**戻り値**：ジョブ ID です。結果には、画像、`maskUrl`、画像の `width` と `height`、`variants`（`{ id, label, width, height, url }` の一覧）が含まれます。

## `suggest_overlay_placement`
1 つのレイヤーをベース画像のどこに置くべきかを、ビジョンモデルに尋ねます。モデルは画像を見て、顔、被写体、ごちゃごちゃした質感を避けた位置を選びます。合成は行わないので、その答えを `image_overlay` に渡します。

**権限**：`workflows:execute`。**クレジット**：画像の説明 1 回分（`image_to_text` の料金）です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `image_url` または `image_asset_id` | string | ベース画像です。 |
| `intent` | string | レイヤーの内容です。たとえば、ロゴ、見出し、価格バッジ、QR コードなどです。最大 300 文字です。デフォルトはロゴです。 |
| `layer_aspect` | number | レイヤーの幅を高さで割った値で、0.05〜20 です。デフォルトは `1`（正方形）です。 |
| `safe_area` | object | 常に表示される領域で、キャンバスに対する割合の `x`、`y`、`w`、`h` で指定します。レイヤーは、この領域の内側に収まります。 |

**戻り値**：`image_overlay` と同じパーセント単位の `anchor`、`x`、`y`、`width` と、1 文の `reason` です。

## `image_to_text`
ビジョンモデルで、画像を説明したり、画像についての質問に答えたりします。キャプション、代替テキスト、シーンの分析や、「list all the text in the image」のような具体的な質問に使います。[**画像の説明**（Describe Image）](https://nodaro.ai/docs/nodes/image/describe-image)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：デフォルトのモデルで 3 です。料金は、モデルのティアによって決まります。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `image_url` または `image_asset_id` | string | 説明する画像です。 |
| `detail_level` | string | `brief`、`detailed`（デフォルト）、`comprehensive` のいずれかです。 |
| `custom_prompt` | string | 全般的な説明の代わりに尋ねる具体的な質問で、最大 2,000 文字です。 |
| `llmModel` | string | ビジョンモデルです。ツールが一覧表示する LLM の ID のいずれかを指定します。 |
| `reasoning_effort` | string | `none`〜`max` です。`xhigh` と `max` は、1 段階上のティアで課金されます。 |
| `advanced_mode`、`temperature`、`max_tokens` | | Gemini モデルのみです。[プロンプトのツール](https://nodaro.ai/docs/mcp/tools/prompts-and-text#enhance_prompt)と同じように使えます。1 段階上のティアで課金されます。 |

**戻り値**：ジョブ ID です。テキストはジョブの出力に含まれ、カードには **Copy** ボタン付きで表示されます。

## `save_image_defaults`
好みの画像設定を保存します。以降の `generate_image` の呼び出しでは、特に指定しない限り、この設定が使われます。変更されるのは、指定したフィールドだけです。MCP Apps に対応したクライアントでは、画像カードの **Save as default** チップがこのツールを呼び出します。

**権限**：`workflows:execute`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `model` | string or null | デフォルトのモデルです。`null` を指定するとクリアされ、カタログのデフォルトに戻ります。 |
| `aspect_ratio` | string or null | デフォルトのアスペクト比です。 |
| `resolution` | string or null | デフォルトの解像度です。 |
| `quality` | string or null | デフォルトの品質です。 |

**戻り値**：確認メッセージです。

## Frequently asked questions

### generate_image がデフォルトで使うモデルは何ですか？

Nano Banana 2 です。変更するには、list_models にある別の ID を model に指定します。たとえば、読みやすい文字には nano-banana-pro を、すばやい試行には gpt-image-2-5-flare を使います。不明な ID を指定すると、エラーにはならずデフォルトに戻ります。

### 複数の画像で同じ人物を保つにはどうすればよいですか？

その人物の画像を、URL または Nodaro の ID で reference_image_urls に最大 14 個渡します。応答で、添付された数を確認できます。保存したキャラクターの場合は、get_character が返す承認済みのポートレートを渡します。

### MCP で画像の背景を削除したり、アップスケールしたりするにはどうすればよいですか？

edit_image を使います。透過 PNG にするには model を recraft-remove-bg に、アップスケールするには recraft-upscale か topaz-image-upscale に設定します。どれもプロンプトは不要です。

### アシスタントは、AI を使わずに画像にロゴや文字を入れられますか？

はい。image_overlay は、画像、テキスト、QR コード、図形を、モデルを使わずにベース画像へピクセル単位で正確に配置します。料金は 10 クレジットです。先に suggest_overlay_placement で、ロゴを置く位置を提案させることもできます。

### MCP で画像を生成すると、料金はいくらですか？

エディターと同じです。料金は、モデルと、その解像度または品質によって決まります。正確なクレジットは、list_models と各モデルのページに記載されています。