---
title: "API de LLM com curl: guia rápido de chat, streaming e áudio"
description: "Primeiras chamadas à BroadNet Inference com curl: um chat completion, uma resposta em streaming e uma transcrição de áudio, e como ler resposta, usage e erros."
url: https://broadrouter.com/pt/guides/curl-quickstart/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/curl-quickstart/) (atualizado em 2026-11-16).

# Primeira requisição à BroadNet Inference com curl

Atualizado em 2026-11-16

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](https://broadrouter.com/pt/guides/openai-python-sdk/) 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.

```bash
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:

```bash
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`:

```bash
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](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).

## 4\. Receba a resposta em streaming

Adicione `"stream": true` e desligue o buffer do curl com `-N`:

```bash
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](https://broadrouter.com/pt/guides/streaming-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`:

```bash
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](https://broadrouter.com/pt/guides/transcribe-whatsapp-voice-notes/). Para árabe, use `broadnet/cohere-transcribe-arabic` com `language=ar`; veja o [guia de fala para texto em árabe](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/). 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](https://broadrouter.com/pt/pricing/). Cada modelo tem sua própria página, por exemplo [GLM 5.3](https://broadrouter.com/pt/models/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](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/).
-   **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](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Em um plano ilimitado.** Cada [sessão de plano](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) 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 ...`).

## Termos neste guia

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Streaming](https://broadrouter.com/pt/glossary/streaming/)

Streaming é uma forma de devolver a resposta de um modelo de linguagem em pequenos pedaços enquanto ela ainda está sendo gerada, em vez de uma resposta única no final. APIs compatíveis com a OpenAI fazem streaming via server-sent events quando a requisição define stream como true.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Lista de IPs permitidos (IP allow list)](https://broadrouter.com/pt/glossary/ip-allow-list/)

Uma lista de IPs permitidos é um controle de segurança que aceita requisições apenas de endereços IP ou faixas CIDR listados e recusa todos os outros. Em uma API, ela limita o estrago de uma chave vazada, porque a chave não funciona a partir de redes que não estão na lista.

[Chat Completions API](https://broadrouter.com/pt/glossary/chat-completions-api/)

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/)

Crédito pré-pago é dinheiro adicionado a uma conta de API antes do uso. Cada requisição desconta o próprio custo do saldo e, quando o saldo acaba, as requisições cobradas por uso param até você fazer uma recarga. Ele limita o gasto ao que você já pagou.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

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

## Guias relacionados

-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [Streaming de chat completions e conexões que caem](https://broadrouter.com/pt/guides/streaming-chat-completions/)
-   [API de transcrição de áudio em árabe, passo a passo](https://broadrouter.com/pt/guides/arabic-speech-to-text-api/)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-curl-quickstart&utm_content=page-cta) ·

**Fontes**

-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-curl-quickstart&utm_content=sources)
-   [Lista de modelos e preços em formato legível por máquina (pricing.json) (em inglês)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-curl-quickstart&utm_content=sources)
