---
title: "SDK de OpenAI para Python con base_url propia (BroadNet)"
description: "Apunte el SDK oficial de OpenAI para Python a BroadNet Inference cambiando solo base_url: instalación, clave, primera solicitud y respuesta en streaming."
url: https://broadrouter.com/es/guides/openai-python-sdk/
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/openai-python-sdk/) (actualizado el 2026-11-16).

# Usar el SDK de OpenAI para Python con BroadNet Inference

Actualizado 2026-11-16

Instale el paquete openai y cree el cliente con base\_url en https://inference.broadnet.ai/v1 y su clave de BroadNet como api\_key. Todas las llamadas a chat.completions funcionan sin cambios; solo cambia el ID del modelo, por ejemplo broadnet/deepseek-v4.1-flash. BroadNet ofrece chat completions y transcripciones, no la Responses API.

Necesita una cuenta de BroadNet Inference y una clave de inferencia. Las cuentas nuevas empiezan con $5 de crédito y sin tarjeta; [cree una en inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-python-sdk&utm_content=body). La consola muestra la clave una sola vez y solo guarda su hash, así que cópiela directamente a su entorno.

## 1\. Instale el paquete y configure la clave

El paquete `openai` actual (3.x) requiere Python 3.10 o posterior.

```bash
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. Haga una primera solicitud

Guarde esto como `first_request.py`:

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

Ejecútelo con `python first_request.py`. Este ejemplo usa `broadnet/gemma-4-26b-a4b` porque funciona con el crédito gratuito. Los demás modelos de chat están disponibles después de una recarga.

## 3\. Cambie al modelo que necesita

Cambie solo `model`:

| Usted necesita | ID del modelo |
| --- | --- |
| Uso ilimitado con un plan de tarifa plana, contexto de 1M | `broadnet/deepseek-v4.1-flash` |
| Herramientas y salida estructurada, contexto de 1M | `broadnet/glm-5.3` |
| Texto en árabe e imágenes | `broadnet/qwen3.8-27b` |
| Precio bajo, funciona con el crédito gratuito | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B razonan antes de responder, y el razonamiento cuenta para `max_tokens`. Asígneles 1,000 tokens o más. [Aquí se explica por qué un límite bajo devuelve una respuesta vacía](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).

## 4\. Reciba la respuesta en streaming

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Count from one to three."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

Con `include_usage`, los conteos de tokens llegan en el último fragmento, que no tiene `choices`. [La guía de streaming](https://broadrouter.com/es/guides/streaming-chat-completions/) explica qué hacer con las conexiones interrumpidas.

## 5\. Conserve el ID de la solicitud

Cada respuesta incluye el encabezado `X-Request-ID`. Regístrelo: el soporte de BroadNet lo solicita. Las respuestas ya procesadas lo exponen como `response._request_id`. Para leerlo junto con otros encabezados:

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

Las claves de pago por uso permiten 30 solicitudes por minuto y 4 en curso. [Qué significa cada código de error y cuándo reintentar](https://broadrouter.com/es/guides/errors-and-retries/).

## Solución de problemas

-   **`AuthenticationError` (401).** La clave es incorrecta, venció o se agotó la asignación de pago por uso. Verifique que `BROADNET_API_KEY` esté definida en el proceso que ejecuta su código.
-   **`NotFoundError` (404).** Verifique que `base_url` termine en `/v1` y que llame a `chat.completions`, no a `responses`. Luego revise el ID del modelo, con el prefijo `broadnet/`.
-   **Un modelo de pago falla en una cuenta nueva.** El crédito inicial de $5 cubre BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) y los dos modelos BroadNet Transcribe. Recargue para usar los demás modelos de chat: DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B.
-   **`content` vacío.** El razonamiento cuenta para `max_tokens`. Súbalo a 1,000 o más. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Superó el límite por minuto o el de concurrencia. El SDK reintenta dos veces de forma predeterminada; configure `max_retries` en el cliente para cambiarlo.
-   **Errores de un cliente HTTP personalizado después de actualizar.** El SDK 3.x usa HTTPX2. Si pasa su propio `http_client`, siga la guía de migración a HTTPX2 del SDK.

## Términos de esta guía

[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.

[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.

[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.

[Clave de API (API key)](https://broadrouter.com/es/glossary/api-key/)

Una clave de API es una cadena secreta que identifica y autoriza a un cliente que llama a una API. Las APIs de LLM suelen esperarla en un encabezado Authorization: Bearer, y cualquiera que tenga la clave puede hacer solicitudes que se facturan a la cuenta propietaria.

[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.

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

## Preguntas frecuentes

### ¿Necesito otro SDK?

No. BroadNet Inference usa los formatos de OpenAI para chat completions y transcripciones de audio, así que el paquete oficial openai funciona con otra base\_url.

### ¿Puedo seguir usando OPENAI\_API\_KEY?

Puede, pero una variable separada BROADNET\_API\_KEY evita enviar por error la clave de un proveedor a otro.

### ¿El SDK lee OPENAI\_BASE\_URL?

Sí. Si no pasa base\_url, el cliente usa OPENAI\_BASE\_URL. Configúrela en https://inference.broadnet.ai/v1, ponga su clave de BroadNet en OPENAI\_API\_KEY y OpenAI() no necesitará argumentos.

### ¿Puedo usar client.responses.create con BroadNet?

No. El README del SDK empieza con la Responses API, pero la documentación de BroadNet solo incluye chat completions y transcripciones de audio. Use client.chat.completions.create.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Node.js con BroadNet Inference](https://broadrouter.com/es/guides/openai-node-sdk/)
-   [Streaming de chat completions y conexiones interrumpidas](https://broadrouter.com/es/guides/streaming-chat-completions/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [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-openai-python-sdk&utm_content=page-cta) ·

**Fuentes**

-   [Referencia de la API de BroadNet Inference, primera solicitud (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-python-sdk&utm_content=sources#base-url)
-   [Biblioteca de OpenAI para Python en PyPI (3.x, Python 3.10+, consultado el 2026-11-14)](https://pypi.org/project/openai/)
