---
title: "Base URL de APIs compatíveis com a OpenAI: 14 provedores"
description: "A base_url de 14 APIs de LLM compatíveis com a OpenAI, lida na documentação de cada provedor, com os endpoints listados e as diferenças que quebram a troca direta."
url: https://broadrouter.com/pt/blog/openai-compatible-api-base-urls/
lang: pt-BR
updated: 2026-11-15
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/blog/openai-compatible-api-base-urls/) (atualizado em 2026-11-15).

# Base URL de APIs compatíveis com a OpenAI: 14 provedores conferidos

Pela equipe da BroadNet Inference · 6 min de leitura · Publicado em 2026-11-15

Uma API compatível com a OpenAI permite manter o SDK da OpenAI e trocar só duas coisas: a base\_url e a chave de API. A base URL muda de provedor para provedor, por exemplo https://api.groq.com/openai/v1 para a Groq, https://openrouter.ai/api/v1 para o OpenRouter e https://inference.broadnet.ai/v1 para a BroadNet Inference. Caminhos, IDs de modelo e parâmetros aceitos continuam diferentes, então teste uma requisição antes de trocar.

## Pontos principais

-   A maioria dos provedores termina a base URL em /v1, mas não todos: a DeepSeek não usa caminho de versão, a Z.ai usa /api/paas/v4/ e o Gemini usa /v1beta/openai/.
-   Defina base\_url como a raiz à qual o SDK acrescenta /chat/completions. Nunca cole o caminho completo /chat/completions na base\_url.
-   "Compatível" raramente significa todos os endpoints. Confira quais entre chat completions, transcrições de áudio, embeddings e a Responses API cada provedor documenta.
-   Os IDs de modelo mudam com o provedor: deepseek-ai/DeepSeek-V4-Flash-0731 na DeepInfra, accounts/fireworks/models/… na Fireworks, broadnet/… na BroadNet.
-   A Anthropic diz que a camada OpenAI dela serve principalmente para testes; a xAI chama a Responses API de caminho preferido. Use as APIs nativas quando o provedor disser isso.

**Nesta página**

1.  Qual é a base URL de cada provedor compatível com a OpenAI?
2.  Como definir a base URL no código?
3.  Como testar uma nova base URL com curl?
4.  Quais são os erros comuns ao trocar a base\_url?
5.  Quais endpoints a BroadNet Inference aceita?
6.  Vale a pena rotear vários provedores por uma única base URL?
7.  Onde a BroadNet Inference se encaixa

Uma API compatível com a OpenAI aceita requisições no mesmo formato da API da OpenAI, então os SDKs oficiais da OpenAI funcionam depois que você troca a `base_url` e a chave de API. A parte difícil é que cada provedor coloca o endpoint em um lugar um pouco diferente. A tabela abaixo lista 14, cada um lido na documentação do próprio provedor em 15 de novembro de 2026.

## Qual é a base URL de cada provedor compatível com a OpenAI?

| Provedor | Base URL | O que a documentação de compatibilidade com a OpenAI lista | Particularidades informadas na documentação |
| --- | --- | --- | --- |
| OpenAI | `https://api.openai.com/v1` | Tudo; é a referência | Padrão do SDK quando nada é definido |
| Anthropic | `https://api.anthropic.com/v1/` | Chat completions | “Primarily intended to test and compare model capabilities” (tradução: destinada principalmente a testar e comparar as capacidades dos modelos); `strict` ignorado; entradas de áudio e arquivo retornam 400 |
| Google Gemini | `https://generativelanguage.googleapis.com/v1beta/openai/` | Chat completions, embeddings, geração de imagens, models, batch | Suporte à biblioteca da OpenAI “still in beta” (tradução: ainda em beta); Responses API não listada |
| DeepSeek | `https://api.deepseek.com` | Chat completions | Sem caminho de versão; URL separada no formato Anthropic em `/anthropic` |
| Groq | `https://api.groq.com/openai/v1` | Chat completions, Responses API; observações sobre transcrição de áudio | `logprobs`, `logit_bias`, `top_logprobs`, `messages[].name` retornam 400; `n` precisa ser 1; sem transcrições `srt` ou `vtt` |
| Together AI | `https://api.together.ai/v1` | Chat, completions, imagens, síntese de voz, transcrições, models, Responses | Inferência só nos EUA em `https://us-api.together.ai/v1`; embeddings só em endpoints dedicados |
| Fireworks AI | `https://api.fireworks.ai/inference/v1` | Chat completions | IDs de modelo como `accounts/fireworks/models/…`; reduz `max_tokens` para caber no contexto em vez de dar erro, salvo instrução contrária |
| DeepInfra | `https://api.deepinfra.com/v1/openai` | Chat completions; clientes da Responses usam a mesma base | Embeddings, imagens e voz documentados em outra página |
| Mistral AI | `https://api.mistral.ai/v1` | `POST /v1/chat/completions` | A referência da API não se declara compatível com a OpenAI; teste antes de depender disso |
| OpenRouter | `https://openrouter.ai/api/v1` | Chat completions | Cabeçalhos opcionais `HTTP-Referer` e `X-OpenRouter-Title` para os rankings dele |
| xAI | `https://api.x.ai/v1` | Responses API | O guia diz “The Responses API is the preferred way of interacting with our models” (tradução: a Responses API é a forma preferida de interagir com nossos modelos) |
| Z.ai (GLM) | `https://api.z.ai/api/paas/v4/` | Chat completions | Caminho `v4`, não `v1` |
| Alibaba Model Studio | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` (Singapura) | Chat completions | ID do workspace no host; a chave só funciona na região em que foi criada, senão 401 |
| BroadNet Inference | `https://inference.broadnet.ai/v1` | Chat completions, transcrições de áudio | IDs de modelo começam com `broadnet/`; veja abaixo |

