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

> Envie traces da API AIHubMix ao LangWatch com Broadcast e configure privacidade, amostragem e filtros de chaves de API.

O Broadcast envia automaticamente os traces das solicitações da API AIHubMix para uma plataforma externa de observabilidade configurada. Assim, você pode monitorar, depurar e analisar o uso de LLM no LangWatch sem adicionar instrumentação ao código da aplicação.

Atualmente, o AIHubMix oferece suporte ao LangWatch como destino do Broadcast. Após a configuração, o LangWatch exibe modelo, uso de tokens, custo real cobrado, latência, sessão e informações de Trace.

<h2 id="prerequisites">
  Pré-requisitos
</h2>

* Uma [chave de API AIHubMix](https://console.aihubmix.com/token) ativa
* Uma conta LangWatch e o Project de destino
* Acesso ao console do AIHubMix

<Warning>
  Esta integração usa a `Project API Key` existente do Project de destino, no formato `sk-lw-*`. Chaves com escopo de organização ou equipe e a credencial `pkey_*` de Personal OTLP Endpoint não são aceitas nesta configuração. O AIHubMix usa atualmente o endpoint oficial do LangWatch Cloud e não oferece suporte a instâncias auto-hospedadas.
</Warning>

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

1. Entre no [LangWatch](https://app.langwatch.ai/) e selecione o Project que receberá os traces do AIHubMix.
2. Abra **Settings → API Keys**.
3. Localize **Project API Key**, confirme que o Scope é o Project de destino e selecione o botão de cópia.

Não é necessário criar uma nova Secret Key. O AIHubMix usa a Project API Key fornecida com o 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 nas configurações do LangWatch" width="1729" height="777" data-path="images/guides/langwatch/langwatch-project-api-key.png" />
</Frame>

<h2 id="add-destination">
  2. Adicionar um destino LangWatch
</h2>

1. Abra [AIHubMix Broadcast](https://console.aihubmix.com/observability).
2. Em **Add destination**, selecione **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="Destino LangWatch na página AIHubMix Broadcast" width="1729" height="777" data-path="images/guides/langwatch/aihubmix-observability-overview.png" />
</Frame>

3. Preencha as configurações.

| Configuração                    | Descrição                                                                                                                             |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                        | Informe um nome reconhecível, como `Production tracing`.                                                                              |
| **API Key**                     | Cole a LangWatch Project API Key. A chave é armazenada de forma criptografada e usada apenas para entrega.                            |
| **Privacy**                     | Quando ativado, o texto de prompt e completion não é enviado. Tokens, custo real cobrado, latência e modelo continuam sendo enviados. |
| **Sampling rate**               | Defina o percentual de tráfego encaminhado. Use `100%` na primeira verificação.                                                       |
| **Only forward these API keys** | Opcional. Selecione chaves de API AIHubMix específicas. Deixe vazio para incluir todas as chaves.                                     |

O cabeçalho `x-session-id` e o campo `user` são transmitidos com o registro para relacionar sessões ou usuários no 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="Configurações do destino LangWatch no AIHubMix" width="1729" height="1007" data-path="images/guides/langwatch/aihubmix-add-destination.png" />
</Frame>

<h3 id="test-and-save">
  Testar e salvar
</h3>

1. Selecione **Test**. Após a conexão, o botão exibe **Connected**.
2. Selecione **Add destination** para salvar o destino.
3. Confirme que o destino está ativado e com status **OK**.

Use **Save changes** para alterações posteriores.

<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="Destino LangWatch com status OK no AIHubMix" width="1729" height="998" data-path="images/guides/langwatch/aihubmix-connection-ok.png" />
</Frame>

<h2 id="send-test-request">
  3. Enviar uma solicitação de verificação
</h2>

Confirme que `AIHUBMIX_API_KEY` já esteja definida no shell atual e envie uma solicitação normal ao modelo.

```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>Os registros são entregues de forma assíncrona. Uma Trace pode levar alguns segundos para aparecer no LangWatch.</Note>

<h2 id="verify-in-langwatch">
  4. Verificar no LangWatch
</h2>

1. Abra **Traces** no Project de destino.
2. Procure o modelo usado, `x-session-id` ou `user`.
3. Confirme latência, custo, tokens e informações do modelo.

<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="Chamada da API AIHubMix no LangWatch Traces" width="1211" height="717" data-path="images/guides/langwatch/langwatch-trace-result.png" />
</Frame>

Com Privacy ativado, colunas de conteúdo como Prompt ficam vazias, enquanto latência, custo, tokens e modelo permanecem disponíveis.

<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="Colunas de conteúdo vazias no LangWatch com Privacy" width="1211" height="717" data-path="images/guides/langwatch/langwatch-privacy-columns.png" />
</Frame>

<h2 id="troubleshooting">
  Solução de problemas
</h2>

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

Use a **Project API Key** do Project de destino. Não use `pkey_*` de Personal OTLP Endpoint nem chaves com escopo de organização ou equipe.

<h3 id="no-traces">
  O destino foi salvo, mas nenhuma Trace aparece
</h3>

Confirme que o destino está ativado com status **OK**, Sampling rate é maior que `0%` e o filtro inclui a chave de API AIHubMix usada. Aguarde alguns segundos e atualize Traces.

<h3 id="privacy-metrics">
  Privacy remove as métricas
</h3>

Privacy impede apenas o envio do texto de prompt e completion. Tokens, custo real cobrado, latência e modelo continuam sendo enviados.

***

Última atualização: 2026-08-25