BroadRouter
Comenzar

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?

  1. 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.
  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)

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. 01Tu appClave guardada en una variable de entorno
  2. 02SDK de OpenAICambian dos ajustes

    base_url api_key

  3. 03BroadNet InferenceAPI compatible con OpenAIinference.broadnet.ai/v1POST /chat/completions
  4. 04El modelo que indicasSe fija en cada solicitud
    • broadnet/deepseek-v4.1-flash
    • broadnet/glm-5.3
    • broadnet/qwen3.8-27b
    • broadnet/gemma-4-26b-a4btu elección
  5. 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.

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)

La 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).

ModeloIDEndpointEntradaDocumentadoAcceso
DeepSeek V4.1 Flashbroadnet/deepseek-v4.1-flash/chat/completionsTexto + ImagenRazonamientoRequiere recarga
GLM 5.3broadnet/glm-5.3/chat/completionsTextoHerramientas, Salida estructurada, RazonamientoRequiere recarga
Qwen3.8 27Bbroadnet/qwen3.8-27b/chat/completionsTexto + ImagenHerramientas, Salida estructurada, RazonamientoRequiere recarga
BroadNet Gemma 4 VL 26Bbroadnet/gemma-4-26b-a4b/chat/completionsTexto + Imagen—Crédito inicial
BroadNet Transcribe Arabicbroadnet/cohere-transcribe-arabic/audio/transcriptionsAudio en árabe—Crédito inicial
BroadNet Transcribebroadnet/cohere-transcribe/audio/transcriptionsAudio, 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.
  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.
  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. Las imágenes cuentan como tokens de entrada en el pago por uso.

¿Qué errores debo reintentar?

EstadoSignificadoAcción
400 / 422Solicitud o campo no válidoCorrija la solicitud; no la reintente tal cual
401Clave ausente, no válida o vencida, o asignación agotadaRevise la clave y la cuenta
402insufficient_balanceRecargue y vuelva a intentar
413Solicitud por encima del límite de bytes o de textoEnvíe menos, por ejemplo un archivo de audio más pequeño
429Límite de frecuencia, concurrencia, tokens por minuto o gastoAplique un backoff acotado y vuelva a intentar
500–504Problema del lado del servidorReintente 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?

¿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