BroadRouter
Começar

Primeira requisição à BroadNet Inference com curl

Atualizado em

Envie um POST para https://inference.broadnet.ai/v1/chat/completions com o cabeçalho Authorization Bearer e a sua chave, e um corpo JSON com model, por exemplo broadnet/gemma-4-26b-a4b, e messages. Para streaming, adicione stream true. Para áudio, envie um formulário multipart com model, language e file para /v1/audio/transcriptions.

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

Perguntas frequentes

Qual modelo posso chamar com o crédito inicial gratuito?

O BroadNet Gemma 4 VL 26B, ID de modelo broadnet/gemma-4-26b-a4b, e os dois modelos de transcrição. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash exigem uma recarga.

Por que o content da mensagem vem vazio na resposta do curl?

Modelos de raciocínio gastam max_tokens primeiro no raciocínio. Se finish_reason for length, aumente max_tokens para 1.000 ou mais.

Por que minha transcrição em árabe saiu em letras latinas?

A requisição não tinha o campo language. Envie language=ar para árabe e o código ISO 639-1 correspondente para outros idiomas.

GET /v1/models lista todos os modelos que posso chamar?

A documentação da BroadNet diz que o GET /v1/models "supplies public catalogue metadata for external monitors" (tradução: fornece metadados públicos do catálogo para monitores externos). Nas requisições, use os IDs de modelo da referência da API ou do pricing.json.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity