---
title: "API compatible con OpenAI: guía rápida con Python y cURL"
description: "Use la API compatible con OpenAI de BroadNet Inference: envíe su primera solicitud de chat y de transcripción con Python o cURL y revise la lista de migración."
url: https://broadrouter.com/es/developers/
lang: es
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Guía rápida para desarrolladores

Actualizado 2026-11-15

BroadNet Inference usa los formatos de solicitud de OpenAI en `https://inference.broadnet.ai/v1`. Cree una clave en la consola, guárdela en una variable de entorno y envíe una solicitud a `/chat/completions` o `/audio/transcriptions` con un ID de modelo exacto. Antes de mover tráfico de producción, revise los parámetros, el streaming, las herramientas, los límites y los errores de ese modelo.

-   Guía rápida de chat
-   Guía rápida de transcripción
-   IDs de modelo
-   Lista de verificación para migrar
-   Errores y reintentos
-   Documentación y guías

## ¿Cómo envío mi primera solicitud de chat?

1.  Inicie sesión en [inference.broadnet.ai (en inglés)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=quickstart-account) y cree una clave de inferencia. Se muestra una sola vez; la consola solo guarda su hash.
2.  Instale el SDK de OpenAI y defina la clave en su terminal. Mantenga las claves en su servidor, nunca en código del navegador.
3.  Envíe la solicitud. Lea la respuesta en `choices[0].message.content`.

setup

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

first\_request.py

```
import os
from openai import OpenAI

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)
```

request.sh

```
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":"Reply with one short sentence."}]}'
```

El ejemplo usa BroadNet Gemma 4 VL 26B, que el crédito inicial de USD 5 cubre. DeepSeek V4.1 Flash, GLM 5.3 y Qwen3.8 27B requieren una recarga previa. Guarde el encabezado de respuesta `X-Request-ID` para soporte.

Cómo llega una solicitud a un modelo

1.  01**Tu app**Clave guardada en una variable de entorno
    
2.  02**SDK de OpenAI**Cambian dos ajustes
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**API compatible con OpenAI`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**El modelo que indicas**Se fija en cada solicitud
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`tu elección
    
5.  05**Respuesta**De ese modelo
    

Eliges el modelo en cada solicitud. No hay enrutamiento automático: la solicitud se ejecuta en el ID de modelo que enviaste.

Tu app llama al SDK de OpenAI con la URL base de BroadNet y tu clave. La solicitud va a BroadNet Inference con el ID de modelo que escribiste, y responde ese modelo. Nada elige ni cambia el modelo por ti.

### Streaming

Configure `stream=true` y lea los Server-Sent Events hasta `data: [DONE]`. Con `stream_options.include_usage`, el uso de tokens llega en el último fragmento. Si el stream termina antes de `[DONE]`, considere la respuesta incompleta. BroadNet pide verificar el streaming en cada modelo antes de depender de él en producción.

stream.sh

```
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 from one to three."}]}'
```

## ¿Cómo transcribo audio?

Envíe WAV o MP3, de hasta 26,214,400 bytes por archivo, a `/audio/transcriptions`. Defina siempre `language`: sin él, el árabe puede volver en letras latinas. Use `language=ar` para árabe. Convierta primero los archivos `.ogg` o `.m4a`: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