A Alibaba também lista um endpoint nos EUA (Virgínia) em `us-east-1`. A linha de Pequim na mesma página mostra o host de Singapura, enquanto outro trecho da página cita `cn-beijing`, então confirme um endpoint na China pelo console. A tabela é um retrato do momento. Endpoints mudam: as documentações da Anthropic e do Google redirecionaram para novos endereços enquanto conferíamos.

Para os preços desses provedores, veja as páginas de [preços de API de LLM por provedor](https://broadrouter.com/llm-api-pricing/providers/).

## Como definir a base URL no código?

Em Python, passe `base_url` para o cliente:

```python
import os
from openai import OpenAI

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

Em Node, a opção é `baseURL`:

```js
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});
```

Ou defina uma vez para todas as ferramentas que usam os SDKs oficiais. No código-fonte do SDK Node, `baseURL` assume por padrão `process.env['OPENAI_BASE_URL']` e, na falta dela, `https://api.openai.com/v1`; o README do Python documenta a mesma variável:

```bash
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
```

Passo a passo completo: [SDK Python da OpenAI](https://broadrouter.com/pt/guides/openai-python-sdk/), [SDK Node da OpenAI](https://broadrouter.com/pt/guides/openai-node-sdk/). Para entender o que é uma [base URL](https://broadrouter.com/pt/glossary/base-url/) e por que as ferramentas pedem isso, veja o glossário.

## Como testar uma nova base URL com curl?

Envie uma única requisição mínima antes de mudar qualquer código da aplicação:

```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": "ping"}], "max_tokens": 20}'
```

Troque a base URL, a chave e o modelo pelos do provedor que você está testando. Um 200 com um array `choices` significa que caminho, chave e ID do modelo estão certos. Um 404 normalmente indica caminho errado; um 401, chave ou região errada; um 400 muitas vezes cita o parâmetro que o provedor rejeita. O [guia rápido de curl](https://broadrouter.com/pt/guides/curl-quickstart/) tem mais exemplos, e o [gerador de requisições de API](https://broadrouter.com/tools/api-request-builder/) escreve as versões em curl, Python e Node para você.

## Quais são os erros comuns ao trocar a base\_url?

-   **Colar o endpoint completo.** O SDK acrescenta `/chat/completions`. Uma base URL que já termina assim gera `/chat/completions/chat/completions` e um 404.
-   **Acrescentar ou tirar `/v1` por hábito.** A base documentada da DeepSeek não tem `/v1`, a da Z.ai termina em `/v4/` e a do Gemini em `/v1beta/openai/`. Copie a string exata do provedor.
-   **Manter os nomes de modelo da OpenAI.** Nomes `gpt-…` falham em outros lugares. Cada provedor tem o próprio formato: `deepseek-ai/DeepSeek-V4-Flash-0731` na DeepInfra, `accounts/fireworks/models/…` na Fireworks, `broadnet/deepseek-v4.1-flash` na BroadNet.
-   **Enviar parâmetros que o provedor rejeita ou ignora.** A Groq retorna 400 para `logprobs`; a camada da Anthropic ignora em silêncio `seed`, `logit_bias` e `reasoning_effort`. Um parâmetro ignorado em silêncio é pior que um erro, porque nada avisa você.
-   **Supor os mesmos campos na resposta.** A camada da Anthropic retorna `prompt_tokens_details` vazio, então a contagem de tokens em cache fica faltando. A Fireworks coloca o usage do streaming no último chunk, o que os tipos do SDK podem não declarar.
-   **Supor que todo endpoint existe.** “Compatível com a OpenAI” normalmente quer dizer chat completions. Embeddings, áudio, geração de imagens e a Responses API são outra história, como mostra a tabela.
-   **Misturar regiões.** As chaves da Alibaba são presas a uma região, e a Together oferece um host separado só para os EUA. Uma chave válida no host errado falha do mesmo jeito.

A lista completa para antes da troca está no [checklist de migração para APIs compatíveis com a OpenAI](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/).

## Quais endpoints a BroadNet Inference aceita?

A [referência da API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-openai-compatible-api-base-urls&utm_content=body) da BroadNet documenta dois endpoints de modelo em `https://inference.broadnet.ai/v1`, além de `GET /v1/models` para os metadados do catálogo:

| Endpoint | Modelos |
| --- | --- |
| `POST /v1/chat/completions` | DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, BroadNet Gemma 4 VL 26B |
| `POST /v1/audio/transcriptions` | BroadNet Transcribe Arabic, BroadNet Transcribe (14 idiomas) |

Na prática:

-   **Sem embeddings, geração de imagens ou Responses API** na documentação. Uma ferramenta que exige um deles precisa de um segundo provedor para essa parte.
-   **Chamada de ferramentas e saída estruturada** estão documentadas para o [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) e o [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/).
-   **Imagens entram como URLs `data:`** dentro de partes de conteúdo `image_url`, no DeepSeek V4.1 Flash, no Qwen3.8 27B e no Gemma 4 VL 26B.
-   **Modelos de raciocínio** (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) contam o raciocínio em `max_tokens`. Deixe 1.000 tokens ou mais, ou defina `reasoning_effort` como `low`, como a documentação recomenda; veja [por que modelos de raciocínio retornam respostas vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **Uma lista de modelos respondeu** quando chamamos `GET /v1/models` em 15 de novembro de 2026, mas ela não está na lista de endpoints documentados, então não construa nada em cima dela.
-   **Os limites** das chaves de pagamento por uso são 30 requisições por minuto e 4 em andamento.

Preços por 1M de tokens: DeepSeek V4.1 Flash $0.175 de entrada e $0.52 de saída, Gemma 4 VL 26B $0.10 e $0.22. O DeepSeek V4.1 Flash também é vendido em plano de preço fixo a $60 por mês por sessão, uma requisição por vez.

## Vale a pena rotear vários provedores por uma única base URL?

Se o seu app chama vários desses provedores, um proxy como o LiteLLM dá ao seu código uma única base URL e mapeia os nomes de modelo para cada upstream. Você escolhe o mapeamento; nada troca de provedor por você, a não ser que você mesmo configure fallbacks. [Failover de API de LLM](https://broadrouter.com/pt/blog/llm-api-failover-fallback/) mostra como, no cliente ou no LiteLLM. O [guia do proxy LiteLLM](https://broadrouter.com/pt/guides/litellm-proxy-custom-provider/) mostra uma entrada para a BroadNet. Para o significado do termo, veja [API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/).

## Onde a BroadNet Inference se encaixa

A BroadNet é uma boa opção se o seu código já fala chat completions e você quer modelos abertos, fala para texto em árabe e em vários idiomas, ou uma sessão DeepSeek de preço fixo em uma única chave. Não é a opção certa se você precisa de embeddings, da Responses API ou de geração de imagens no mesmo provedor; Together AI e Gemini documentam uma parte maior da superfície da OpenAI. Compare a nossa tabela com a documentação de cada provedor antes de ir para produção, porque essas URLs e listas de endpoints mudam.

Ferramentas gratuitas sobre o tema (em inglês)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Ferramentas gratuitas (em inglês)](https://broadrouter.com/tools/)

## Termos neste artigo

[Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/)

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

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

[Embeddings](https://broadrouter.com/pt/glossary/embeddings/)

Embeddings são listas de números de ponto flutuante (vetores) que um modelo produz para representar um texto, uma imagem ou outra entrada. Entradas com significado parecido recebem vetores próximos, então a distância entre vetores serve para ordenar resultados de busca, agrupar documentos ou encontrar itens relacionados.

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

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/)

Uma API compatível com a OpenAI é uma API HTTP que aceita os mesmos formatos de requisição e de resposta da API da OpenAI, como POST /v1/chat/completions, de modo que SDKs e ferramentas da OpenAI podem usá-la trocando só a base URL, a chave de API e o nome do modelo.

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

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

## Perguntas frequentes

### Qual é a base URL da API da OpenAI?

https://api.openai.com/v1. O SDK Node oficial usa esse endereço quando você não define nem baseURL nem a variável de ambiente OPENAI\_BASE\_URL.

### A base\_url deve terminar em /v1 ou em /chat/completions?

Termine onde a documentação do provedor termina, normalmente em /v1. O SDK acrescenta /chat/completions sozinho, então uma base URL que já termina em /chat/completions gera um 404.

### Dá para definir a base URL com uma variável de ambiente?

Sim. Os dois SDKs oficiais da OpenAI leem OPENAI\_BASE\_URL, e muitas ferramentas construídas sobre eles também. Defina OPENAI\_API\_KEY junto e confira a documentação de cada ferramenta, porque algumas usam nomes de variável próprios.

### A API do Claude é compatível com a OpenAI?

Em parte. A Anthropic oferece https://api.anthropic.com/v1/ para o SDK da OpenAI, mas diz que essa camada serve principalmente para testar e comparar modelos, não como caminho de produção de longo prazo. Ela ignora strict nas ferramentas e rejeita entradas de áudio e de arquivo.

### Quais endpoints a BroadNet Inference aceita?

A documentação lista POST /v1/chat/completions e POST /v1/audio/transcriptions. Não lista embeddings, geração de imagens nem a Responses API.

### Por que minha requisição funciona na OpenAI mas falha em outro provedor?

Normalmente por um ID de modelo no formato errado ou por um parâmetro que o provedor rejeita. A Groq, por exemplo, retorna 400 para logprobs, logit\_bias, top\_logprobs e messages\[\].name. Remova os parâmetros opcionais e tente de novo com o ID de modelo exato do provedor.

## Continue lendo

-   [Migrar para uma API compatível com a OpenAI: checklist de migração](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/)
-   [Como escolher um provedor de API de LLM: checklist de 20 pontos](https://broadrouter.com/pt/blog/choose-llm-api-provider-checklist/)
-   [Como avaliar um LLM antes de trocar de provedor](https://broadrouter.com/pt/blog/evaluate-llm-before-switching/)
-   [Streaming de LLM explicado: chunks SSE, deltas, usage e cancelamento](https://broadrouter.com/pt/blog/llm-streaming-sse-explained/)
-   [Hardware de GPU e serving da BroadNet, segundo a própria BroadNet](https://broadrouter.com/pt/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache de respostas de LLM para cortar custo: um cache exato em Python](https://broadrouter.com/pt/blog/cache-llm-responses-cut-cost/)
-   [Guia: Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [Guia: Como usar o SDK Node.js da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-node-sdk/)
-   [Guia: Primeira requisição à BroadNet Inference com curl](https://broadrouter.com/pt/guides/curl-quickstart/)
-   [Guia: Como rotear o LiteLLM para a BroadNet Inference (SDK e proxy)](https://broadrouter.com/pt/guides/litellm-proxy-custom-provider/)

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-blog-openai-compatible-api-base-urls&utm_content=page-cta) ·

**Fontes**

-   [Código-fonte do SDK Node da OpenAI, client.ts: base URL padrão e OPENAI\_BASE\_URL (conferido em 2026-11-15)](https://github.com/openai/openai-node/blob/master/src/client.ts)
-   [README do SDK Python da OpenAI: base\_url e OPENAI\_BASE\_URL (conferido em 2026-11-15)](https://github.com/openai/openai-python)
-   [Anthropic, compatibilidade com o SDK da OpenAI (conferido em 2026-11-15)](https://platform.claude.com/docs/en/api/openai-sdk)
-   [Google, compatibilidade do Gemini com a OpenAI (conferido em 2026-11-15)](https://aistudio.google.com/docs/openai)
-   [Documentação da API da DeepSeek, primeira chamada (conferido em 2026-11-15)](https://api-docs.deepseek.com/)
-   [Groq, compatibilidade com a OpenAI (conferido em 2026-11-15)](https://console.groq.com/docs/openai)
-   [Together AI, compatibilidade com a API da OpenAI (conferido em 2026-11-15)](https://docs.together.ai/docs/openai-api-compatibility)
-   [Fireworks AI, compatibilidade com a OpenAI (conferido em 2026-11-15)](https://docs.fireworks.ai/tools-sdks/openai-compatibility)
-   [DeepInfra, visão geral de chat completions (conferido em 2026-11-15)](https://docs.deepinfra.com/chat/overview)
-   [Referência da API da Mistral AI (conferido em 2026-11-15)](https://docs.mistral.ai/api/)
-   [Guia rápido do OpenRouter (conferido em 2026-11-15)](https://openrouter.ai/docs/quickstart)
-   [Referência da API e guia de chat da xAI (conferido em 2026-11-15)](https://docs.x.ai/docs/guides/chat)
-   [Z.ai, guia do SDK Python da OpenAI (conferido em 2026-11-15)](https://docs.z.ai/guides/develop/openai/python)
-   [Alibaba Cloud Model Studio, compatibilidade com a OpenAI (conferido em 2026-11-15)](https://www.alibabacloud.com/help/en/model-studio/compatibility-of-openai-with-dashscope)
-   [Referência da API da BroadNet Inference (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-openai-compatible-api-base-urls&utm_content=sources)
