Conceitos Fundamentais
O Que São Créditos?
Créditos são a unidade de medida que o EKB usa para rastrear e faturar o uso da plataforma. Em vez de faturar separadamente cada recurso subjacente (computação, chamadas de API, uso de LLM), os créditos fornecem uma moeda unificada que abstrai esses custos em um formato previsível. Os créditos são consumidos de duas maneiras:- Créditos de Ação da Plataforma são cobranças de tarifa fixa vinculadas a ações específicas do usuário — fazer upload de um documento, enviar uma mensagem de chat ou invocar uma ferramenta. São fixos e previsíveis, independentemente do tamanho do conteúdo ou do modelo usado.
- Créditos de Tokens LLM são cobranças variáveis com base no uso real do modelo de linguagem. Como os custos de LLM dependem de quanto texto entra e sai do modelo, esses créditos flutuam com base no tamanho do documento, no comprimento da resposta e na seleção do modelo.
O Que São Tokens?
Tokens são a unidade que os Modelos de Linguagem de Grande Escala usam para processar texto. Antes que qualquer texto seja lido ou gerado por um LLM, ele é dividido em tokens — pequenos fragmentos que correspondem aproximadamente a palavras ou partes de palavras. Como regra geral:- 1 token ≈ 4 caracteres, ou aproximadamente ¾ de uma palavra em inglês
- Um documento de 100.000 palavras é aproximadamente 133.000 tokens
- Uma frase curta como “Explain this document” tem cerca de 4–5 tokens
Tabela de Consumo de Créditos
A. Ingestão de Base de Conhecimento (KB)
Fazer upload de um documento para uma Base de Conhecimento aciona um pipeline de ingestão em várias etapas. Cada etapa tem sua própria estrutura de custos, e algumas etapas incorrem em Créditos de Tokens LLM adicionais dependendo da configuração do seu projeto. Pipeline de Ingestão
As etapas 2 e 4 são faturadas apenas quando habilitadas nas Configurações do seu Projeto. O chunking de documentos ocorre como parte da ingestão e pode incorrer em custos adicionais. Veja a Seção B para uma análise detalhada.
Exemplo – Documento de 10.000 palavras (sem etapas opcionais habilitadas)
Exemplo – Documento de 100.000 palavras (sem etapas opcionais habilitadas)
Exemplo – Documento de 100.000 palavras (todas as etapas habilitadas)
Quanto mais etapas opcionais você habilitar, maior o custo de ingestão por documento. O custo de upload baseado em palavras é sempre fixo e previsível.
B. Chunking de Documentos
O chunking é a etapa entre a extração do documento e a incorporação (embedding). Ele pega o texto limpo de um documento carregado e o divide em partes menores (trechos) que são indexados no armazenamento vetorial e posteriormente recuperados para consultas de Chat ou Agente. Os custos de chunking se dividem em duas categorias:- Chunking da Plataforma: Operações determinísticas (tokenização, divisão, montagem de metadados) que são executadas localmente no servidor e não são faturadas como uso de LLM.
- Enriquecimento de Trechos (Créditos de Tokens LLM): Faturado apenas quando Enriquecimento de Trechos está habilitado para o projeto nas Configurações da Base de Conhecimento. O LLM gera um prefixo de contexto curto para cada trecho; tokens de entrada e saída são cobrados.
Exemplo: Custos de Chunking de Documentos
O exemplo a seguir assume um documento de tamanho moderado com Enriquecimento de Trechos habilitado:- Tamanho do documento: 100.000 palavras (~133.000 tokens de entrada, a 4 chars/token)
- Configurações de trecho:
chunk_size=64 tokens,chunk_overlap=10 tokens→ ~2.300 trechos - Enriquecimento de Trechos: Habilitado com
gpt-4o-mini - Texto de saída (trechos unidos incl. prefixos de enriquecimento): ~140.000 tokens de saída
- Preços do modelo (exemplo): entrada
$0.15por 1M tokens, saída$0.60por 1M tokens
Portanto,
$0.104 (custo total LLM) / $0.01 (custo por crédito) equivale a 10.4 créditos, exibidos como ~10 créditos.
Se o mesmo documento fosse carregado sem Enriquecimento de Trechos habilitado, o chunking consumiria 0 Créditos de Tokens LLM.
C. Interação no Chat / Agente
Créditos fixos da plataforma
Créditos variáveis de Tokens LLM
Os créditos LLM são calculados como:
(Input Tokens × Input Rate) + (Output Tokens × Output Rate)
Exemplo de precificação (modelo de amostra Claude 4.5):
- Entrada: $3 por 1M tokens
- Saída: $15 por 1M tokens
D. Execuções de Fluxos de Trabalho
O custo é 1 crédito por execução, independentemente do número de etapas envolvidas.
E. Smart Tables
Smart Tables combinam extração com LLM e fluxos de trabalho orientados por agentes. O consumo de créditos depende do caminho de computação utilizado.Exemplo Completo de Chat
Cenário O usuário pergunta: “Explain the attached document.” Créditos da plataforma
Uso de tokens LLM
Convertido em créditos: 17 credits
Total final