La respuesta es JSON con la transcripción en `text`. [Modelo árabe o multilingüe, y cuánto cuesta el audio](https://broadrouter.com/es/arabic-transcription/).

## ¿Qué IDs de modelo puedo usar?

Pase el ID exacto en `model`. No dependa de `/v1/models` para descubrir los modelos de chat; use esta lista o la [referencia (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=models-docs#models).

| Modelo | ID | Endpoint | Entrada | Documentado | Acceso |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/es/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Texto + Imagen | Razonamiento | Requiere recarga |
| [GLM 5.3](https://broadrouter.com/es/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Texto | Herramientas, Salida estructurada, Razonamiento | Requiere recarga |
| [Qwen3.8 27B](https://broadrouter.com/es/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Texto + Imagen | Herramientas, Salida estructurada, Razonamiento | Requiere recarga |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/es/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Texto + Imagen | — | Crédito inicial |
| [BroadNet Transcribe Arabic](https://broadrouter.com/es/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Audio en árabe | — | Crédito inicial |
| [BroadNet Transcribe](https://broadrouter.com/es/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Audio, 14 idiomas | — | Crédito inicial |

«Documentado» indica las herramientas, la salida estructurada y el razonamiento que la referencia de BroadNet menciona para cada modelo (consultada el 2026-11-15). Un guion significa que la referencia no los menciona; no significa que no existan.

## Migrar desde otra API compatible con OpenAI: lista de verificación

Los formatos de solicitud le resultarán familiares, pero los modelos son distintos. Revise cada punto para el modelo que eligió y haga pruebas antes de cambiar el tráfico.

1.  **Endpoint.** Configure la URL base como `https://inference.broadnet.ai/v1`.
2.  **Clave.** Use una clave de inferencia de BroadNet desde una variable de entorno. Las claves de plan y las de pago por uso son independientes.
3.  **ID del modelo.** Use el ID exacto, por ejemplo `broadnet/gemma-4-26b-a4b`.
4.  **Parámetros.** Compruebe que cada parámetro que envía esté documentado para ese modelo. Quite los que no figuren.
5.  **Streaming.** Confirme que su cliente lee SSE hasta `[DONE]` y maneja un stream que termina antes de tiempo.
6.  **Herramientas y salida estructurada.** La referencia las documenta para GLM 5.3 y Qwen3.8 27B. Pruebe cualquier otro modelo antes de depender de ellas.
7.  **Razonamiento.** El razonamiento puede consumir parte del presupuesto de salida. Deje margen en `max_tokens`; consulte [respuestas vacías de modelos de razonamiento](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
8.  **Límites.** Una clave de pago por uso permite 30 solicitudes por minuto y 4 simultáneas. Una sesión de plan permite una solicitud a la vez. Una clave por hora de Gemma permite un stream, 120 solicitudes por minuto y 300,000 tokens por minuto.
9.  **Contexto.** El contexto incluye la entrada y la respuesta. Revise el límite del modelo en su [página de modelo](https://broadrouter.com/es/models/).
10.  **Errores.** Asocie los códigos de estado siguientes con una acción de reintento o corrección, y registre `X-Request-ID`.
11.  **Costos.** Haga una estimación con las [calculadoras de precios](https://broadrouter.com/es/pricing/). Las imágenes cuentan como tokens de entrada en el pago por uso.

## ¿Qué errores debo reintentar?

| Estado | Significado | Acción |
| --- | --- | --- |
| 400 / 422 | Solicitud o campo no válido | Corrija la solicitud; no la reintente tal cual |
| 401 | Clave ausente, no válida o vencida, o asignación agotada | Revise la clave y la cuenta |
| 402 | `insufficient_balance` | Recargue y vuelva a intentar |
| 413 | Solicitud por encima del límite de bytes o de texto | Envíe menos, por ejemplo un archivo de audio más pequeño |
| 429 | Límite de frecuencia, concurrencia, tokens por minuto o gasto | Aplique un backoff acotado y vuelva a intentar |
| 500–504 | Problema del lado del servidor | Reintente con backoff exponencial acotado |

Resumido de la [tabla de errores de la referencia (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=errors-docs#errors), consultada el 2026-11-15. [Ejemplos de código para reintentos](https://broadrouter.com/es/guides/errors-and-retries/).

## ¿Dónde están la documentación completa y las guías?

-   [**Referencia para desarrolladores (en inglés)**Formatos de solicitud, límites, errores y el feed de precios. La fuente oficial.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=docs)
-   [**Integraciones (en inglés)**Configuración para Aider, Cline, LangChain, n8n, LiteLLM y otras herramientas compatibles con OpenAI.](https://broadrouter.com/integrations/)
-   [**Guías**SDKs, streaming, reintentos, listas de IP permitidas y voz en árabe.](https://broadrouter.com/es/guides/)
-   [**Guía del SDK de Python**Instalación, primera solicitud y streaming con el SDK de OpenAI para Python.](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [**Guía del SDK de Node**Lo mismo en JavaScript y TypeScript, con IDs de solicitud.](https://broadrouter.com/es/guides/openai-node-sdk/)
-   [**Guía rápida de cURL**Todas las solicitudes desde la terminal.](https://broadrouter.com/es/guides/curl-quickstart/)
-   [**Claves y listas de IP permitidas**Limite sus claves a sus servidores.](https://broadrouter.com/es/guides/api-keys-ip-allow-lists/)
-   [**Generador de solicitudes de API (en inglés)**Arme una solicitud en su navegador y cópiela.](https://broadrouter.com/tools/api-request-builder/)

¿Necesita un endpoint privado o un modelo que no aparece en la lista? [Contacte a BroadNet](https://broadrouter.com/es/contact/#private).

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-developers&utm_content=page-cta) ·

**Fuentes**

-   [Referencia para desarrolladores de BroadNet Inference (consultada el 2026-11-15) (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=sources)
-   [Precios de BroadNet Inference](https://inference.broadnet.ai/es/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=sources)
-   [pricing.json, la tarifa publicada (en inglés)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-developers&utm_content=sources)
