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

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

list_models

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

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

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

どのモデルにもモデルカタログにページがあり、同じ料金とより詳しい情報を掲載しています。

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 のみ。

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

list_node_presets

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

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

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

get_node_preset

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

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

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

生成にプリセットを適用する

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

generate_speech では、プリセットは速度、安定性、スタイルなどの話し方を調整します。その場合も、text は必須です。プリセットについて詳しくは、プリセットを参照してください。