# Como funciona a cobrança de IA na TagoIO: AI Credits e AI Wallet

> A cobrança de IA na TagoIO usa AI Credits pré-pagos, gerenciados na AI Wallet. Veja como são consumidos, acompanhados, limitados por perfil e quando expiram.

![Como funciona a cobrança de IA na TagoIO: AI Credits e AI Wallet](https://tago.io/og/pt-br/blog/how-ai-billing-works-in-tagoio.png)

Sua equipe está montando dashboards e respondendo perguntas sobre os dispositivos com ajuda de IA, e esse uso tem um custo. A questão é onde esse custo fica e como mantê-lo sob controle. Na TagoIO, a cobrança de IA funciona com AI Credits: um saldo pré-pago na sua conta que paga os modelos de IA conforme o uso, gerenciado em um único lugar do Admin chamado AI Wallet.

Este guia mostra o que os AI Credits pagam, como acompanhar e limitar o gasto com IA, quando os créditos expiram e o que muda na cobrança em uma instância dedicada do [TagoDeploy](https://tago.io/deploy).

![A aba Budget da AI Wallet no Admin da TagoIO: o saldo de créditos com View history e Top up, o limite mínimo e o valor da recarga automática, e um teto de gastos mensal para cada perfil.](https://tago.io/images/blog/how-ai-billing-works-in-tagoio/ai-wallet-budget.webp)

## O que é a AI Wallet da TagoIO?

A AI Wallet é a tela de cobrança e uso de IA dentro do Admin da TagoIO. Ela guarda seus AI Credits pré-pagos, mostra o saldo atual e a moeda, e registra cada movimentação da conta: compras, consumo, expirações e ajustes feitos pelo suporte da TagoIO. O saldo pertence à conta, não a um perfil, então todos os perfis usam esse mesmo saldo. Como a carteira fica no Admin, você gerencia os custos de IA no mesmo painel em que sua equipe constrói.

## Para que servem os AI Credits em uma aplicação IoT?

Os AI Credits custeiam os modelos pagos do catálogo de modelos de IA da TagoIO, cobrados conforme o uso. Cada requisição a um modelo pago desconta do seu saldo um valor que depende do preço do modelo e do tamanho da requisição. Esses modelos rodam por trás dos recursos do [TagoAI](https://tago.io/ai): o chat no Admin, a geração de AI Dashboards e o chat com IA nos seus portais TagoRUN.

Os créditos são separados do seu plano da TagoIO, então plano e gasto com IA não se misturam. Um modelo continua gratuito: cada perfil recebe uma cota mensal de requisições ao modelo gratuito de acordo com o plano, e o modelo gratuito nunca consome do seu saldo. Um perfil que usa o próprio provedor de IA não consome nada dos seus créditos.

## Como acompanhar o uso dos AI Credits?

As estatísticas de uso de IA mostram qual perfil gastou quanto, e onde: gasto e número de requisições por perfil, por modelo e por recurso, hora a hora, dia a dia ou mês a mês. As requisições gratuitas e as de provedor próprio também aparecem ali, com gasto zero, então a atividade total fica lado a lado com o que ela custa.

A carteira mostra como os créditos entraram e saíram da conta. De relance, você vê o saldo atual, quantas compras ainda têm créditos não usados e a data em que o próximo lote expira. Cada compra, débito de consumo, expiração e ajuste do suporte entra no histórico. Dá para rastrear o gasto com IA sem exportar nada nem cruzar faturas.

## O que acontece quando os AI Credits estão acabando?

Faça uma recarga manual pela carteira ou ative a recarga automática para o saldo se reabastecer sozinho. Cada compra vai de 10,00 a 1.000,00 na moeda da sua carteira, cobrada no cartão padrão da sua conta. Uma taxa de serviço entra na cobrança do cartão, e não no seu saldo, e o Admin mostra o valor atual da taxa antes de você confirmar.

Na recarga automática, você define um limite mínimo e um valor. Quando o saldo cai abaixo do limite mínimo, a TagoIO agenda uma compra no valor escolhido. Uma verificação em segundo plano roda a cada poucos minutos, então a recarga entra pouco depois de o saldo baixar, e não no instante exato da requisição que fez o saldo cair abaixo do limite. Uma requisição que chega antes de a recarga entrar ainda pode falhar por créditos insuficientes, então defina o limite mínimo com folga. Mantenha um cartão válido na conta para que as recargas sejam aprovadas: se a cobrança falhar, o saldo fica como está e a TagoIO não avisa você por e-mail.

## Como controlar o gasto com IA da equipe?

Defina um teto de gastos mensal opcional em cada perfil. Sem teto, o perfil aparece como Unlimited e pode gastar todo o saldo da conta. O teto limita quanto um perfil pode gastar em um mês civil, contado em UTC, e zera no início de cada mês. Quando um perfil atinge o teto, as requisições dele a modelos pagos são recusadas até o mês virar ou até você aumentar o teto. O teto não separa uma fatia do saldo: todos os perfis continuam consumindo do mesmo saldo da conta.

Você também decide quais modelos cada perfil usa. Em Profile Settings, depois AI models, você define o modelo padrão para o chat, para a geração de AI Dashboards e para o TagoRUN. Ative a opção Curate the menu para restringir os modelos que os usuários do chat podem escolher, por exemplo, o modelo gratuito e um modelo do catálogo. Assim, o perfil só usa os modelos que você previu para ele.

## Os AI Credits expiram?

Sim. Os créditos expiram um ano depois da compra que os gerou. O consumo sempre usa primeiro os créditos mais próximos do vencimento, então os mais antigos saem da carteira antes dos mais novos. Créditos expirados aparecem no histórico e não são reembolsáveis, um bom motivo para dimensionar a recarga automática pelo seu uso real em vez de comprar um saldo grande que você não vai conseguir gastar em um ano.

## Posso usar meu próprio provedor de IA?

Sim. Um perfil pode usar o próprio provedor de IA no lugar do catálogo da TagoIO: OpenAI, Anthropic, AWS Bedrock, Google Gemini ou OpenRouter, conectado em Profile Settings, depois Services, depois AI Provider. Esse provedor cobra você diretamente, e essas requisições não mexem nos seus AI Credits nem contam para o teto de gastos. A exceção é o modelo gratuito: ele continua rodando do lado da TagoIO e segue descontando da cota mensal.

## Como funciona a cobrança de IA no TagoDeploy?

O TagoDeploy não tem saldo de AI Credits. Em uma instância dedicada, o uso de modelos pagos roda com as credenciais do provedor de IA da própria instância e é precificado pelo catálogo da instância para medição e aplicação do teto. A TagoIO não cobra nada por esse uso: quem paga é a conta de provedor da instância. Os relatórios de uso e os tetos de gastos por perfil continuam valendo, medidos pelo valor do catálogo.

## Perguntas frequentes sobre AI Credits

**Qual a diferença entre os AI Credits e o meu plano da TagoIO?**

São cobranças independentes. O plano cobre a plataforma, incluindo a cota mensal de requisições do modelo gratuito. Os AI Credits cobrem o uso de modelos pagos, faturado por consumo.

**Em que moeda são os AI Credits?**

USD ou EUR, definida na criação da carteira de acordo com a região da sua conta: USD para contas na região dos EUA, EUR para contas na região da UE. A TagoIO não faz conversão de moeda, então preços, compras, tetos e cobranças usam sempre essa mesma moeda.

**O modelo gratuito consome créditos?**

Não. O modelo gratuito roda dentro de uma cota mensal de requisições definida pelo plano do perfil e nunca consome do seu saldo.

**E se a cobrança de uma recarga automática falhar?**

O saldo não se altera, as requisições a modelos pagos passam a falhar quando o saldo não for mais suficiente, e a recarga automática tenta de novo nas verificações seguintes. Nenhum e-mail é enviado e a cobrança que falhou não aparece no histórico, então mantenha um cartão válido na conta.

A referência completa, com cada mensagem de erro e o que fazer em cada caso, está no [guia de AI Credits](https://docs.tago.io/docs/tagoio/tago-ai/ai-credits).

[llms.txt](https://tago.io/llms.txt)