Guía rápida para desarrolladores
Actualizado
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.
¿Cómo envío mi primera solicitud de chat?

- Inicie sesión en inference.broadnet.ai (en inglés) y cree una clave de inferencia. Se muestra una sola vez; la consola solo guarda su hash.
- Instale el SDK de OpenAI y defina la clave en su terminal. Mantenga las claves en su servidor, nunca en código del navegador.
- Envíe la solicitud. Lea la respuesta en
choices[0].message.content.
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.
- 01Tu appClave guardada en una variable de entorno
- 02SDK de OpenAICambian dos ajustes
base_urlapi_key - 03BroadNet InferenceAPI compatible con OpenAI
inference.broadnet.ai/v1POST /chat/completions - 04El modelo que indicasSe fija en cada solicitud
broadnet/deepseek-v4.1-flashbroadnet/glm-5.3broadnet/qwen3.8-27bbroadnet/gemma-4-26b-a4btu elección
- 05RespuestaDe 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.
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.wavLa respuesta es JSON con la transcripción en text. Modelo árabe o multilingüe, y cuánto cuesta el audio.
¿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).
| Modelo | ID | Endpoint | Entrada | Documentado | Acceso |
|---|---|---|---|---|---|
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash | /chat/completions | Texto + Imagen | Razonamiento | Requiere recarga |
| GLM 5.3 | broadnet/glm-5.3 | /chat/completions | Texto | Herramientas, Salida estructurada, Razonamiento | Requiere recarga |
| Qwen3.8 27B | broadnet/qwen3.8-27b | /chat/completions | Texto + Imagen | Herramientas, Salida estructurada, Razonamiento | Requiere recarga |
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b | /chat/completions | Texto + Imagen | — | Crédito inicial |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic | /audio/transcriptions | Audio en árabe | — | Crédito inicial |
| BroadNet 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.
- Endpoint. Configure la URL base como
https://inference.broadnet.ai/v1. - 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.
- ID del modelo. Use el ID exacto, por ejemplo
broadnet/gemma-4-26b-a4b. - Parámetros. Compruebe que cada parámetro que envía esté documentado para ese modelo. Quite los que no figuren.
- Streaming. Confirme que su cliente lee SSE hasta
[DONE]y maneja un stream que termina antes de tiempo. - 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.
- Razonamiento. El razonamiento puede consumir parte del presupuesto de salida. Deje margen en
max_tokens; consulte respuestas vacías de modelos de razonamiento. - 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.
- Contexto. El contexto incluye la entrada y la respuesta. Revise el límite del modelo en su página de modelo.
- Errores. Asocie los códigos de estado siguientes con una acción de reintento o corrección, y registre
X-Request-ID. - Costos. Haga una estimación con las calculadoras de precios. 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), consultada el 2026-11-15. Ejemplos de código para reintentos.
¿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.
- Integraciones (en inglés)Configuración para Aider, Cline, LangChain, n8n, LiteLLM y otras herramientas compatibles con OpenAI.
- GuíasSDKs, streaming, reintentos, listas de IP permitidas y voz en árabe.
- Guía del SDK de PythonInstalación, primera solicitud y streaming con el SDK de OpenAI para Python.
- Guía del SDK de NodeLo mismo en JavaScript y TypeScript, con IDs de solicitud.
- Guía rápida de cURLTodas las solicitudes desde la terminal.
- Claves y listas de IP permitidasLimite sus claves a sus servidores.
- Generador de solicitudes de API (en inglés)Arme una solicitud en su navegador y cópiela.
¿Necesita un endpoint privado o un modelo que no aparece en la lista? Contacte a BroadNet.
Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity