# モデル、クレジット、プリセット

> AI アシスタントから、Nodaro のモデルを機能とクレジット料金とともに一覧表示し、クレジット残高と購入履歴を確認します。ノードプリセットを探して、生成に適用することもできます。

Source: https://nodaro.ai/ja/docs/mcp/tools/models-and-credits

**モデル、クレジット、プリセットのツール**は、アシスタントが生成に合ったモデルを選び、適切にクレジットを支払えるようにします。`list_models` は、すべてのモデルとその機能、料金を返します。`check_balance` と `credit_transactions` は、Nodaro Cloud でのクレジットを表示します。`list_node_presets` と `get_node_preset` は、生成に適用できる既製の設定を探します。

## `list_models`
この Nodaro インスタンスで使えるモデルを、種類と開発元ごとにまとめ、モデルごとの機能一覧とともに返します。ユーザーがモデルを選んでいない場合は、生成ツールの前にこのツールを呼び出します。

**権限**：不要（常に表示されます）。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `kind` | string | `image`、`video`、`audio` のいずれかです。 |
| `mode` | string | 1 つの操作です。たとえば `t2i`（テキストから画像）、`i2i`、`edit`、`upscale`、`remove-bg`、`i2v`（画像から動画）、`t2v`、`v2v`、`extend`、`motion-transfer`、`lip-sync`、`video-upscale`、`tts`、`music`、`sfx`、`stt`、`voice-design`、`voice-changer`、`voice-changer-pro`、`isolation`、`dubbing`、`forced-alignment`、`video-analysis`、`video-audit` です。 |
| `family` | string | 1 つの開発元です。たとえば `Google`、`OpenAI`、`Bytedance` です。 |
| `featuredOnly` | boolean | Nodaro チームが選んだ、各ティアで最も良いモデルだけを返します。 |

**戻り値**：各モデルのアスペクト比、解像度、品質、長さ、機能と、クレジットのあるエディションでは各バリエーションの料金です。`recommendations` の一覧には、画像内の文字や、最も安いリアルな画像など、よくある用途に最適なモデルが挙げられます。Seedance 2.0 のように、モデル固有のプロンプトのアドバイスがあるモデルには、`promptTips` も含まれます。これは、動画を生成する前に適用する短いルールです。

どのモデルにも[モデルカタログ](https://nodaro.ai/docs/models)にページがあり、同じ料金とより詳しい情報を掲載しています。

## `check_balance`
クレジット残高を、サブスクリプションのクレジットとチャージしたクレジットに分けて、その合計とともに返します。また、1 日の利用上限、毎月の付与量、ティア、請求期間の終了日も返します。

**権限**：`credits:read`。**クレジット**：無料。**Nodaro Cloud のみ**。

このツールにはパラメーターはありません。

**戻り値**：残高とプランの詳細です。

- **先に使われるクレジット**：サブスクリプションのクレジットが先に消費され、請求サイクルごとにリセットされます。チャージしたクレジットは、購入後 12 か月間有効です。
- **従量課金**：`effectiveTier` が `payg` の場合は、サブスクリプションはなく、クレジットを購入していることを意味します。すべてのモデルを使え、透かしも 1 日の上限もありません。
- **共有の請求アカウント**：1 つの請求アカウントが全員分を支払う環境では、接続したクライアントはそのアカウントの残高を読み取れません。その場合、ツールは `payer_balance_jwt_only` を返します。

## `credit_transactions`
最近の購入履歴（サブスクリプション、チャージ、返金）を一覧表示します。各行には、`type`、`amount_usd`、`credits_granted`、`tier`、`created_at`、`receipt_url` が含まれます。`receipt_url` は、領収書がある場合の、そのリンクです。

**権限**：`credits:read`。**クレジット**：無料。**Nodaro Cloud のみ**。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `limit` | integer | 1〜100 です。 |
| `cursor` | string | 前のページのカーソルです。 |

**戻り値**：購入履歴の行です。生成ごとに消費したクレジットは、この一覧には含まれません。各ジョブにそれぞれの `credits` が記録されており、REST API では `GET /v1/credits/transactions` で消費の履歴を一覧表示できます。

## `list_node_presets`
ノードの種類ごとのプリセットを一覧表示します。**キャラクターボード**や**シネマティックポートレート**などの標準プリセットと、自分で保存したプリセットです。プリセットとは、モデル、プロンプト、設定を含む、名前付きのノードの設定です。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `nodeType` | string | ノードの種類です。たとえば `generate-image` です。標準プリセットを含めるには必須です。 |
| `source` | string | 標準プリセットと保存したプリセットの両方なら `all`（デフォルト）、標準プリセットだけなら `factory`、自分のプリセットだけなら `custom` です。 |

**戻り値**：各プリセットの名前、ID、説明です。

## `get_node_preset`
1 つのプリセットの設定をすべて返します。内容は、モデル、プロンプト、アスペクト比、解像度、品質、ネガティブプロンプト、プロンプトの前後に加えるテキストです。プリセットを正確に適用するときに使います。フィールドを生成ツールにコピーするか、その ID を `presetId` として渡します。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `nodeType` | string | **必須**。ノードの種類です。たとえば `generate-image` です。 |
| `presetId` | string | **必須**。`generate-image/location-board` のような標準プリセットの ID か、自分のプリセットの ID です。 |

**戻り値**：プリセットの設定です。ID に一致するプリセットがない場合は、エラーが返されます。

## 生成にプリセットを適用する
`generate_image`、`generate_video`、`generate_music`、`generate_speech`、`text_to_audio` は、`presetId` を受け付けます。Nodaro はサーバー側でプリセットの設定を適用し、自分で指定したフィールドはすべてプリセットより優先されます。プリセットにプロンプトが含まれている場合は、`prompt` を省略できます。プリセットにあるプロンプトの前後のテキストは、あなた自身のプロンプトの前後に付きます。

`generate_speech` では、プリセットは速度、安定性、スタイルなどの話し方を調整します。その場合も、`text` は必須です。プリセットについて詳しくは、[プリセット](https://nodaro.ai/docs/concepts/presets)を参照してください。

## Frequently asked questions

### アシスタントは、どのようにして適切なモデルを選びますか？

種類とモード（たとえば image と t2i）で絞り込んで、list_models を呼び出します。応答には、各モデルのアスペクト比、解像度、長さ、機能、料金と、画像内の文字に最適なモデルなどのおすすめが含まれます。

### アシスタントから、クレジットの残高を確認できますか？

はい。Nodaro Cloud で、クレジットの権限を許可している場合は確認できます。check_balance は、サブスクリプションのクレジットとチャージしたクレジット、ティア、1 日の上限を返します。

### credit_transactions で、生成ごとの料金はわかりますか？

いいえ。credit_transactions は、サブスクリプション、チャージ、返金などの購入履歴を一覧表示します。生成ごとに消費したクレジットは各ジョブに記録されており、REST API で一覧表示できます。

### MCP でノードプリセットを使うにはどうすればよいですか？

list_node_presets でプリセットの ID を探し、presetId として generate_image、generate_video、generate_music、generate_speech、text_to_audio に渡します。自分で指定したフィールドは、プリセットより優先されます。