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

# Modèle de Flux

> Suivez la consommation de données de streaming pour la vidéo, l'audio, les flux en direct et la facturation du transfert de données en temps réel.

## Cas d'utilisation

Explorez les scénarios courants pris en charge par le Modèle de Flux :

<CardGroup cols={2}>
  <Card title="Video Platforms" icon="video">
    Facturez les clients en fonction de la consommation de bande passante vidéo et de la qualité de streaming.
  </Card>

  <Card title="Music Streaming" icon="music">
    Suivez l'utilisation du streaming audio par utilisateur pour les niveaux d'abonnement.
  </Card>

  <Card title="Live Events" icon="signal-stream">
    Surveillez la consommation de diffusion en direct et facturez l'utilisation de la bande passante.
  </Card>

  <Card title="Real-Time Data" icon="wave-pulse">
    Suivez le transfert de données en temps réel pour les applications IoT et télémétrie.
  </Card>
</CardGroup>

<Info>
  Parfait pour les plateformes de streaming vidéo/audio, les services de diffusion en direct et les applications de données en temps réel.
</Info>

## Démarrage Rapide

Suivez les octets de streaming consommés par vos clients :

<Steps>
  <Step title="Install the SDK">
    ```bash theme={null}
    npm install @dodopayments/ingestion-blueprints
    ```
  </Step>

  <Step title="Get Your API Keys">
    * **Clé API Dodo Payments** : Obtenez-la depuis [Dodo Payments Dashboard](https://app.dodopayments.com/developer/api-keys)
  </Step>

  <Step title="Create a Meter">
    Créez un mètre dans votre [Dodo Payments Dashboard](https://app.dodopayments.com/):

    * **Nom de l'événement** : `stream_consumption` (ou le nom de votre choix)
    * **Type d'agrégation** : `sum` pour suivre le total des octets diffusés
    * **Propriété Over** : `bytes` pour facturer en fonction de l'utilisation de la bande passante
  </Step>

  <Step title="Track Stream Usage">
    <CodeGroup>
      ```javascript Video Streaming theme={null}
      import { Ingestion, trackStreamBytes } from '@dodopayments/ingestion-blueprints';

      const ingestion = new Ingestion({
        apiKey: process.env.DODO_PAYMENTS_API_KEY,
        environment: 'test_mode',
        eventName: 'stream_consumption'
      });

      // Track video stream consumption
      await trackStreamBytes(ingestion, {
        customerId: 'customer_123',
        bytes: 10485760, // 10MB
        metadata: {
          stream_type: 'video',
        }
      });
      ```
    </CodeGroup>
  </Step>
</Steps>

## Configuration

### Configuration d'Ingestion

<ParamField path="apiKey" type="string" required>
  Votre clé API Dodo Payments depuis le tableau de bord.
</ParamField>

<ParamField path="environment" type="string" required>
  Mode d'environnement : `test_mode` ou `live_mode`.
</ParamField>

<ParamField path="eventName" type="string" required>
  Nom de l'événement correspondant à la configuration de votre mètre.
</ParamField>

### Options de Suivi des Octets de Flux

<ParamField path="customerId" type="string" required>
  L'ID client pour l'attribution de la facturation.
</ParamField>

<ParamField path="bytes" type="number">
  Nombre d'octets consommés dans le flux. Requis pour la facturation basée sur la bande passante.
</ParamField>

<ParamField path="metadata" type="object">
  Métadonnées facultatives sur le flux, comme le type de flux, la qualité, sessionId, etc.
</ParamField>

## Meilleures Pratiques

<Tip>
  **Suivi par segments** : pour les flux longs, suivez la consommation par segments plutôt que d'attendre que l'intégralité du flux soit terminée.
</Tip>

<Warning>
  **Comptage précis des octets** : assurez-vous que les décomptes d'octets incluent tous les frais généraux (entêtes, frais de protocole) si vous facturez en fonction de la bande passante totale.
</Warning>