Esta página leva você de uma chave recém-criada a três chamadas funcionando: um chat completion, uma resposta em streaming e uma transcrição. Só precisa do curl. A BroadNet Inference usa o formato de requisição da OpenAI, então, quando estas funcionarem, qualquer SDK compatível com a OpenAI ou ferramenta também vai funcionar.
1. Defina sua chave
Crie uma chave no console da BroadNet. Contas novas recebem um crédito inicial de $5.
export BROADNET_API_KEY='paste-your-key'
Envie a chave apenas no cabeçalho Authorization: Bearer.
2. Seu primeiro chat completion
O BroadNet Gemma 4 VL 26B é o único modelo de chat que roda com o crédito inicial, então comece por ele:
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."}]
}'
A resposta é o JSON padrão de chat completions. O texto gerado fica em choices[0].message.content, e usage traz as contagens de tokens que você paga.
3. Teste um modelo de raciocínio
Depois de uma recarga, troque o modelo. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash raciocinam antes de responder, e esse raciocínio conta 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."}]
}'
Se content vier vazio e finish_reason for length, o orçamento acabou durante o raciocínio. Veja por que modelos de raciocínio retornam respostas vazias.
4. Receba a resposta em streaming
Adicione "stream": true e desligue o buffer do curl com -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."}]}'
Você recebe Server-Sent Events. O stream termina com a linha literal data: [DONE], e com include_usage o último chunk traz as contagens de tokens. Mais detalhes em streaming de chat completions.
5. Transcreva um áudio
A transcrição recebe um formulário multipart. Envie WAV ou MP3, com até 26.214.400 bytes, e sempre envie 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
A resposta é um JSON com a transcrição em text. Áudios de WhatsApp em .ogg e gravações .m4a precisam ser convertidos antes; veja como transcrever áudios do WhatsApp. Para árabe, use broadnet/cohere-transcribe-arabic com language=ar; veja o guia de fala para texto em árabe. O modelo multilíngue custa $0.002 por minuto de áudio e o modelo de árabe, $0.0042.
Qual modelo escolher
| Modelo | ID | Endpoint | Crédito gratuito |
|---|---|---|---|
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b |
/v1/chat/completions |
Sim |
| GLM 5.3 | broadnet/glm-5.3 |
/v1/chat/completions |
Não |
| Qwen3.8 27B | broadnet/qwen3.8-27b |
/v1/chat/completions |
Não |
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash |
/v1/chat/completions |
Não |
| BroadNet Transcribe | broadnet/cohere-transcribe |
/v1/audio/transcriptions |
Sim |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic |
/v1/audio/transcriptions |
Sim |
Os preços por token e por minuto estão na página de preços. Cada modelo tem sua própria página, por exemplo GLM 5.3.
Solução de problemas
- 401. A chave está ausente, é inválida ou expirou, ou a cota de pagamento por uso acabou. Confira se não sobraram espaços em volta da chave.
- Erro no campo model. Copie o ID da tabela; ele inclui o prefixo
broadnet/. Modelos pagos falham com o crédito inicial até você fazer uma recarga. - 413. O arquivo de áudio passa de 26.214.400 bytes. Divida o arquivo.
- 403. A lista de IPs permitidos da chave, o modelo ou a política de rota recusou a requisição. Veja listas de IPs permitidos para chaves de API.
- 429. Uma chave de pagamento por uso permite 30 requisições por minuto e 4 simultâneas. Espere com backoff e tente de novo. Veja códigos de erro e novas tentativas na BroadNet.
- Em um plano ilimitado. Cada sessão de plano roda uma requisição por vez, então rode loops paralelos de curl em sessões separadas. Chaves de plano só funcionam com
broadnet/deepseek-v4.1-flash.
Ao relatar um problema, guarde o cabeçalho de resposta X-Request-ID (curl -D headers.txt ...).
