---
title: "API de LLM con cURL: chat, streaming y transcripción"
description: "Sus primeras llamadas a BroadNet Inference con curl: un chat completion, una respuesta en streaming y una transcripción, y cómo leer respuesta, uso y errores."
url: https://broadrouter.com/es/guides/curl-quickstart/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/curl-quickstart/) (actualizado el 2026-11-16).

# Primera solicitud a BroadNet Inference con curl

Actualizado 2026-11-16

Envíe un POST a https://inference.broadnet.ai/v1/chat/completions con el encabezado Authorization Bearer y su clave, y un cuerpo JSON con model, por ejemplo broadnet/gemma-4-26b-a4b, y messages. Agregue stream true para usar streaming. Para audio, envíe un formulario multipart con model, language y file a /v1/audio/transcriptions.

Esta página lo lleva de una clave nueva a tres llamadas que funcionan: un chat completion, una respuesta en streaming y una transcripción. Solo necesita curl. BroadNet Inference usa el formato de solicitud de OpenAI, así que cuando estas funcionen, también funcionará cualquier [SDK compatible con OpenAI](https://broadrouter.com/es/guides/openai-python-sdk/) o herramienta compatible.

## 1\. Configure su clave

Cree una clave en la consola de BroadNet. Las cuentas nuevas reciben un crédito inicial de $5.

```bash
export BROADNET_API_KEY='paste-your-key'
```

Envíe la clave solo en el encabezado `Authorization: Bearer`.

## 2\. Su primer chat completion

BroadNet Gemma 4 VL 26B es el único modelo de chat que funciona con el crédito inicial, así que empiece por él:

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/gemma-4-26b-a4b",
    "messages": [{"role": "user", "content": "Say hello in English and Arabic."}]
  }'
```

La respuesta es el JSON estándar de chat completions. La respuesta del modelo está en `choices[0].message.content`, y `usage` contiene los conteos de tokens que usted paga.

## 3\. Pruebe un modelo de razonamiento

Después de una recarga, cambie el modelo. GLM 5.3, Qwen3.8 27B y DeepSeek V4.1 Flash razonan antes de responder, y ese razonamiento cuenta para `max_tokens`:

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'
```

Si `content` está vacío y `finish_reason` es `length`, el presupuesto se agotó durante el razonamiento. Consulte [por qué los modelos de razonamiento devuelven respuestas vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).

## 4\. Reciba la respuesta en streaming

Agregue `"stream": true` y desactive el búfer de curl con `-N`:

```bash
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count to five."}]}'
```

