> ## 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 当前支持将 LangWatch 配置为 Broadcast 目的地。配置完成后，可以在 LangWatch 中查看模型、token 用量、实际计费成本、耗时、会话和 Trace 信息。

<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 可观测性](https://console.aihubmix.com/observability)。
2. 在 **Add destination** 下点击 **LangWatch**。

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/aihubmix-observability-overview.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=8150e15a6329bf9a7c917b909cdf313b" alt="AIHubMix Observability 页面中的 LangWatch 目的地" width="1729" height="833" 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>

确认当前 shell 已设置 `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 可能需要数秒才会出现在 LangWatch。
</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 调用记录" 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%`
* 如果设置了 **Only forward these API keys**，请求是否使用了已选择的 AIHubMix API Key
* 请求完成后是否等待数秒并刷新 LangWatch Traces 页面

<h3 id="privacy-metrics">
  Privacy 是否影响统计数据
</h3>

Privacy 只停止发送 prompt 和 completion 内容。token 用量、实际计费成本、耗时和模型信息仍会发送。

***

更新时间：2026-08-25