> ## 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.

# Planos de Ingesta

> Patrones de ingesta de eventos listos para usar para casos de uso comunes con código de ejemplo.

Los planos de ingesta son patrones preconstruidos para rastrear el uso en escenarios comunes. En lugar de averiguar las estructuras de eventos y las configuraciones de medidores desde cero, comienza con un plano probado y personalízalo según tus necesidades.

## ¿Qué son los Planos?

Cada plano incluye:

* **Recomendaciones de estructura de eventos**: Nombres de eventos óptimos y diseño de metadatos
* **Configuración del medidor**: Tipos de agregación y filtros sugeridos
* **Código de ejemplo**: Ejemplos de implementación funcional en múltiples lenguajes
* **Mejores prácticas**: Consejos para precisión, rendimiento y optimización de costos

<Tip>
  Los planos ahorran horas de configuración y te ayudan a evitar errores comunes. Empieza con un plano y luego adáptalo a tus requisitos específicos.
</Tip>

## ¿Por qué usar Planos?

<CardGroup cols={3}>
  <Card title="Faster Setup" icon="rocket">
    Haz que el seguimiento de uso funcione en minutos en lugar de horas. Copia patrones probados en lugar de diseñar desde cero.
  </Card>

  <Card title="Best Practices Built In" icon="shield-check">
    Evita errores comunes con estructuras de eventos probadas, metadatos apropiados y opciones de agregación óptimas.
  </Card>

  <Card title="Production Ready" icon="code">
    El código de ejemplo se basa en implementaciones del mundo real. Solo agrega tus claves de API y listo.
  </Card>
</CardGroup>

## Planos Disponibles

Elige el plano que coincida con tu caso de uso:

<CardGroup cols={1}>
  <Card title="LLM Blueprint" icon="brain-circuit" href="/developer-resources/ingestion-blueprints/llm">
    Realiza el seguimiento del uso de tokens de IA para OpenAI, Anthropic, Groq, Gemini, Vercel AI SDK y más.

    **Perfecto para**: Chatbots de IA, generadores de código, herramientas de creación de contenido, aplicaciones impulsadas por IA.

    **Lo que registrarás**: tokens de entrada, tokens de salida, uso del modelo, recuentos de solicitudes.
  </Card>

  <Card title="API Gateway Blueprint" icon="cloud" href="/developer-resources/ingestion-blueprints/api-gateway">
    Mide las solicitudes de API a nivel de gateway con filtrado de endpoints y soporte de limitación de tasa.

    **Perfecto para**: APIs REST, servicios GraphQL, proveedores de webhook, plataformas API-first.

    **Lo que registrarás**: recuentos de solicitudes, uso de endpoints, métodos HTTP, tiempos de respuesta.
  </Card>

  <Card title="Object Storage Blueprint" icon="box-archive" href="/developer-resources/ingestion-blueprints/object-storage">
    Realiza un seguimiento de cargas de archivos, consumo de almacenamiento y ancho de banda para servicios de almacenamiento en la nube.

    **Perfecto para**: Alojamiento de archivos, plataformas de medios, servicios de respaldo, gestión de documentos.

    **Lo que registrarás**: bytes almacenados, cargas de archivos, descargas, instantáneas de almacenamiento.
  </Card>

  <Card title="Stream Blueprint" icon="tower-broadcast" href="/developer-resources/ingestion-blueprints/stream">
    Mide el ancho de banda de streaming para video, audio y entrega de datos en tiempo real.

    **Perfecto para**: Transmisión de video, plataformas de audio, transmisiones en vivo, flujos de datos en tiempo real.

    **Lo que registrarás**: ancho de banda consumido, duración de la transmisión, niveles de calidad, transmisiones concurrentes.
  </Card>

  <Card title="Time Range Blueprint" icon="clock" href="/developer-resources/ingestion-blueprints/time-range">
    Factura por tiempo transcurrido para recursos de cómputo, funciones serverless y trabajos de larga duración.

    **Perfecto para**: Plataformas sin servidor, alojamiento de contenedores, instancias de computación, procesamiento por lotes.

    **Lo que registrarás**: tiempo de ejecución, horas de cómputo, invocaciones de funciones, duración del trabajo.
  </Card>
</CardGroup>

## Cómo Usar un Plano

<Steps>
  <Step title="Choose your blueprint">
    Selecciona el plano que mejor se adapte a tu escenario de facturación. Cada página del plano incluye guías de implementación detalladas.
  </Step>

  <Step title="Review the event structure">
    Comprende el nombre de eventos recomendado y el diseño de metadatos. Copia la estructura de eventos para tu caso de uso.
  </Step>

  <Step title="Create the meter">
    Sigue las instrucciones de configuración del medidor del plano. Usa el tipo de agregación y los filtros sugeridos.
  </Step>

  <Step title="Implement event sending">
    Copia el código de ejemplo para tu lenguaje/marco. Reemplaza los valores de marcador con tus claves de API reales e IDs de cliente.
  </Step>

  <Step title="Test and verify">
    Envía eventos de prueba y verifica que aparezcan en tu panel de medidor con la agregación correcta.
  </Step>

  <Step title="Customize as needed">
    Adapta el plano a tus requisitos específicos: añade metadatos personalizados, ajusta filtros o modifica precios.
  </Step>
</Steps>

## Comparación de Planos

¿No estás seguro de qué plano se ajusta a tus necesidades? Aquí tienes una comparación rápida:

| Caso de Uso                | Plano          | Agregación            | Metadatos Comunes                     |
| -------------------------- | -------------- | --------------------- | ------------------------------------- |
| App de chat de IA          | LLM            | Suma (tokens)         | modelo, input\_tokens, output\_tokens |
| API REST                   | API Gateway    | Conteo                | endpoint, method, status\_code        |
| Almacenamiento de archivos | Object Storage | Suma (bytes)          | file\_size, file\_type, operation     |
| Plataforma de video        | Stream         | Suma (ancho de banda) | duration, quality, bitrate            |
| Sin servidor               | Time Range     | Suma (duración)       | function\_name, execution\_time\_ms   |

## Implementaciones Personalizadas

¿No ves un plano para tu caso de uso exacto? No hay problema:

1. **Comienza con el plano más cercano**: Elige el que sea más similar a tus necesidades
2. **Adapta la estructura del evento**: Modifica los campos de metadatos para que coincidan con tus requisitos
3. **Ajusta la configuración del medidor**: Cambia el tipo de agregación o los filtros según sea necesario
4. **Prueba a fondo**: Verifica los cálculos de facturación con el uso de muestra

<Info>
  Todos los planos son puntos de partida. Siéntete libre de mezclar conceptos de diferentes planos o crear implementaciones completamente personalizadas.
</Info>

## ¿Necesitas Ayuda?

Si no estás seguro de qué plano usar o necesitas ayuda para personalizar:

<CardGroup cols={2}>
  <Card title="Complete Tutorial" icon="code" href="/developer-resources/usage-based-billing-build-ai-image-generator">
    Sigue nuestro tutorial de extremo a extremo para construir un generador de imágenes IA con facturación por uso.
  </Card>

  <Card title="Integration Guide" icon="book" href="/developer-resources/usage-based-billing-guide">
    Guía completa que cubre todos los aspectos de la implementación de facturación basada en uso.
  </Card>
</CardGroup>
