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

> Envía trazas de la API de AIHubMix a LangWatch con Broadcast y configura privacidad, muestreo y filtros de claves API.

Broadcast envía automáticamente las trazas de las solicitudes de la API de AIHubMix a una plataforma externa de observabilidad configurada. Así puedes supervisar, depurar y analizar el uso de LLM en LangWatch sin añadir instrumentación al código de tu aplicación.

AIHubMix admite actualmente LangWatch como destino de Broadcast. Después de configurarlo, LangWatch muestra el modelo, uso de tokens, coste real facturado, latencia, sesión e información de Trace.

<h2 id="prerequisites">
  Requisitos previos
</h2>

* Una [clave API de AIHubMix](https://console.aihubmix.com/token) activa
* Una cuenta de LangWatch y el Project de destino
* Acceso a la consola de AIHubMix

<Warning>
  Esta integración usa la `Project API Key` existente del Project de destino, con formato `sk-lw-*`. Las claves con alcance de organización o equipo y la credencial `pkey_*` de Personal OTLP Endpoint no son compatibles con esta configuración. AIHubMix usa actualmente el endpoint oficial de LangWatch Cloud y no admite instancias autohospedadas.
</Warning>

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

1. Inicia sesión en [LangWatch](https://app.langwatch.ai/) y selecciona el Project que recibirá las trazas de AIHubMix.
2. Abre **Settings → API Keys**.
3. Busca **Project API Key**, confirma que Scope corresponde al Project de destino y selecciona el botón para copiar.

No necesitas crear una Secret Key nueva. AIHubMix usa la Project API Key incluida con el 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 en la configuración de LangWatch" width="1729" height="777" data-path="images/guides/langwatch/langwatch-project-api-key.png" />
</Frame>

<h2 id="add-destination">
  2. Añadir un destino de LangWatch
</h2>

1. Abre [AIHubMix Broadcast](https://console.aihubmix.com/observability).
2. En **Add destination**, selecciona **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 en AIHubMix Broadcast" width="1729" height="777" data-path="images/guides/langwatch/aihubmix-observability-overview.png" />
</Frame>

3. Completa los ajustes.

| Ajuste                          | Descripción                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Name**                        | Introduce un nombre reconocible, como `Production tracing`.                                                              |
| **API Key**                     | Pega la LangWatch Project API Key. La clave se almacena cifrada y solo se usa para la entrega.                           |
| **Privacy**                     | Al activarlo, no se envía el texto de prompt y completion. Se mantienen tokens, coste real facturado, latencia y modelo. |
| **Sampling rate**               | Define el porcentaje de tráfico que se enviará. Usa `100%` para la primera verificación.                                 |
| **Only forward these API keys** | Opcional. Selecciona claves API de AIHubMix concretas. Déjalo vacío para incluir todas las claves.                       |

El encabezado `x-session-id` y el campo `user` se envían con el registro para relacionar sesiones o usuarios en 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="Configuración del destino LangWatch en AIHubMix" width="1729" height="1007" data-path="images/guides/langwatch/aihubmix-add-destination.png" />
</Frame>

<h3 id="test-and-save">
  Probar y guardar
</h3>

1. Selecciona **Test**. Tras conectarse correctamente, el botón muestra **Connected**.
2. Selecciona **Add destination** para guardar el destino.
3. Confirma que el destino está activo y su estado es **OK**.

Usa **Save changes** para cambios 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 con estado OK en AIHubMix" width="1729" height="998" data-path="images/guides/langwatch/aihubmix-connection-ok.png" />
</Frame>

<h2 id="send-test-request">
  3. Enviar una solicitud de verificación
</h2>

Confirma que `AIHUBMIX_API_KEY` ya está definida en el shell actual y envía una solicitud normal al 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>Los registros se entregan de forma asíncrona. Una Trace puede tardar varios segundos en aparecer en LangWatch.</Note>

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

1. Abre **Traces** en el Project de destino.
2. Busca el modelo utilizado, `x-session-id` o `user`.
3. Confirma la latencia, coste, tokens e información del 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="Llamada de la API de AIHubMix en LangWatch Traces" width="1211" height="717" data-path="images/guides/langwatch/langwatch-trace-result.png" />
</Frame>

Con Privacy activado, las columnas de contenido como Prompt quedan vacías y se mantienen la latencia, coste, tokens y modelo.

<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="Columnas de contenido vacías en LangWatch con Privacy" width="1211" height="717" data-path="images/guides/langwatch/langwatch-privacy-columns.png" />
</Frame>

<h2 id="troubleshooting">
  Solución de problemas
</h2>

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

Usa la **Project API Key** del Project de destino. No uses `pkey_*` de Personal OTLP Endpoint ni claves con alcance de organización o equipo.

<h3 id="no-traces">
  El destino está guardado, pero no aparece ninguna Trace
</h3>

Confirma que el destino está activo con estado **OK**, Sampling rate es mayor que `0%` y el filtro incluye la clave API de AIHubMix utilizada. Espera unos segundos y actualiza Traces.

<h3 id="privacy-metrics">
  Privacy elimina las métricas
</h3>

Privacy solo impide enviar el texto de prompt y completion. Los tokens, el coste real facturado, la latencia y el modelo se siguen enviando.

***

Última actualización: 2026-08-25