Modelos e créditos

client.models retorna o catálogo de modelos de IA que uma instância do Nodaro oferece, e client.credits retorna seu saldo de créditos e o preço de qualquer modelo. Use os dois juntos para mostrar aos usuários quais modelos eles podem escolher e quanto custa cada execução. Os métodos chamam os mesmos endpoints da API REST de créditos. Preços e saldos existem no Nodaro Cloud; as instalações self-hosted Community e Business não têm sistema de créditos. Veja Créditos.

Métodos

client.models

models.list(opts?)

Retorna o catálogo de modelos (GET /v1/models), agrupado por tipo (imagem, vídeo, áudio) e por fabricante. Cada modelo traz seus recursos, seus preços em créditos no Nodaro Cloud e dicas curtas de prompt. O endpoint é público, e o servidor guarda a resposta em cache por 5 minutos. A ferramenta list_models do MCP retorna os mesmos dados.

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)
    }
  }
}

O resultado tem sections, uma por tipo, cada uma com families de modelos; recommendations, listas de IDs de modelos para tarefas comuns; e totalModels. Cada modelo tem estes campos:

O mesmo catálogo está nas páginas de Modelos. Para saber qual modelo usar, leia Como escolher um modelo.

client.credits

credits.balance()

Retorna seu saldo de créditos e seu nível (GET /v1/user/credits). Lança UnauthorizedError quando não há nenhum usuário conectado.

balance(): Promise<UserBalance>

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

Prefira effectiveTier a tier quando decidir o que mostrar.

credits.modelCosts(ids)

Consulta o preço em créditos de modelos e das variações deles em uma única chamada (POST /v1/credits/model-costs). Verifica no máximo os 50 primeiros identificadores.

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 associa cada identificador que tem preço ao seu preço em créditos.
• missing lista os identificadores que não têm preço. Mostre um traço para eles.
• errors lista os identificadores cuja consulta falhou. Os outros preços chegam mesmo assim.

Os identificadores de cada modelo estão no campo pricing de models.list() e na página de cada modelo. Configurações como qualidade, resolução e duração mudam o preço, então informe a variação que a execução vai usar. O preço é verificado de novo quando a execução começa, então esta chamada é uma prévia.

Mostrar os modelos com os preços

Monte um seletor de modelos para um nó, com o preço ao lado de cada modelo:

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
}))

Omita provider em uma execução para usar o modelo padrão do nó. Quando um usuário escolher um modelo, envie o ID dele como provider para client.nodes.runAndWait().