> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blueprints de Ingestão

> Padrões de ingestão de eventos prontos para casos de uso comuns com código de exemplo.

Blueprints de ingestão são padrões pré-construídos para rastrear o uso em cenários comuns. Em vez de descobrir estruturas de eventos e configurações de medição do zero, comece com um blueprint comprovado e personalize-o para suas necessidades.

## O que são Blueprints?

Cada blueprint inclui:

* **Recomendações de estrutura de eventos**: Nomenclatura de eventos e design de metadados ideais
* **Configuração de medição**: Tipos de agregação e filtros sugeridos
* **Código de exemplo**: Exemplos de implementação funcional em várias linguagens
* **Melhores práticas**: Dicas para precisão, desempenho e otimização de custos

<Tip>
  Os blueprints economizam horas de configuração e ajudam você a evitar armadilhas comuns. Comece com um blueprint e depois adapte-o aos seus requisitos específicos.
</Tip>

## Por que usar Blueprints?

<CardGroup cols={3}>
  <Card title="Faster Setup" icon="rocket">
    Faça o rastreamento de uso funcionar em minutos em vez de horas. Copie padrões comprovados em vez de projetar do zero.
  </Card>

  <Card title="Best Practices Built In" icon="shield-check">
    Evite erros comuns com estruturas de eventos testadas, metadados apropriados e escolhas de agregação ideais.
  </Card>

  <Card title="Production Ready" icon="code">
    O código de exemplo baseia-se em implementações reais. Basta adicionar suas chaves de API e começar.
  </Card>
</CardGroup>

## Blueprints Disponíveis

Escolha o blueprint que corresponde ao seu caso de uso:

<CardGroup cols={1}>
  <Card title="LLM Blueprint" icon="brain-circuit" href="/developer-resources/ingestion-blueprints/llm">
    Monitore o uso de tokens de IA em OpenAI, Anthropic, Groq, Gemini, Vercel AI SDK e mais.

    **Perfeito para**: Chatbots de IA, geradores de código, ferramentas de criação de conteúdo, aplicativos com IA.

    **O que você rastreará**: tokens de entrada, tokens de saída, uso de modelo, contagens de solicitações.
  </Card>

  <Card title="API Gateway Blueprint" icon="cloud" href="/developer-resources/ingestion-blueprints/api-gateway">
    Mensure solicitações de API no nível do gateway com filtragem de endpoint e suporte a limitação de taxa.

    **Perfeito para**: APIs REST, serviços GraphQL, provedores de webhook, plataformas API-first.

    **O que você rastreará**: contagens de solicitações, uso de endpoints, métodos HTTP, tempos de resposta.
  </Card>

  <Card title="Object Storage Blueprint" icon="box-archive" href="/developer-resources/ingestion-blueprints/object-storage">
    Monitore uploads de arquivos, consumo de armazenamento e largura de banda para serviços de armazenamento em nuvem.

    **Perfeito para**: Hospedagem de arquivos, plataformas de mídia, serviços de backup, gerenciamento de documentos.

    **O que você rastreará**: bytes armazenados, uploads de arquivos, downloads, snapshots de armazenamento.
  </Card>

  <Card title="Stream Blueprint" icon="tower-broadcast" href="/developer-resources/ingestion-blueprints/stream">
    Meça a largura de banda de streaming para vídeo, áudio e entrega de dados em tempo real.

    **Perfeito para**: Streaming de vídeo, plataformas de áudio, transmissões ao vivo, feeds de dados em tempo real.

    **O que você rastreará**: largura de banda consumida, duração do fluxo, níveis de qualidade, fluxos simultâneos.
  </Card>

  <Card title="Time Range Blueprint" icon="clock" href="/developer-resources/ingestion-blueprints/time-range">
    Fature pelo tempo decorrido para recursos de computação, funções serverless e jobs de longa duração.

    **Perfeito para**: Plataformas serverless, hospedagem de contêineres, instâncias de computação, processamento em lote.

    **O que você rastreará**: tempo de execução, horas de computação, invocações de função, duração do job.
  </Card>
</CardGroup>

## Como Usar um Blueprint

<Steps>
  <Step title="Choose your blueprint">
    Selecione o blueprint que melhor se adequa ao seu cenário de cobrança. Cada página de blueprint inclui guias detalhados de implementação.
  </Step>

  <Step title="Review the event structure">
    Compreenda a nomenclatura recomendada para eventos e o design de metadados. Copie a estrutura de eventos para o seu caso de uso.
  </Step>

  <Step title="Create the meter">
    Siga as instruções de configuração do medidor do blueprint. Use o tipo de agregação e os filtros sugeridos.
  </Step>

  <Step title="Implement event sending">
    Copie o código de exemplo para sua linguagem/framework. Substitua os valores de espaço reservado por suas chaves de API e IDs de cliente reais.
  </Step>

  <Step title="Test and verify">
    Envie eventos de teste e verifique se eles aparecem no painel do medidor com a agregação correta.
  </Step>

  <Step title="Customize as needed">
    Adapte o blueprint aos seus requisitos específicos — adicione metadados personalizados, ajuste filtros ou modifique preços.
  </Step>
</Steps>

## Comparação de Blueprints

Não tem certeza de qual blueprint atende às suas necessidades? Aqui está uma comparação rápida:

| Caso de Uso               | Blueprint      | Agregação               | Metadados Comuns                     |
| ------------------------- | -------------- | ----------------------- | ------------------------------------ |
| App de chat de IA         | LLM            | Soma (tokens)           | model, input\_tokens, output\_tokens |
| API REST                  | API Gateway    | Contagem                | endpoint, method, status\_code       |
| Armazenamento de arquivos | Object Storage | Soma (bytes)            | file\_size, file\_type, operation    |
| Plataforma de vídeo       | Stream         | Soma (largura de banda) | duration, quality, bitrate           |
| Serverless                | Time Range     | Soma (duração)          | function\_name, execution\_time\_ms  |

## Implementações Personalizadas

Não vê um blueprint para seu caso de uso exato? Sem problemas:

1. **Comece com o blueprint mais próximo**: Escolha o que mais se assemelha às suas necessidades
2. **Adapte a estrutura do evento**: Modifique os campos de metadados para corresponder às suas exigências
3. **Ajuste a configuração de medição**: Altere o tipo de agregação ou filtros conforme necessário
4. **Teste minuciosamente**: Verifique os cálculos de faturamento com o uso de amostra

<Info>
  Todos os blueprints são pontos de partida. Sinta-se à vontade para misturar conceitos de blueprints diferentes ou criar implementações totalmente personalizadas.
</Info>

## Precisa de Ajuda?

Se você não tem certeza de qual blueprint usar ou precisa de ajuda para personalizar:

<CardGroup cols={2}>
  <Card title="Complete Tutorial" icon="code" href="/developer-resources/usage-based-billing-build-ai-image-generator">
    Siga nosso tutorial de ponta a ponta construindo um gerador de imagens com IA com faturamento baseado em uso.
  </Card>

  <Card title="Integration Guide" icon="book" href="/developer-resources/usage-based-billing-guide">
    Guia completo cobrindo todos os aspectos da implementação de faturamento baseado em uso.
  </Card>
</CardGroup>