---
title: "Guia rápido da BroadNet Inference: API em Python e cURL"
description: "Envie sua primeira requisição de chat e de transcrição para a BroadNet Inference com Python ou cURL e siga o checklist de migração do modelo escolhido."
url: https://broadrouter.com/pt/developers/
lang: pt-BR
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Desenvolvedores

Atualizado em 2026-11-15

A BroadNet Inference usa os formatos de requisição da OpenAI em `https://inference.broadnet.ai/v1`. Crie uma chave no console, guarde-a em uma variável de ambiente e envie uma requisição para `/chat/completions` ou `/audio/transcriptions` com um ID de modelo exato. Antes de migrar o tráfego de produção, confira parâmetros, streaming, ferramentas, limites e erros desse modelo.

-   Guia rápido de chat
-   Guia rápido de transcrição
-   IDs de modelo
-   Checklist de migração
-   Erros e novas tentativas
-   Documentação e guias

## Como envio minha primeira requisição de chat?

1.  Entre em [inference.broadnet.ai (em inglês)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=quickstart-account) e crie uma chave de inferência. Ela aparece uma única vez; o console guarda apenas o hash.
2.  Instale o SDK da OpenAI e defina a chave no terminal. Mantenha as chaves no seu servidor, nunca em código que roda no navegador.
3.  Envie a requisição. Leia a resposta em `choices[0].message.content`.

setup

