For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/mobile/usage.md (or send Accept: text/markdown).
Uso e créditos
Limites medidos, crédito pré-pago e a superfície de faturação.
Lê o estado de uso
GET /api/mobile/usage devolve o orçamento de IA como strings decimais em microunidades — budgetMicrounits, committedMicrounits, heldMicrounits e keyMode — o saldo de crédito pré-pago, linhas por medidor com label, used, limit, cap, planLimit e description, e os limites do período atual. A apresentação marca um medidor como aviso aos oitenta por cento e como perigo aos cem.
Os valores são strings decimais, não números JSON — faz parse antes de comparar ou formatar para que orçamentos grandes se mantenham exatos.
Livro-razão de crédito pré-pago
GET /api/mobile/credits devolve o saldo pré-pago do workspace e as suas últimas cinquenta linhas de livro-razão. O saldo alimenta Configurações → Faturação e o cartão de uso do ecrã inicial; os ids de referência do livro-razão ficam de fora do payload do cliente.
Superfícies de home e faturação
O ecrã inicial reutiliza GET /api/workspace/metrics — a mesma grelha de estatísticas que o dashboard web renderiza: gasto mensal de IA, contagens de tarefas e threads, membros, convites pendentes, estado do plano e notificações por ler. O seu cartão de uso mostra a linha de IA mais os medidores de limite finito, e os tiles de ação rápida ligam a chat, assistente, conteúdo, comércio, notificações, feedback e configurações.
Configurações → Faturação mostra o plano, a expiração, o saldo de crédito e os medidores de uso, explica a diferença entre faturação de loja e de web e liga ao paywall. Uma schedule do servidor varre os workspaces a cada quinze minutos e notifica owners e admins uma vez por mês aos oitenta e cem por cento do orçamento de IA.
Verificação e resolução de problemas
Verifica um medidor perto do limite, um saldo de crédito esgotado e um workspace no orçamento predefinido. Uma ação bloqueada tem de apontar para o medidor que a negou, não para um erro genérico.