Documento 010 · Credits Engine

O motor financeiro da K10AI Enterprise

Credits Engine & Cost Management: o sistema que controla créditos, tokens, custos, lucro, consumo, limites e precificação — com controle financeiro automático em tempo real.

CréditosTokensCustosLucroConsumoLimitesPrecificaçãoIA utilizadaControle financeiro automático
Índice

20 capítulos do motor de créditos

1Filosofia do sistema de créditos
2Modelo de cobrança
3Conversão Tokens → Créditos
4Créditos por Plano
5Consumo por IA
6Consumo por Agente
7Consumo por Workflow
8Consumo por Produto
9Estimativa antes da execução
10Reserva de créditos
11Reembolso automático
12Custos por provedor
13Dashboard financeiro
14Limites
15Alertas
16Otimização automática
17Simulador de lucro
18Política de créditos
19APIs
20Critérios de aprovação
Filosofia · Cobrança

Crédito como moeda única, com margem protegida

Filosofia do sistema

Todo consumo tem custo mensurávelCrédito é a moeda única da plataformaTransparência total de custo e margemCálculo em tempo real, sem surpresasLucro protegido por design (margem mínima)Previsibilidade antes de qualquer execução

Modelo de cobrança

Assinatura (planos recorrentes)Pré-pago (pacotes de créditos)Pós-pago (consumo medido)Híbrido (assinatura + excedente)Créditos bônus e promocionaisCupons e descontos
Conversão

De tokens a créditos K10AI

Cada execução é medida, precificada e registrada de forma imutável.

  1. 1Captura de tokens de entrada e saída
  2. 2Custo real por provedor e modelo
  3. 3Aplicação de margem e markup
  4. 4Conversão em créditos K10AI
  5. 5Registro imutável no ledger
Consumo

Rastreamento por IA, agente, workflow e produto

Consumo por IA

Modelo utilizadoTokens in/outCusto por provedorCache hits

Consumo por Agente

ExecuçõesFerramentas usadasPassos de raciocínioRetentativas

Consumo por Workflow

Nós executadosParalelismoIntegraçõesReprocessamentos

Consumo por Produto

CursosEbooksLanding pagesCopy e campanhas
Ciclo de crédito

Estimar, reservar, consumir e reembolsar

Estimativa antes da execução

O usuário vê o custo estimado em créditos antes de executar qualquer IA, agente ou workflow — sem surpresas.

Reserva de créditos

Créditos são reservados no início da operação e liquidados no fim, evitando saldo negativo e uso concorrente indevido.

Reembolso automático

Falhas, timeouts ou execuções canceladas devolvem os créditos reservados de forma automática e auditável.

Custos · Dashboard

Custo por provedor e visão financeira em tempo real

Custos por provedor

OpenAIAnthropicGoogle GeminiMistralGroqDeepSeekAzure OpenAI

Dashboard financeiro

ReceitaCusto de IAMargem de lucroCréditos consumidosCréditos restantesConsumo por usuárioConsumo por organizaçãoCusto por provedor
Governança

Limites e alertas inteligentes

Limites

Limite por usuárioLimite por organizaçãoLimite por projetoLimite por período (diário/mensal)Bloqueio automático ao atingir o tetoReset por ciclo de cobrança

Alertas

Alerta de saldo baixoAlerta de consumo anormalAlerta de limite atingidoAlerta de margem em riscoNotificações por email e in-app
Inteligência financeira

Otimização automática e simulador de lucro

Otimização automática

Roteamento para o modelo mais barato adequadoCache semântico de respostasCompressão e resumo de contextoFallback econômico em picosSugestões de economia ao usuário

Simulador de lucro

Simular custo por cenário de usoProjetar margem por planoComparar provedores e modelosEstimar break-even de créditosProjeção de receita recorrente (MRR)
APIs · Aprovação

Contratos e critérios de aprovação

APIs do motor de créditos

GET /credits/balancePOST /credits/estimatePOST /credits/reservePOST /credits/consumePOST /credits/refundGET /credits/ledgerGET /costs/providersGET /billing/summary

Critérios de aprovação

Todo consumo registrado no ledger imutávelEstimativa exibida antes da execuçãoReserva e reembolso funcionando de ponta a pontaMargem mínima garantida por operaçãoLimites e alertas operacionaisDashboard financeiro em tempo real

Controle financeiro automático, por design

Cada crédito é medido, precificado e auditado — protegendo a margem e dando previsibilidade total à K10AI.