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

# Broadcast

> Envoyez les traces de l'API AIHubMix vers LangWatch avec Broadcast et configurez confidentialité, échantillonnage et filtres de clés API.

Broadcast envoie automatiquement les traces des requêtes API AIHubMix vers une plateforme externe d'observabilité configurée. Vous pouvez ainsi surveiller, déboguer et analyser l'utilisation des LLM dans LangWatch sans ajouter d'instrumentation au code de votre application.

AIHubMix prend actuellement en charge LangWatch comme destination Broadcast. Après la configuration, LangWatch affiche le modèle, les tokens, le coût réel facturé, la latence, la session et les informations de Trace.

<h2 id="prerequisites">
  Prérequis
</h2>

* Une [clé API AIHubMix](https://console.aihubmix.com/token) active
* Un compte LangWatch et le Project cible
* Un accès à la console AIHubMix

<Warning>
  Cette intégration utilise la `Project API Key` existante du Project cible, au format `sk-lw-*`. Les clés limitées à une organisation ou une équipe et l'identifiant `pkey_*` d'un Personal OTLP Endpoint ne sont pas pris en charge par cette configuration. AIHubMix utilise actuellement le point de terminaison officiel de LangWatch Cloud et ne prend pas en charge les instances auto-hébergées.
</Warning>

<h2 id="get-project-api-key">
  1. Obtenir la LangWatch Project API Key
</h2>

1. Connectez-vous à [LangWatch](https://app.langwatch.ai/) et sélectionnez le Project qui recevra les traces AIHubMix.
2. Ouvrez **Settings → API Keys**.
3. Repérez **Project API Key**, vérifiez que son Scope correspond au Project cible, puis sélectionnez le bouton de copie.

Il n'est pas nécessaire de créer une nouvelle Secret Key. AIHubMix utilise la Project API Key fournie avec le Project.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/langwatch-project-api-key.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=e4f2c0e98769f3359b7c967118b4b2c8" alt="Project API Key dans les paramètres LangWatch" width="1729" height="777" data-path="images/guides/langwatch/langwatch-project-api-key.png" />
</Frame>

<h2 id="add-destination">
  2. Ajouter une destination LangWatch
</h2>

1. Ouvrez [AIHubMix Broadcast](https://console.aihubmix.com/observability).
2. Sous **Add destination**, sélectionnez **LangWatch**.

<Frame>
  <img src="https://mintcdn.com/aihubmix/FwRluLwfe9pqf0Wh/images/guides/langwatch/aihubmix-observability-overview.png?fit=max&auto=format&n=FwRluLwfe9pqf0Wh&q=85&s=df35c0e79db7f55c71bbc088fb486176" alt="Destination LangWatch dans AIHubMix Broadcast" width="1729" height="777" data-path="images/guides/langwatch/aihubmix-observability-overview.png" />
</Frame>

3. Renseignez les paramètres.

| Paramètre                       | Description                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                        | Saisissez un nom reconnaissable, par exemple `Production tracing`.                                                                                       |
| **API Key**                     | Collez la LangWatch Project API Key. La clé est stockée sous forme chiffrée et utilisée uniquement pour la transmission.                                 |
| **Privacy**                     | Une fois activée, le texte des prompts et completions n'est pas transmis. Les tokens, le coût réel facturé, la latence et le modèle restent disponibles. |
| **Sampling rate**               | Définissez le pourcentage de trafic à transmettre. Utilisez `100%` pour la première vérification.                                                        |
| **Only forward these API keys** | Facultatif. Sélectionnez les clés API AIHubMix à transmettre. Laissez vide pour inclure toutes les clés.                                                 |

L'en-tête `x-session-id` et le champ `user` sont transmis avec l'enregistrement pour associer les sessions ou les utilisateurs dans LangWatch.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/aihubmix-add-destination.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=63f9c79da713529c9acc37e7e851198f" alt="Parametres de la destination LangWatch dans AIHubMix" width="1729" height="1007" data-path="images/guides/langwatch/aihubmix-add-destination.png" />
</Frame>

<h3 id="test-and-save">
  Tester et enregistrer
</h3>

1. Sélectionnez **Test**. Après une connexion réussie, le bouton affiche **Connected**.
2. Sélectionnez **Add destination** pour enregistrer la destination.
3. Vérifiez que la destination est active et que son état est **OK**.

Utilisez **Save changes** pour les modifications ultérieures.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/aihubmix-connection-ok.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=590bea62d4671e867598ac0a2ec81588" alt="Destination LangWatch avec le statut OK dans AIHubMix" width="1729" height="998" data-path="images/guides/langwatch/aihubmix-connection-ok.png" />
</Frame>

<h2 id="send-test-request">
  3. Envoyer une requête de vérification
</h2>

Vérifiez que `AIHUBMIX_API_KEY` est déjà défini dans le shell actuel, puis envoyez une requête de modèle normale.

```bash cURL theme={null}
curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-session-id: langwatch-tutorial" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "What is the meaning of life?"}],
    "user": "langwatch-tutorial"
  }'
```

<Note>La transmission est asynchrone. Une Trace peut prendre quelques secondes avant d'apparaître dans LangWatch.</Note>

<h2 id="verify-in-langwatch">
  4. Vérifier dans LangWatch
</h2>

1. Ouvrez **Traces** dans le Project cible.
2. Recherchez le modèle utilisé, la valeur `x-session-id` ou la valeur `user`.
3. Vérifiez la latence, le coût, les tokens et le modèle.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/langwatch-trace-result.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=f0bf5cb874edaa85ef4c414d40ef710b" alt="Appel API AIHubMix dans LangWatch Traces" width="1211" height="717" data-path="images/guides/langwatch/langwatch-trace-result.png" />
</Frame>

Avec Privacy, les colonnes de contenu comme Prompt restent vides tandis que la latence, le coût, les tokens et le modèle sont conservés.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/langwatch-privacy-columns.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=8459d00d51009145d7e74812cbfb75f2" alt="Colonnes de contenu vides dans LangWatch avec Privacy" width="1211" height="717" data-path="images/guides/langwatch/langwatch-privacy-columns.png" />
</Frame>

<h2 id="troubleshooting">
  Dépannage
</h2>

<h3 id="test-returns-401">
  Test renvoie 401
</h3>

Utilisez la **Project API Key** du Project cible. N'utilisez pas un identifiant `pkey_*` de Personal OTLP Endpoint ni une clé limitée à une organisation ou une équipe.

<h3 id="no-traces">
  La destination est enregistrée sans Trace
</h3>

Vérifiez que la destination est active avec le statut **OK**, que Sampling rate dépasse `0%` et que le filtre de clés contient la clé AIHubMix utilisée. Attendez quelques secondes, puis actualisez Traces.

<h3 id="privacy-metrics">
  Privacy supprime-t-il les métriques
</h3>

Privacy bloque uniquement le texte des prompts et completions. Les tokens, le coût réel facturé, la latence et le modèle sont toujours transmis.

***

Dernière mise à jour : 2026-08-25