BroadRouter
Começar

API compatível com a OpenAI

Atualizado em

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 enviada como Authorization: Bearer <key>;
  • streaming como server-sent events quando stream é true.

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

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, 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 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 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 e de Node mostram configurações completas, e o LangChain 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 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.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity