BroadRouter
Comenzar

Primera solicitud a BroadNet Inference con curl

Actualizado

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

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:

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:

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.

4. Reciba la respuesta en streaming

Agregue "stream": true y desactive el búfer de curl con -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 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.

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:

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. Para árabe, use broadnet/cohere-transcribe-arabic con language=ar; consulte la guía de voz a texto en árabe. 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. Cada modelo tiene su propia página, por ejemplo 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.
  • 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.
  • En un plan ilimitado. Cada sesión del plan 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.

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.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity