Feature

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

Na TagoIO, os AI Credits são gerenciados na AI Wallet. Veja como os créditos são consumidos, acompanhados e limitados por perfil, e quando expiram.

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

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.

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.

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: 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.