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.
