# Modelos, créditos e predefinições

> Liste os modelos do Nodaro com recursos e preços em créditos, leia seu saldo e suas compras e aplique predefinições de nó a partir de um assistente de IA.

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

As **ferramentas de modelos, créditos e predefinições** ajudam um assistente a escolher bem uma geração e a pagar por ela. `list_models` retorna todos os modelos com seus recursos e preços, `check_balance` e `credit_transactions` mostram os seus créditos no Nodaro Cloud, e `list_node_presets` e `get_node_preset` encontram as configurações prontas que você pode aplicar a uma geração.

## `list_models`
Retorna os modelos disponíveis nesta instância do Nodaro, agrupados por tipo e desenvolvedor, com uma ficha de recursos de cada modelo. Chame-a antes de uma ferramenta de geração quando o usuário não tiver escolhido um modelo.

**Permissão:** nenhuma, sempre visível. **Créditos:** grátis.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `kind` | string | `image`, `video` ou `audio`. |
| `mode` | string | Uma operação, como `t2i` (texto para imagem), `i2i`, `edit`, `upscale`, `remove-bg`, `i2v` (imagem para vídeo), `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` ou `video-audit`. |
| `family` | string | Um desenvolvedor, como `Google`, `OpenAI` ou `Bytedance`. |
| `featuredOnly` | boolean | Somente o melhor modelo de cada nível, escolhido pela equipe do Nodaro. |

**Retorna:** para cada modelo, as proporções, resoluções, qualidades, durações e funcionalidades e, nas edições com créditos, o preço de cada variante. Uma lista `recommendations` indica os melhores modelos para usos comuns, como texto em imagens ou a imagem realista mais barata. Os modelos com dicas de prompt próprias, como o Seedance 2.0, também trazem `promptTips`, regras curtas para aplicar antes de uma geração de vídeo.

Cada modelo também tem uma página no [catálogo de modelos](https://nodaro.ai/docs/models), com os mesmos preços e mais detalhes.

## `check_balance`
Retorna o seu saldo de créditos, dividido em créditos da assinatura e créditos de recarga, com o total. Também retorna o seu limite diário de gastos, a sua cota mensal, o seu nível e o fim do período de cobrança.

**Permissão:** `credits:read`. **Créditos:** grátis. **Somente no Nodaro Cloud.**

Esta ferramenta não tem parâmetros.

**Retorna:** o saldo e os detalhes do plano.

- **Quais créditos são usados primeiro.** Os créditos da assinatura são gastos primeiro e são redefinidos a cada ciclo de cobrança. Os créditos de recarga valem por 12 meses após a compra.
- **Pagamento por uso.** Um `effectiveTier` igual a `payg` significa que você não tem assinatura, mas comprou créditos. Você tem todos os modelos, sem marca d’água e sem limite diário.
- **Contas de cobrança compartilhadas.** Numa implantação em que uma única conta de cobrança paga por todos, um cliente conectado não consegue ler o saldo dessa conta. A ferramenta responde `payer_balance_jwt_only`.

## `credit_transactions`
Lista as suas compras recentes: assinaturas, recargas e reembolsos. Cada linha tem `type`, `amount_usd`, `credits_granted`, `tier`, `created_at` e `receipt_url`, o link para o recibo, quando houver.

**Permissão:** `credits:read`. **Créditos:** grátis. **Somente no Nodaro Cloud.**

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `limit` | integer | De 1 a 100. |
| `cursor` | string | O cursor da página anterior. |

**Retorna:** as linhas de compras. Os créditos gastos em cada geração não estão nesta lista: cada job traz os próprios `credits`, e a API REST lista os gastos com `GET /v1/credits/transactions`.

## `list_node_presets`
Lista as predefinições de um tipo de nó: as integradas, como **Painel de personagem** ou **Retrato cinematográfico**, e as que você salvou. Uma predefinição é uma configuração nomeada de um nó, com o modelo, o prompt e as configurações dele.

**Permissão:** `presets:read`. **Créditos:** grátis.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `nodeType` | string | O tipo de nó, por exemplo `generate-image`. Obrigatório para incluir as predefinições integradas. |
| `source` | string | `all` (padrão) para as predefinições integradas e as salvas, `factory` só para as integradas, `custom` só para as suas. |

**Retorna:** o nome, o ID e a descrição de cada predefinição.

## `get_node_preset`
Retorna a configuração completa de uma predefinição: o modelo, o prompt, a proporção, a resolução, a qualidade, o prompt negativo e o texto que ela adiciona antes e depois do prompt. Use-a para aplicar uma predefinição com exatidão, copiando os campos para uma ferramenta de geração ou passando o ID dela como `presetId`.

**Permissão:** `presets:read`. **Créditos:** grátis.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `nodeType` | string | **Obrigatório.** O tipo de nó, por exemplo `generate-image`. |
| `presetId` | string | **Obrigatório.** O ID de uma predefinição integrada, como `generate-image/location-board`, ou o ID de uma predefinição sua. |

**Retorna:** a configuração da predefinição, ou um erro quando o ID não corresponde a nenhuma predefinição.

## Aplicar uma predefinição a uma geração
`generate_image`, `generate_video`, `generate_music`, `generate_speech` e `text_to_audio` aceitam `presetId`. O Nodaro aplica a configuração da predefinição no servidor, e cada campo que você mesmo informa a substitui. Quando a predefinição contém um prompt, você pode omitir `prompt`. O texto que a predefinição põe antes e depois do prompt envolve o seu próprio prompt.

Em `generate_speech`, uma predefinição ajusta a locução, como a velocidade, a estabilidade e o estilo, e `text` continua obrigatório. Leia mais sobre predefinições em [Predefinições](https://nodaro.ai/docs/concepts/presets).

## Frequently asked questions

### Como um assistente escolhe o modelo certo?

Ele chama list_models, filtrando por tipo e modo, por exemplo image e t2i. A resposta lista as proporções, resoluções, durações, funcionalidades e preços de cada modelo, além de recomendações, como o melhor modelo para texto em imagens.

### Um assistente pode ver quantos créditos eu tenho?

Sim, no Nodaro Cloud, se você tiver concedido a permissão de créditos. check_balance retorna os seus créditos da assinatura e de recarga, o seu nível e o seu limite diário.

### credit_transactions mostra quanto custou cada geração?

Não. Ela lista compras, como assinaturas, recargas e reembolsos. Os créditos gastos em cada geração ficam registrados em cada job, e a API REST os lista.

### Como uso uma predefinição de nó pelo MCP?

Encontre o ID dela com list_node_presets e passe presetId para generate_image, generate_video, generate_music, generate_speech ou text_to_audio. Os campos que você mesmo informa substituem os da predefinição.