---
title: "O que é uma API compatível com a OpenAI? Como funciona"
description: "Uma API compatível com a OpenAI aceita as mesmas requisições da OpenAI: SDKs existentes funcionam trocando base URL, chave e modelo. O que é igual e o que muda."
url: https://broadrouter.com/pt/glossary/openai-compatible-api/
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/glossary/openai-compatible-api/) (atualizado em 2026-11-15).

# API compatível com a OpenAI

Atualizado em 2026-11-15

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.

Também chamado de: API compatível com a OpenAI, API compatível com OpenAI, API no padrão OpenAI, compatibilidade com a OpenAI, OpenAI-compatible API, OpenAI API compatible, OpenAI-style API, OpenAI drop-in replacement

O formato da API da OpenAI virou a língua comum das ferramentas de LLM. Hoje muitos provedores o aceitam, então uma única biblioteca cliente consegue conversar com vários backends.

## Como funciona

Uma API compatível copia as partes da API da OpenAI de que os clientes dependem:

-   os mesmos caminhos, como `/v1/chat/completions` e `/v1/audio/transcriptions`;
-   as mesmas estruturas JSON: um array `messages` na entrada, `choices[0].message.content` na saída e um bloco `usage` com as contagens de tokens;
-   uma [chave de API](https://broadrouter.com/pt/glossary/api-key/) enviada como `Authorization: Bearer <key>`;
-   [streaming](https://broadrouter.com/pt/glossary/streaming/) como server-sent events quando `stream` é true.

Trocar de provedor é uma mudança de configuração. Com o SDK Python oficial:

```python
from openai import OpenAI
import os

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

Em relação a um exemplo da OpenAI, só três valores mudaram: a [base URL](https://broadrouter.com/pt/glossary/base-url/), a chave e o ID do modelo.

## Por que importa

A compatibilidade reduz o custo de troca. SDKs, frameworks de agentes, plugins de IDE e [roteadores](https://broadrouter.com/pt/glossary/llm-router/) que falam o formato da OpenAI funcionam sem código novo. Você consegue testar um segundo provedor em minutos e manter a opção de migrar.

Mas compatível não é idêntico. A própria camada de compatibilidade da Anthropic, por exemplo, ignora `strict` nas ferramentas e deixa `prompt_tokens_details` vazio. As diferenças típicas são:

-   parâmetros ignorados ou recusados;
-   como os [tokens de raciocínio](https://broadrouter.com/pt/glossary/reasoning-tokens/) contam para `max_tokens`;
-   se o usage é informado no fim de um stream;
-   limites de taxa e códigos de erro.

## Na BroadNet Inference

A BroadNet Inference oferece `POST /v1/chat/completions`, `POST /v1/audio/transcriptions` e `GET /v1/models` em `https://inference.broadnet.ai/v1`. As chaves são enviadas apenas como `Authorization: Bearer <key>`. Os guias de [Python](https://broadrouter.com/pt/guides/openai-python-sdk/) e de [Node](https://broadrouter.com/pt/guides/openai-node-sdk/) mostram configurações completas, e o [LangChain](https://broadrouter.com/pt/guides/langchain-openai-base-url/) funciona do mesmo jeito.

Duas diferenças para planejar: DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B raciocinam antes de responder, e o raciocínio conta para `max_tokens`. Além disso, uma chave de pagamento por uso permite 30 requisições por minuto e 4 simultâneas. O [checklist de migração](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/) cobre o resto.

## Erros comuns

-   Manter um nome de modelo da OpenAI, como `gpt-6-astra` (o modelo principal da OpenAI na página de modelos dela, consultada em 2026-11-15). Use o ID de modelo do provedor.
-   Supor que um parâmetro funciona porque a requisição deu certo. Alguns provedores ignoram campos desconhecidos em silêncio.

## Perguntas frequentes

### Compatível com a OpenAI significa que todo recurso da OpenAI funciona?

Não. Significa que os formatos principais de requisição e de resposta batem. Campos específicos podem ser ignorados ou recusados. A camada de compatibilidade da Anthropic, por exemplo, documenta os campos que ignora e os que retornam erro 400. Leia a lista do provedor antes de depender de um parâmetro.

### Preciso de outro SDK?

Não. Os SDKs oficiais da OpenAI aceitam uma base URL personalizada. Em Python, passe base\_url; em Node, passe baseURL; ou defina a variável de ambiente OPENAI\_BASE\_URL.

### Quais endpoints a BroadNet Inference suporta?

POST /v1/chat/completions para chat e POST /v1/audio/transcriptions para fala para texto. O GET /v1/models também existe; a documentação da BroadNet o descreve como metadados públicos do catálogo para monitores externos, então pegue na referência da API os IDs de modelo das requisições.

## Veja também

-   [Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/) (termo)
-   [Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/) (termo)
-   [LLM router (roteador de LLMs)](https://broadrouter.com/pt/glossary/llm-router/) (termo)
-   [Streaming](https://broadrouter.com/pt/glossary/streaming/) (termo)
-   [Provedor de inferência (inference provider)](https://broadrouter.com/pt/glossary/inference-provider/) (termo)
-   [Server-sent events (SSE)](https://broadrouter.com/pt/glossary/sse/) (termo)
-   [Chat Completions API](https://broadrouter.com/pt/glossary/chat-completions-api/) (termo)
-   [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)
-   [Como usar o LangChain com a BroadNet Inference](https://broadrouter.com/pt/guides/langchain-openai-base-url/) (guia)
-   [Primeira requisição à BroadNet Inference com curl](https://broadrouter.com/pt/guides/curl-quickstart/) (guia)
-   [Migrar para uma API compatível com a OpenAI: checklist de migração](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/) (artigo)
-   [OpenRouter ou preço fixo para agentes de IA: qual sai mais barato?](https://broadrouter.com/pt/blog/openrouter-alternative-flat-rate/) (artigo)

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

**Fontes**

-   [Referência da API da OpenAI, criar um chat completion](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Anthropic, compatibilidade com o SDK da OpenAI e suas limitações](https://platform.claude.com/docs/en/api/openai-sdk)
-   [SDK Python da OpenAI (base\_url e OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-openai-compatible-api&utm_content=sources)
-   [OpenAI, modelos (consultado em 2026-11-15)](https://developers.openai.com/api/docs/models)