Recibirá Server-Sent Events. El stream termina con la línea literal `data: [DONE]` y, con `include_usage`, el último fragmento trae los conteos de tokens. Más detalles en [streaming de chat completions](https://broadrouter.com/es/guides/streaming-chat-completions/).

## 5\. Transcriba audio

La transcripción recibe un formulario multipart. Envíe WAV o MP3 de hasta 26,214,400 bytes y envíe siempre `language`:

```bash
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3
```

La respuesta es JSON con la transcripción en `text`. Las notas de voz `.ogg` de WhatsApp y las grabaciones `.m4a` deben convertirse primero; consulte [cómo transcribir notas de voz de WhatsApp](https://broadrouter.com/es/guides/transcribe-whatsapp-voice-notes/). Para árabe, use `broadnet/cohere-transcribe-arabic` con `language=ar`; consulte la [guía de voz a texto en árabe](https://broadrouter.com/es/guides/arabic-speech-to-text-api/). El modelo multilingüe cuesta $0.002 por minuto de audio y el modelo árabe $0.0042.

## Qué modelo elegir

| Modelo | ID | Endpoint | Crédito gratuito |
| --- | --- | --- | --- |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | `/v1/chat/completions` | Sí |
| GLM 5.3 | `broadnet/glm-5.3` | `/v1/chat/completions` | No |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | `/v1/chat/completions` | No |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | `/v1/chat/completions` | No |
| BroadNet Transcribe | `broadnet/cohere-transcribe` | `/v1/audio/transcriptions` | Sí |
| BroadNet Transcribe Arabic | `broadnet/cohere-transcribe-arabic` | `/v1/audio/transcriptions` | Sí |

Los precios por token y por minuto están en la [página de precios](https://broadrouter.com/es/pricing/). Cada modelo tiene su propia página, por ejemplo [GLM 5.3](https://broadrouter.com/es/models/glm-5.3/).

## Solución de problemas

-   **401.** La clave falta, no es válida o venció, o se agotó la asignación de pago por uso. Revise que no haya espacios sobrantes alrededor de la clave.
-   **Error en el campo model.** Copie el ID de la tabla; incluye el prefijo `broadnet/`. Los modelos de pago fallan con el crédito inicial hasta que usted recargue.
-   **413.** El archivo de audio supera los 26,214,400 bytes. Divídalo.
-   **403.** La lista de IP permitidas de la clave, o la política de modelo o de ruta, rechazó la solicitud. Consulte [listas de IP permitidas para claves de API](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/).
-   **429.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 en curso. Espere con backoff y vuelva a intentar. Consulte [códigos de error de BroadNet y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).
-   **En un plan ilimitado.** Cada [sesión del plan](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/) ejecuta una solicitud a la vez, así que ejecute bucles de curl en paralelo en sesiones separadas. Las claves de plan solo funcionan con `broadnet/deepseek-v4.1-flash`.

Guarde el encabezado de respuesta `X-Request-ID` (`curl -D headers.txt ...`) cuando reporte un problema.

## Términos de esta guía

[Streaming (respuestas en tiempo real)](https://broadrouter.com/es/glossary/streaming/)

El streaming es una forma de devolver la respuesta de un modelo de lenguaje en pequeños fragmentos mientras aún se genera, en lugar de una sola respuesta al final. Las APIs compatibles con OpenAI hacen streaming mediante server-sent events cuando la solicitud define stream como true.

[Token](https://broadrouter.com/es/glossary/token/)

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[API de Chat Completions](https://broadrouter.com/es/glossary/chat-completions-api/)

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

[Crédito prepago (prepaid credit)](https://broadrouter.com/es/glossary/prepaid-credit/)

El crédito prepago es dinero que se añade a una cuenta de API antes de usarla. Cada solicitud descuenta su coste del saldo y, cuando el saldo se agota, las solicitudes medidas se detienen hasta que usted recargue. Limita el gasto a lo que ha pagado.

[Lista de IP permitidas (IP allow list)](https://broadrouter.com/es/glossary/ip-allow-list/)

Una lista de IP permitidas es un control de seguridad que solo acepta solicitudes de direcciones IP o rangos CIDR incluidos en ella y rechaza todas las demás. En una API, limita el daño de una clave filtrada, porque la clave no funciona desde redes que no estén en la lista.

## Preguntas frecuentes

### ¿Qué modelo puedo usar con el crédito inicial gratuito?

BroadNet Gemma 4 VL 26B, con el ID de modelo broadnet/gemma-4-26b-a4b, y los dos modelos de transcripción. GLM 5.3, Qwen3.8 27B y DeepSeek V4.1 Flash requieren una recarga.

### ¿Por qué el contenido del mensaje llega vacío en mi respuesta de curl?

Los modelos de razonamiento gastan primero max\_tokens en razonar. Si finish\_reason es length, suba max\_tokens a 1,000 o más.

### ¿Por qué mi transcripción en árabe sale en letras latinas?

La solicitud no incluía el campo language. Envíe language=ar para árabe y el código ISO 639-1 correspondiente para otros idiomas.

### ¿GET /v1/models muestra todos los modelos que puedo usar?

La documentación de BroadNet dice que GET /v1/models "supplies public catalogue metadata for external monitors" (Traducción: «ofrece metadatos públicos del catálogo para monitores externos»). En sus solicitudes, use los IDs de modelo de la referencia de la API o de pricing.json.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/)
-   [API de voz a texto en árabe, paso a paso](https://broadrouter.com/es/guides/arabic-speech-to-text-api/)
-   [Códigos de error de BroadNet Inference y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/)

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-curl-quickstart&utm_content=page-cta) ·

**Fuentes**

-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-curl-quickstart&utm_content=sources)
-   [Lista de modelos y precios legible por máquina (pricing.json) (en inglés)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-curl-quickstart&utm_content=sources)
