モデルとクレジット

client.models は、Nodaro インスタンスが提供する AI モデルのカタログを返し、client.credits はクレジット残高と、任意のモデルの料金を返します。この 2 つを組み合わせて使うと、ユーザーが選べるモデルと各実行の料金をあわせて表示できます。これらのメソッドは、クレジット REST API と同じエンドポイントを呼び出します。料金と残高があるのは Nodaro Cloud だけで、セルフホスティングの Community エディションと Business エディションにはクレジットの仕組みがありません。クレジットを参照してください。

メソッド

client.models

models.list(opts?)

モデルのカタログを返します（GET /v1/models）。種類（画像、動画、オーディオ）と開発元ごとにグループ化されています。各モデルには、その機能、Nodaro Cloud でのクレジット料金、短いプロンプトのコツが含まれます。このエンドポイントは公開されており、サーバーはレスポンスを 5 分間キャッシュします。MCP の list_models ツールも、同じデータを返します。

list(opts?: {
  kind?: "image" | "video" | "audio"
  mode?: string
  family?: string
  featuredOnly?: boolean
}): Promise<ModelsListResult>

const catalog = await client.models.list({ kind: "video", mode: "i2v" })

for (const section of catalog.sections) {
  for (const family of section.families) {
    for (const model of family.models) {
      console.log(family.family, model.id, model.durations, model.pricing?.[0]?.credits)
    }
  }
}

結果には、種類ごとの sections（それぞれにモデルの families を持ちます）、よくある用途向けのモデル ID のリストである recommendations、totalModels が含まれます。各モデルには、次のフィールドがあります。

同じカタログは、モデルのページにもあります。どのモデルを使うかについては、モデルの選び方を参照してください。

client.credits

credits.balance()

クレジット残高とティアを返します（GET /v1/user/credits）。ログインしているユーザーがいない場合は、UnauthorizedError をスローします。

balance(): Promise<UserBalance>

const balance = await client.credits.balance()
console.log(`${balance.total} credits (${balance.effectiveTier})`)

何を表示するか決める際は、tier より effectiveTier を優先してください。

credits.modelCosts(ids)

モデルとそのバリアントのクレジット料金を、1 回の呼び出しでまとめて調べます（POST /v1/credits/model-costs）。確認されるのは、最初の 50 件までの識別子です。

modelCosts(ids: string[]): Promise<{
  data: Record<string, number>
  missing: string[]
  errors: string[]
}>

const { data, missing } = await client.credits.modelCosts([
  "nano-banana-pro",
  "nano-banana-pro:4K",
  "seedance-2-fast:8s:720p",
])
console.log(data["nano-banana-pro:4K"])
if (missing.length) console.warn("No price for:", missing)

• data には、料金が付いている各識別子と、そのクレジット料金の対応が入ります。
• missing には、料金がない識別子が列挙されます。これらにはダッシュを表示してください。
• errors には、調べるのに失敗した識別子が列挙されます。それ以外の料金は、そのまま返されます。

各モデルの識別子は、models.list() の pricing フィールドと、各モデルのページにあります。品質、解像度、長さなどの設定によって料金が変わるため、実行で使うバリアントを指定してください。実行時の料金は、実行が始まるときにもう一度確認されるため、この呼び出しはあくまで見積もりです。

モデルと料金をあわせて表示する

1 つのノード向けに、各モデルの料金を隣に添えたモデルピッカーを作ります。

const { data: node } = await client.nodes.get("generate-video")
const { data: prices } = await client.credits.modelCosts(node.providers ?? [])

const options = (node.providers ?? []).map((id) => ({
  id,
  price: prices[id] ?? null, // null: no price on this instance
}))

ノードのデフォルトモデルを使うには、実行時に provider を省略します。ユーザーがモデルを選んだ場合は、その ID を provider として client.nodes.runAndWait() に送ります。