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

> Broadcast で AIHubMix API リクエストの Trace を LangWatch に送信し、プライバシーモード、サンプリング率、API Key フィルターを設定します。

Broadcast は AIHubMix API リクエストの Trace を設定済みの外部オブザーバビリティプラットフォームへ自動送信します。アプリケーションコードに追加の計装を実装せずに、LangWatch で LLM の利用状況を監視、デバッグ、分析できます。

AIHubMix は現在、Broadcast の送信先として LangWatch をサポートしています。設定後、モデル、token 使用量、実際の請求コスト、レイテンシ、セッション、Trace 情報を LangWatch で確認できます。

<h2 id="prerequisites">
  前提条件
</h2>

* 有効な [AIHubMix API Key](https://console.aihubmix.com/token)
* LangWatch アカウントと対象 Project
* AIHubMix コンソールへのアクセス権

<Warning>
  この連携には対象 Project の既存の `Project API Key` が必要です。形式は `sk-lw-*` です。組織またはチーム範囲のキーと、Personal OTLP Endpoint の `pkey_*` はこの設定では使用できません。AIHubMix は現在 LangWatch 公式クラウドの接続先を使用し、セルフホスト環境には対応していません。
</Warning>

<h2 id="get-project-api-key">
  1. LangWatch Project API Key を取得する
</h2>

1. [LangWatch](https://app.langwatch.ai/) にログインし、AIHubMix の Trace を受信する Project を選択します。
2. **Settings → API Keys** を開きます。
3. **Project API Key** を見つけ、Scope が対象 Project であることを確認してコピーボタンを選択します。

新しい Secret Key を作成する必要はありません。AIHubMix は Project に用意されている Project API Key を使用します。

<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="LangWatch Settings の Project API Key" width="1729" height="777" data-path="images/guides/langwatch/langwatch-project-api-key.png" />
</Frame>

<h2 id="add-destination">
  2. LangWatch の送信先を追加する
</h2>

1. [AIHubMix Broadcast](https://console.aihubmix.com/observability) を開きます。
2. **Add destination** で **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="AIHubMix Broadcast の LangWatch 送信先" width="1729" height="777" data-path="images/guides/langwatch/aihubmix-observability-overview.png" />
</Frame>

3. 各項目を設定します。

| 設定                              | 説明                                                                            |
| ------------------------------- | ----------------------------------------------------------------------------- |
| **Name**                        | `Production tracing` など、識別しやすい名前を入力します。                                       |
| **API Key**                     | 前の手順でコピーした LangWatch Project API Key を貼り付けます。キーは暗号化して保存され、配信のみに使用されます。        |
| **Privacy**                     | 有効にすると prompt と completion の本文は送信されません。token 使用量、実際の請求コスト、レイテンシ、モデル情報は送信されます。 |
| **Sampling rate**               | 転送するトラフィックの割合を設定します。初回確認では `100%` を使用します。                                     |
| **Only forward these API keys** | 任意です。転送対象の AIHubMix API Key を指定します。未選択の場合はすべての Key の記録を転送します。                 |

`x-session-id` リクエストヘッダーと `user` フィールドも渡され、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="AIHubMix の LangWatch 送信先設定" width="1729" height="1007" data-path="images/guides/langwatch/aihubmix-add-destination.png" />
</Frame>

<h3 id="test-and-save">
  テストして保存する
</h3>

1. **Test** を選択します。接続に成功すると **Connected** と表示されます。
2. **Add destination** を選択して新しい送信先を保存します。
3. 送信先が有効で、状態が **OK** であることを確認します。

以降の変更は **Save changes** で保存します。

<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="AIHubMix で状態が OK の LangWatch 送信先" width="1729" height="998" data-path="images/guides/langwatch/aihubmix-connection-ok.png" />
</Frame>

<h2 id="send-test-request">
  3. 確認リクエストを送信する
</h2>

現在のシェルで `AIHUBMIX_API_KEY` が設定済みであることを確認してから、通常のモデルリクエストを送信します。

```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>記録は非同期で配信されます。リクエスト完了後、Trace の表示まで数秒かかる場合があります。</Note>

<h2 id="verify-in-langwatch">
  4. LangWatch で確認する
</h2>

1. 対象 Project の **Traces** を開きます。
2. 使用したモデル、`x-session-id`、または `user` の値で記録を探します。
3. レイテンシ、コスト、token、モデル情報が含まれていることを確認します。

<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="LangWatch Traces の AIHubMix API 呼び出し" width="1211" height="717" data-path="images/guides/langwatch/langwatch-trace-result.png" />
</Frame>

Privacy が有効な場合、Prompt などの本文列は空のままですが、レイテンシ、コスト、token、モデル情報は表示されます。

<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="Privacy 有効時の LangWatch の空の本文列" width="1211" height="717" data-path="images/guides/langwatch/langwatch-privacy-columns.png" />
</Frame>

<h2 id="troubleshooting">
  トラブルシューティング
</h2>

<h3 id="test-returns-401">
  Test が 401 を返す
</h3>

対象 Project の **Project API Key** を使用していることを確認します。Personal OTLP Endpoint の `pkey_*` や、組織またはチーム範囲のキーは使用しません。

<h3 id="no-traces">
  保存後も Trace が表示されない
</h3>

送信先が有効で状態が **OK** であること、Sampling rate が `0%` より大きいこと、API Key フィルターがリクエストに使用した Key を含むことを確認します。数秒待ってから Traces を更新します。

<h3 id="privacy-metrics">
  Privacy はメトリクスに影響するか
</h3>

Privacy は prompt と completion の本文送信を停止します。token 使用量、実際の請求コスト、レイテンシ、モデル情報は引き続き送信されます。

***

最終更新：2026-08-25