モデル、クレジット、プリセット
AI アシスタントから、Nodaro のモデルを機能とクレジット料金とともに一覧表示し、残高と利用履歴を確認します。ノードプリセットを探し、保存し、生成に適用することもできます。
モデル、クレジット、プリセットのツールは、アシスタントが生成に合ったモデルを選び、適切にクレジットを支払えるようにします。list_models は、すべてのモデルとその機能、料金を返します。check_balance と credit_transactions は、Nodaro Cloud でのクレジットを表示します。プリセットのツールは、ノードの既製の設定を探し、保存し、適用します。
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 チームが選んだ、各ティアで最も良いモデルだけを返します。 |
priceIds | string[] | モデルを一覧表示する代わりに、料金を見積もります。1〜50 個の料金 ID を指定します。Nodaro Cloud のみです。料金を調べるを参照してください。 |
戻り値:各モデルの maker({ id, name } の形で、モデルを作った企業)と、アスペクト比、解像度、品質、長さ、機能と、クレジットのあるエディションでは各バリエーションの料金です。インスタンスが独自のラベルで提供するモデルには、maker がありません。recommendations の一覧には、画像内の文字や、最も安いリアルな画像など、よくある用途に最適なモデルが挙げられます。Seedance 2.0 のように、モデル固有のプロンプトのアドバイスがあるモデルには、promptTips も含まれます。これは、動画を生成する前に適用する短いルールです。メーカーのロゴ(logoUrl)は、この応答には含まれません。ロゴはモデルピッカーを描画するアプリ向けのもので、GET /v1/models が返します。
アスペクト比や背景によってサイズが変わるモデルには、GET /v1/models と同じく、サイズのルールも含まれます。
resolutionsByAspectRatioは、resolutionsより少ないサイズでしか生成しない比率と、その比率で生成するサイズの一覧です。たとえば、GPT Image 2.5 は 27:16、16:27、9:8、8:9 を 1K でしか生成しません。一覧にない比率では、すべてのサイズで生成します。transparentResolutionは、透明な背景を生成する唯一のサイズです。backgroundOnlyAtTransparentResolutionは、そのモデルがそのサイズでしか背景の設定を受け付けないことを示します。
選んだ比率で生成できるサイズを選んでください。それ以外のサイズを指定すると、指定したサイズより小さく、その比率で生成できる最大のサイズで実行され、そのサイズの料金になります。
呼び出しがサイズを指定しない場合に使うサイズを宣言しているモデルは、それを defaultResolution として持ちます。FLUX 3 Klein では 1K、Seedream 5.5 と MiniMax H3 Image では 2K、PixVerse V6 Max では 720p です。resolutions の最初の項目をデフォルトとみなさず、このフィールドを読んでください。
どのモデルにもモデルカタログにページがあり、同じ料金とより詳しい情報を掲載しています。
料金を調べる
priceIds を渡すと、モデルを一覧表示する代わりに料金を見積もります。ツールは { "prices": { "<id>": … } } を返します。数値は POST /v1/credits/model-costs と同じです。
- どのモデルの LLM 呼び出しも、料金キー
<feature>:<model id>で見積もります。たとえばllm-chat:claude-sonnet-5.5やreduce:pick-best-llm:claude-opus-5.5です。詳細モードのように、呼び出しがモデルの開発元自身のサービスで実行される場合は、:directを付けます。推論の強度で料金が決まるモデルでは、送る推論の強度を:effort-<level>で付けます。 - LLM のキーには
{ "credits": N, "estimate": true }が返ります。この数値は、そのモデルでのその機能の一般的な呼び出しの料金です。呼び出しは実際に使ったトークンに応じて課金されるため、数値は≈Nと表示してください。LLM 呼び出しの課金のしくみを参照してください。 - まだ料金がないモデルには
{ "error": "llm_model_unpriced" }が返り、そのモデルでの実行は拒否されます。 - それ以外の ID には、請求される料金
{ "credits": N }か、{ "error": "not_priced" }が返ります。 - クレジットのないエディションでは、
no_credit_systemで見積もりが拒否されます。
check_balance
クレジット残高を、サブスクリプションのクレジットとチャージしたクレジットに分けて、その合計とともに返します。また、1 日の利用上限、毎月の付与量、ティア、請求期間の終了日も返します。
権限:credits:read。クレジット:無料。Nodaro Cloud のみ。
このツールにはパラメーターはありません。
戻り値:残高とプランの詳細です。
- 先に使われるクレジット:サブスクリプションのクレジットが先に消費されます。年額プランでも毎月、プランの毎月の付与量にリセットされ、使わなかった分は繰り越されません。更新の支払いに失敗すると、その期間に残っているサブスクリプションのクレジットは保留になり、更新の支払いが済むと戻ります。チャージしたクレジットは、購入後 12 か月間有効です。
- 従量課金:
effectiveTierがpaygの場合は、サブスクリプションはなく、クレジットを購入していることを意味します。すべてのモデルを使え、透かしも 1 日の上限もありません。 - 共有の請求アカウント:1 つの請求アカウントが全員分を支払う環境では、接続したクライアントはそのアカウントの残高を読み取れません。その場合、ツールは
payer_balance_jwt_onlyを返します。 - 独自の単位を持つデプロイ:デプロイは、クレジットの代わりに独自の単位を表示したり、各残高を外部のウォレットで管理したり、プランを販売しなかったりできます。その場合、
check_balanceは、デプロイの残高表示と同じものを返します。available、そのsource(external_wallet、allowance、balanceのいずれか)、unitです。読み取れなかった値は0ではなく、常にnullになります。デプロイが残高を管理している場合、応答にはmanagedBy: "deployment"とnoteが含まれ、プランのフィールドは省かれます。
credit_transactions
クレジットの 2 つの台帳、購入履歴と利用履歴の両方を一覧表示します。
権限:credits:read。クレジット:無料。Nodaro Cloud のみ。
| パラメーター | 型 | 説明 |
|---|---|---|
limit | integer | 1〜100 です。 |
cursor | string | 購入履歴の前のページのカーソルです。 |
usage_cursor | string | 利用履歴の前のページのカーソルです。 |
戻り値:2 つの一覧です。
data:最近の購入履歴です。サブスクリプション、チャージ、返金などです。各行には、type、amount_usd、credits_granted、tier、created_at、receipt_urlが含まれます。receipt_urlは、領収書がある場合の、そのリンクです。next_cursorでページを送ります。usage:最近の利用履歴で、クレジットで支払った実行ごとに 1 行です。REST API がGET /v1/credits/transactionsで一覧表示する行と同じで、フィールドも同じです。1 ページは最大 50 行で、usage.next_cursorをusage_cursorに渡してページを送ります。
利用履歴の行では、次のようになります。
credits_chargedは、その実行にかかった費用です。クレジットがまだ確保されているあいだはnull、返還されると0です。利用額を合計するには、このフィールドを足し合わせてください。credits_reserved(credits_usedも同じ)は、実行の開始時に確保した額です。測った長さや再レンダリングの上限などのために確保した額より少なく精算された実行でも、ここには確保した額全体が表示されます。action、provider、status(reserved、committed、refunded)、metadata、payer、workspaceIdは、REST API と同じです。クレジットを参照してください。
独自の単位を持つデプロイでは、両方のリストのクレジットの金額はその単位で表され、応答はその単位を unit として示します。amount_usd は、引き続き購入にかかった金額です。
list_node_presets
ノードの種類ごとのプリセットを一覧表示します。キャラクターボードやシネマティックポートレートなどの標準プリセットと、自分で保存したプリセットです。プリセットとは、モデル、プロンプト、設定を含む、名前付きのノードの設定です。1 つのプリセットの設定全体は、get_node_preset で読み取ります。
権限:presets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
nodeType | string | ノードの種類です。たとえば generate-image です。標準プリセットを含めるには必須です。 |
source | string | 標準プリセットと保存したプリセットの両方なら all(デフォルト)、標準プリセットだけなら factory、自分のプリセットだけなら custom です。nodeType を指定しない場合、ツールは自分のプリセットとヒントを返します。 |
戻り値:各プリセットの名前、ID、説明、グループです。該当する場合、エントリーには次のフィールドも含まれます。
needsImage: trueとminReferences:そのプリセットは、その枚数の接続された写真をもとに動作します。たとえば、リファレンスシート、ポートレート変身、{image:N}を使うテンプレートです。その枚数のリファレンス画像を付けて実行してください。favorite: true:そのプリセットはお気に入りの 1 つです。previewUrl:作例の画像です。アプリ内のアシスタントは受け取りません。
get_node_preset
1 つのプリセットの設定をすべて返します。内容は、モデル、プロンプト、アスペクト比、解像度、品質、ネガティブプロンプト、プロンプトの前後に加えるテキストです。プリセットを正確に適用するときに使います。フィールドを生成ツールにコピーするか、その ID を presetId として渡します。
権限:presets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
nodeType | string | 必須。ノードの種類です。たとえば generate-image です。 |
presetId | string | 必須。generate-image/location-board のような標準プリセットの ID か、自分のプリセットの ID です。 |
戻り値:プリセットの設定で、minReferences、needsImage、favorite、previewUrl(プリセットに画像がない場合は null)が含まれます。ID に一致するプリセットがない場合は、エラーが返されます。
save_node_preset
自分のノードプリセットを保存します。プリセットを作成するには、nodeType、name、data(get_node_preset が返すようなノードの設定)を渡します。プリセットを更新するには、presetId と、変更する内容だけを渡します。
権限:assets:write。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
presetId | string | 更新する自分のプリセットです。プリセットを作成する場合は省略します。 |
nodeType | string | 作成するときは必須です。たとえば generate-image です。 |
name | string | 作成するときは必須で、最大 120 文字です。名前はノードの種類ごとに一意である必要があり、重複すると name_taken が返されます。 |
description | string | 任意で、最大 500 文字です。 |
data | object | ノードの設定で、最大 64 KB です。作成するときは必須です。 |
previewUrl | string または null | 作例の画像です。アップロードや完成した結果など、すでに Nodaro に保存されている画像を指定します。null で削除します。 |
expectedUpdatedAt | string | 読み取ったときのプリセットの updatedAt です。その後にプリセットが変更されていた場合、更新は conflict で拒否されます。 |
戻り値:保存したプリセットの ID、名前、needsImage、minReferences、previewUrl、updatedAt です。同じ操作は、POST /v1/node-presets と PATCH /v1/node-presets/:id でも行えます。
delete_node_preset
自分のプリセットを削除します。標準プリセットは削除できません。自分のものではないプリセットには、not_found が返されます。
権限:assets:write。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
presetId | string | 必須。自分のプリセットの 1 つです。 |
expectedUpdatedAt | string | 読み取ったときのプリセットの updatedAt です。その後にプリセットが変更されていた場合、削除は拒否されます。 |
favorite_node_preset
プリセットをお気に入りに追加します。favorite: false を指定すると、お気に入りから外します。対象は、generate-image/character-board のような標準プリセットでも、自分のプリセットでもかまいません。お気に入りは、エディターのプリセット一覧の先頭に表示されます。ツールを 2 回実行しても、1 回実行した場合と同じ結果になります。
権限:assets:write。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
nodeType | string | 必須。ノードの種類です。たとえば generate-image です。 |
presetId | string | 必須。list_node_presets で取得したプリセット ID です。 |
favorite | boolean | デフォルトは true です。false でお気に入りから外します。 |
プリセットのフォルダー、プリセットの並び順、一括インポートを管理するツールはありません。これらはエディターの一覧を整理するためのもので、REST API、SDK、CLI で利用できます。
生成にプリセットを適用する
generate_image、generate_video、generate_music、generate_speech、text_to_audio は、presetId を受け付けます。Nodaro はサーバー側でプリセットの設定を適用し、自分で指定したフィールドはすべてプリセットより優先されます。プリセットにプロンプトが含まれている場合は、prompt を省略できます。プリセットにあるプロンプトの前後のテキストは、あなた自身のプロンプトの前後に付きます。generate_image では、プリセットはエディターと同じように適用され、デフォルト値のないプレースホルダーには variables で値を指定する必要があります。プリセットを適用するを参照してください。
generate_speech では、プリセットは速度、安定性、スタイルなどの話し方を調整します。その場合も、text は必須です。プリセットについて詳しくは、プリセットを参照してください。
よくある質問
アシスタントは、どのようにして適切なモデルを選びますか?
種類とモード(たとえば image と t2i)で絞り込んで、list_models を呼び出します。応答には、各モデルのアスペクト比、解像度、長さ、機能、料金と、画像内の文字に最適なモデルなどのおすすめが含まれます。
アシスタントから、クレジットの残高を確認できますか?
はい。Nodaro Cloud で、クレジットの権限を許可している場合は確認できます。check_balance は、サブスクリプションのクレジットとチャージしたクレジット、ティア、1 日の上限を返します。
credit_transactions で、生成ごとの料金はわかりますか?
はい。購入履歴に加えて、利用履歴を返します。クレジットで支払った実行ごとに 1 行です。利用額を知るには、それらの行の credits_charged を足し合わせてください。credits_reserved は確保した額で、それより大きいことがあるためです。
MCP でノードプリセットを使うにはどうすればよいですか?
list_node_presets でプリセットの ID を探し、presetId として generate_image、generate_video、generate_music、generate_speech、text_to_audio に渡します。自分で指定したフィールドは、プリセットより優先されます。
アシスタントに、ノードプリセットを保存してもらえますか?
はい。save_node_preset はノードの設定から自分のプリセットを作成または更新し、delete_node_preset はプリセットを削除し、favorite_node_preset はプリセットをお気に入りに追加します。3 つとも assets:write 権限が必要です。
関連ページ
MCP ツールリファレンス
Nodaro の AI モデル
クレジット
プリセット
モデルの選び方
最終更新