Início Rápido
Comece em 2 minutos com rastreamento automático de tokens.
Referência da API - Ingestão de Eventos
Documentação completa da API para ingestão de eventos de uso.
Referência da API - Medidores
Aprenda como criar e configurar medidores para faturamento.
Guia de Faturamento Baseado em Uso
Guia abrangente para faturamento baseado em uso com medidores.
Perfeito para aplicativos SaaS, chatbots de IA, ferramentas de geração de conteúdo e qualquer aplicação alimentada por LLM que precise de faturamento baseado em uso.
Início Rápido
Comece com o rastreamento automático de tokens LLM em apenas 2 minutos:1
Instale o SDK
Instale os Blueprint de Ingestão do Dodo Payments:
2
Obtenha suas Chaves de API
Você precisará de duas chaves de API:
- Chave de API do Dodo Payments: Obtenha-a no Painel do Dodo Payments
- Chave de API do Provedor LLM: Do AI SDK, OpenAI, Anthropic, Groq, etc.
3
Crie um Medidor no Dodo Payments
Antes de rastrear o uso, crie um medidor no seu painel do Dodo Payments:Para instruções detalhadas, consulte o Guia de Faturamento Baseado em Uso.
- Faça login no Painel do Dodo Payments
- Navegue até Produtos → Medidores
- Clique em “Criar Medidor”
- Configure seu medidor:
- Nome do Medidor: Escolha um nome descritivo (ex: “Uso de Tokens LLM”)
- Nome do Evento: Defina um identificador de evento único (ex:
llm.chat_completion) - Tipo de Agregação: Selecione
sumpara somar contagens de tokens - Sobre a Propriedade: Escolha o que rastrear:
inputTokens- Rastrear tokens de entrada/promptoutputTokens- Rastrear tokens de saída/compleção (inclui tokens de raciocínio quando aplicável)totalTokens- Rastrear tokens combinados de entrada + saída
O Nome do Evento que você definir aqui deve corresponder exatamente ao que você passa para o SDK (sensível a maiúsculas e minúsculas).
4
Rastrear Uso de Tokens
Envolva seu cliente LLM e comece a rastrear automaticamente:
É isso! Cada chamada de API agora rastreia automaticamente o uso de tokens e envia eventos para o Dodo Payments para faturamento.
Configuração
Configuração do Rastreador
Crie um rastreador uma vez na inicialização do aplicativo com estes parâmetros obrigatórios:Sua chave de API do Dodo Payments. Obtenha-a na página de Chaves de API.
O modo de ambiente para o rastreador.
test_mode- Use para desenvolvimento e testelive_mode- Use para produção
O nome do evento que aciona seu medidor. Deve corresponder exatamente ao que você configurou no seu medidor do Dodo Payments (sensível a maiúsculas e minúsculas).
Este nome de evento vincula seu uso rastreado ao medidor correto para cálculos de faturamento.
Configuração do Wrapper
Ao envolver seu cliente LLM, forneça estes parâmetros:Sua instância de cliente LLM (OpenAI, Anthropic, Groq, etc.).
O identificador único do cliente para faturamento. Isso deve corresponder ao seu ID de cliente no Dodo Payments.
Dados adicionais opcionais para anexar ao evento de rastreamento. Útil para filtragem e análise.
Exemplo Completo de Configuração
Rastreamento Automático: O SDK rastreia automaticamente o uso de tokens em segundo plano sem modificar a resposta. Seu código permanece limpo e idêntico ao uso dos SDKs do provedor original.
Provedores Suportados
O LLM Blueprint funciona perfeitamente com todos os principais provedores e agregadores de LLM:AI SDK (Vercel)
AI SDK (Vercel)
Rastreie o uso com o Vercel AI SDK para suporte universal de LLM.Métricas Rastreadas:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Nome do modelo
Ao usar modelos com capacidade de raciocínio através do AI SDK (como o Gemini 2.5 Flash do Google com modo de pensamento), os tokens de raciocínio são automaticamente incluídos na contagem de
outputTokens para faturamento preciso.OpenRouter
OpenRouter
Rastreie o uso de tokens em mais de 200 modelos através da API unificada do OpenRouter.Métricas Rastreadas:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nome do modelo
OpenAI
OpenAI
Rastreie automaticamente o uso de tokens dos modelos GPT do OpenAI.Métricas Rastreadas:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nome do modelo
Anthropic Claude
Anthropic Claude
Rastreie o uso de tokens dos modelos Claude da Anthropic.Métricas Rastreadas:
input_tokens→inputTokensoutput_tokens→outputTokenstotalTokenscalculado- Nome do modelo
Groq
Groq
Rastreie a inferência ultra-rápida de LLM com Groq.Métricas Rastreadas:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nome do modelo
Google Gemini
Google Gemini
Rastreie o uso de tokens dos modelos Gemini do Google através do Google GenAI SDK.Métricas Rastreadas:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Versão do modelo
Modo de Pensamento do Gemini: Ao usar modelos Gemini com capacidades de raciocínio (como o Gemini 2.5 Pro), o SDK inclui automaticamente
thoughtsTokenCount (tokens de raciocínio) em outputTokens para refletir com precisão o custo computacional total.Uso Avançado
Múltiplos Provedores
Rastreie o uso em diferentes provedores de LLM com rastreadores separados:Integração da API Express.js
Exemplo completo de integração do rastreamento LLM em uma API Express.js:O que é Rastreado
Cada chamada de API LLM envia automaticamente um evento de uso para o Dodo Payments com a seguinte estrutura:Campos do Evento
Identificador único para este evento específico. Gerado automaticamente pelo SDK.Formato:
llm_[timestamp]_[random]O ID do cliente que você forneceu ao envolver o cliente. Usado para faturamento.
O nome do evento que aciona seu medidor. Corresponde à sua configuração de rastreador.
Timestamp ISO 8601 quando o evento ocorreu.
Uso de tokens e dados adicionais de rastreamento:
inputTokens- Número de tokens de entrada/prompt usadosoutputTokens- Número de tokens de saída/compleção usados (inclui tokens de raciocínio quando aplicável)totalTokens- Total de tokens (entrada + saída)model- O modelo LLM usado (ex: “gpt-4”)provider- O provedor LLM (se incluído nos metadados do wrapper)- Quaisquer metadados personalizados que você forneceu ao envolver o cliente
Tokens de Raciocínio: Para modelos com capacidades de raciocínio,
outputTokens inclui automaticamente tanto os tokens de conclusão quanto os tokens de raciocínio.Seu medidor do Dodo Payments usa os campos
metadata (especialmente inputTokens, outputTokens ou totalTokens) para calcular uso e faturamento.