# API sem assinatura

> A API, o SDK, a CLI e o MCP do Nodaro funcionam sem assinatura. Compre créditos uma vez, pague por resultado com todos os modelos e use-os por 12 meses.

Source: https://nodaro.ai/pt-BR/docs/developers/pay-as-you-go

**A API REST, o SDK, a CLI e o MCP do Nodaro funcionam sem assinatura.** Você compra créditos uma vez, e cada resultado custa os créditos do modelo que o criou. Não há mensalidade, e os créditos valem por 12 meses a partir da compra.

## O que você recebe sem assinatura
Comprar qualquer pacote de créditos, ou carregar qualquer valor, ativa o pagamento por uso:

| | Pagamento por uso |
| --- | --- |
| **Modelos** | Todos os modelos ficam liberados |
| **Marca d’água** | Nenhuma |
| **Limite diário** | Nenhum |
| **Validade dos créditos** | 12 meses a partir da compra |
| **Onde você gasta os créditos** | A [API REST](https://nodaro.ai/docs/developers/api), o [SDK](https://nodaro.ai/docs/developers/sdk), a [CLI](https://nodaro.ai/docs/developers/cli) e o [MCP](https://nodaro.ai/docs/mcp) |
| **O editor no navegador** | Exige uma assinatura |
| **Seus resultados na Galeria** | Públicos. O modo privado é um recurso das assinaturas, a partir do plano Standard |

[Créditos](https://nodaro.ai/docs/concepts/credits) explica cada tipo de crédito e quais são gastos primeiro.

## Quanto custa um resultado
Cada modelo tem o próprio preço por resultado. O preço é o mesmo no editor, na API e no MCP, e aparece em cada [página de modelo](https://nodaro.ai/docs/models).

| Resultado | Modelo | Créditos |
| --- | --- | --- |
| Uma imagem, 1K | [Nano Banana 2](https://nodaro.ai/docs/models/image/nano-banana-2) | 22 |
| Uma imagem, 2K | [GPT Image 2](https://nodaro.ai/docs/models/image/gpt-image-2) | 42 |
| Um vídeo, 8 segundos com som, 720p | [VEO 3.1 Fast](https://nodaro.ai/docs/models/video/veo-3-1-fast) | 165 |
| Um vídeo, 5 segundos, 1080p | [Kling 3.0](https://nodaro.ai/docs/models/video/kling-3-0) | 297 |
| Um vídeo, 6 segundos, 2K | [MiniMax H3](https://nodaro.ai/docs/models/video/minimax-h3) | 605 |

O seu código pode pedir um preço antes de executar: `GET /v1/credits/model-cost?model=<model id>` é público e responde com os créditos de um modelo. [API de créditos](https://nodaro.ai/docs/developers/api/credits) lista as outras consultas de preço.

## Começar em quatro etapas
### Criar uma conta
Cadastre-se no [Nodaro Cloud](https://app.nodaro.ai). Toda conta nova recebe [1.500 créditos grátis](https://nodaro.ai/docs/get-started/free-credits) uma vez. Os resultados feitos com eles têm marca d’água até a sua primeira compra.

### Comprar créditos
Compre um pacote de créditos, ou carregue um valor, na página **Cobrança**. A [página de preços](https://app.nodaro.ai/pricing) mostra os pacotes e os valores que você pode carregar.

### Criar um token de API
Abra **Configurações › Tokens de API** e clique em **Criar token**. O token começa com `ndr_` e só aparece uma vez. [Autenticação](https://nodaro.ai/docs/developers/api/authentication) explica os tokens e os limites de taxa deles.

### Fazer a primeira chamada
Inicie uma tarefa e depois consulte-a periodicamente até que ela termine:

```bash
export NODARO_API_KEY="ndr_..."

curl -s -X POST https://app.nodaro.ai/v1/generate-image \
  -H "Authorization: Bearer $NODARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a snow leopard on a mountain ridge at dawn", "provider": "nano-banana-2", "aspectRatio": "16:9"}'
# {"jobId":"0f1a9c2e-5b7d-4e8a-9c31-6d2f8b4a7e10"}

curl -s https://app.nodaro.ai/v1/jobs/0f1a9c2e-5b7d-4e8a-9c31-6d2f8b4a7e10/status \
  -H "Authorization: Bearer $NODARO_API_KEY"
```

[A sua primeira chamada](https://nodaro.ai/docs/developers/api#your-first-call) mostra a mesma chamada com o SDK e a CLI.

## Ou deixe um assistente de IA gastá-los
Os mesmos créditos pagam o MCP. Conecte o Claude, o ChatGPT, o Cursor ou o VS Code ao Nodaro, e o assistente executa os modelos para você pelos mesmos preços. [Criar com seu assistente](https://nodaro.ai/docs/mcp/create) mostra quatro pedidos reais com os preços deles, e [Conectar um cliente](https://nodaro.ai/docs/mcp/connect) traz a configuração.

## Como os gastos funcionam
- **Uma tarefa reserva o próprio preço quando começa.** Quando o seu saldo não cobre esse valor, a chamada responde `402 insufficient_credits`.
- **Uma tarefa com falha devolve os créditos.** A exceção é uma falha depois que o modelo já entregou o resultado.
- **Uma única chamada mostra o seu saldo.** `GET /v1/credits/balance` retorna o saldo, e no MCP, `check_balance` faz o mesmo.
- **A recarga automática pode recarregar por você.** Na página **Cobrança**, defina um saldo abaixo do qual o Nodaro carrega um novo valor, cobrado no seu cartão salvo.

[API de créditos](https://nodaro.ai/docs/developers/api/credits) trata das reservas, dos reembolsos e do histórico de transações.

## Perguntas frequentes

### Preciso de uma assinatura para usar a API do Nodaro?

Não. Compre créditos uma vez, e a API REST, o SDK, a CLI e o MCP os gastam por resultado. Não há mensalidade, e os créditos valem por 12 meses a partir da compra.

### O que os créditos do pagamento por uso liberam?

Todos os modelos, sem marca d’água e sem limite diário. Seus resultados são públicos na Galeria; o modo privado é um recurso das assinaturas, a partir do plano Standard.

### Posso usar o editor no navegador sem assinatura?

Não. Os créditos do pagamento por uso são gastos pela API REST, pelo SDK, pela CLI e pelo MCP. Usar o editor no navegador exige uma assinatura.

### Quanto custa uma imagem ou um vídeo?

O preço depende do modelo e é o mesmo no editor, na API e no MCP. Por exemplo, uma imagem 1K com o Nano Banana 2 custa 22 créditos, e um vídeo de 8 segundos com som do VEO 3.1 Fast custa 165 créditos.

### O que acontece com os 1.500 créditos grátis?

Toda conta nova os recebe uma vez, e eles funcionam no plano gratuito, com marca d’água nos resultados. A sua primeira compra libera todos os modelos e remove a marca d’água.