```
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

first\_request.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

request.sh

```
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":"Reply with one short sentence."}]}'
```

O exemplo usa o BroadNet Gemma 4 VL 26B, que o crédito inicial de US$ 5 cobre. DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B exigem uma recarga antes. Guarde o cabeçalho de resposta `X-Request-ID` para o suporte.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### Streaming

Defina `stream=true` e leia os Server-Sent Events até `data: [DONE]`. Com `stream_options.include_usage`, o uso de tokens chega no último chunk. Se o stream terminar antes do `[DONE]`, considere a resposta incompleta. A BroadNet pede que você verifique o streaming em cada modelo antes de depender dele em produção.

stream.sh

```
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 from one to three."}]}'
```

## Como transcrevo áudio?

Envie WAV ou MP3, com até 26.214.400 bytes por arquivo, para `/audio/transcriptions`. Sempre defina `language`: sem ele, o árabe pode voltar em letras latinas. Use `language=ar` para árabe. Converta antes os arquivos `.ogg` ou `.m4a`: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

A resposta é um JSON com a transcrição em `text`. [Modelo árabe ou multilíngue, e quanto custa o áudio](https://broadrouter.com/pt/arabic-transcription/).

## Quais IDs de modelo posso usar?

Passe o ID exato em `model`. Não dependa de `/v1/models` para descobrir os modelos de chat; use esta lista ou a [referência (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=models-docs#models).

| Modelo | ID | Endpoint | Entrada | Documentado | Acesso |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Texto + Imagem | Raciocínio | Exige recarga |
| [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Texto | Ferramentas, Saída estruturada, Raciocínio | Exige recarga |
| [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Texto + Imagem | Ferramentas, Saída estruturada, Raciocínio | Exige recarga |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/pt/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Texto + Imagem | — | Crédito inicial |
| [BroadNet Transcribe Arabic](https://broadrouter.com/pt/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Áudio em árabe | — | Crédito inicial |
| [BroadNet Transcribe](https://broadrouter.com/pt/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Áudio, 14 idiomas | — | Crédito inicial |

"Documentado" lista as ferramentas, a saída estruturada e o raciocínio que a referência da BroadNet cita para cada modelo (consultada em 2026-11-15). Um traço significa que a referência não os cita; não significa que não existam.

## Migrando de outra API compatível com a OpenAI: checklist

Os formatos de requisição são conhecidos, mas os modelos são diferentes. Passe por cada item para o modelo escolhido e teste antes de mudar o tráfego.

1.  **Endpoint.** Defina a URL base como `https://inference.broadnet.ai/v1`.
2.  **Chave.** Use uma chave de inferência da BroadNet a partir de uma variável de ambiente. Chaves de plano e chaves de pagamento por uso são separadas.
3.  **ID do modelo.** Use o ID exato, por exemplo `broadnet/gemma-4-26b-a4b`.
4.  **Parâmetros.** Confira se cada parâmetro que você envia está documentado para esse modelo. Remova os que não aparecem na lista.
5.  **Streaming.** Confirme que o seu cliente lê o SSE até o `[DONE]` e trata um stream que termina antes da hora.
6.  **Ferramentas e saída estruturada.** A referência documenta esses recursos para GLM 5.3 e Qwen3.8 27B. Teste qualquer outro modelo antes de depender deles.
7.  **Raciocínio.** O raciocínio pode consumir parte do orçamento de saída. Deixe folga em `max_tokens`; veja [respostas vazias de modelos de raciocínio](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
8.  **Limites.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 simultâneas. Uma sessão de plano permite uma requisição por vez. Uma chave por hora do Gemma permite um stream, 120 requisições por minuto e 300.000 tokens por minuto.
9.  **Contexto.** O contexto inclui a entrada e a resposta. Confira o limite do modelo na [página do modelo](https://broadrouter.com/pt/models/).
10.  **Erros.** Associe os códigos de status abaixo a uma ação de nova tentativa ou de correção, e registre o `X-Request-ID`.
11.  **Custos.** Faça a estimativa com as [calculadoras de preço](https://broadrouter.com/pt/pricing/). No pagamento por uso, imagens contam como tokens de entrada.

## Quais erros devo tentar de novo?

| Status | Significado | Ação |
| --- | --- | --- |
| 400 / 422 | Requisição ou campo inválido | Corrija a requisição; não repita como está |
| 401 | Chave ausente, inválida ou expirada, ou cota esgotada | Confira a chave e a conta |
| 402 | `insufficient_balance` | Recarregue e tente de novo |
| 413 | Requisição acima do limite de bytes ou de texto | Envie menos, por exemplo um arquivo de áudio menor |
| 429 | Limite de taxa, de concorrência, de tokens por minuto ou de gastos | Aguarde (com limite de tentativas) e tente de novo |
| 500–504 | Problema no servidor | Tente de novo com backoff exponencial limitado |

Resumido da [tabela de erros da referência (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=errors-docs#errors), consultada em 2026-11-15. [Exemplos de código para novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

## Onde estão a documentação completa e os guias?

-   [**Referência para desenvolvedores (em inglês)**Formatos de requisição, limites, erros e o feed de preços. A fonte oficial.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=docs)
-   [**Integrações (em inglês)**Configurações para Aider, Cline, LangChain, n8n, LiteLLM e outras ferramentas compatíveis com a OpenAI.](https://broadrouter.com/integrations/)
-   [**Guias**SDKs, streaming, novas tentativas, listas de IPs permitidos e voz em árabe.](https://broadrouter.com/pt/guides/)
-   [**Guia do SDK para Python**Instalação, primeira requisição e streaming com o SDK da OpenAI para Python.](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [**Guia do SDK para Node**O mesmo em JavaScript e TypeScript, com IDs de requisição.](https://broadrouter.com/pt/guides/openai-node-sdk/)
-   [**Guia rápido de cURL**Todas as requisições pelo terminal.](https://broadrouter.com/pt/guides/curl-quickstart/)
-   [**Chaves e listas de IPs permitidos**Restrinja suas chaves aos seus servidores.](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/)
-   [**Gerador de requisições de API (em inglês)**Monte uma requisição no navegador e copie.](https://broadrouter.com/tools/api-request-builder/)

Precisa de um endpoint privado ou de um modelo que não está na lista? [Fale com a BroadNet](https://broadrouter.com/pt/contact/#private).

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-developers&utm_content=page-cta) ·

**Fontes**

-   [Referência para desenvolvedores da BroadNet Inference (consultada em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=sources)
-   [Preços da BroadNet Inference (em inglês)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=sources)
-   [pricing.json, a tabela de preços publicada (em inglês)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-developers&utm_content=sources)
