---
title: "O que é a Chat Completions API? O endpoint de chat /v1"
description: "A Chat Completions API recebe uma lista de mensagens com papéis e devolve a resposta do modelo. Como funciona e por que tantos provedores a copiam."
url: https://broadrouter.com/pt/glossary/chat-completions-api/
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/glossary/chat-completions-api/) (atualizado em 2026-11-16).

# Chat Completions API

Atualizado em 2026-11-16

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.

Também chamado de: Chat Completions, API Chat Completions, endpoint de chat completions, /v1/chat/completions, chat.completions.create, chat completions endpoint

A maior parte do código de LLM por aí fala um único dialeto: uma lista de mensagens entra, uma mensagem sai. Esse dialeto é a Chat Completions API.

## Como funciona

Você faz um POST de JSON para `/v1/chat/completions` com um `model` e um array `messages`. Cada mensagem tem um `role` (`system`, `user`, `assistant` ou `tool`) e um `content`. A resposta traz um array `choices`; cada choice tem uma `message` e um [finish\_reason](https://broadrouter.com/pt/glossary/finish-reason/) que diz por que a geração terminou, além de um bloco `usage` com a contagem de tokens.

```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":"system","content":"Answer in one line."},
                   {"role":"user","content":"What is a token?"}]}'
```

No SDK Python da OpenAI, a mesma chamada é `client.chat.completions.create(...)`. Campos opcionais moldam a saída: `max_tokens`, `temperature`, `stream`, `tools`, `response_format` e outros.

A API é stateless. O guia de migração da OpenAI diz que, na Chat Completions, “conversation state must be managed manually” (tradução: o estado da conversa precisa ser gerenciado manualmente): o seu código guarda o histórico e o envia de novo a cada turno. A Responses API, mais nova, usa itens tipados e pode manter o estado no servidor, e a OpenAI a recomenda para projetos novos na própria plataforma, mas diz que a Chat Completions “remains supported” (continua com suporte).

## Por que isso importa

-   **Portabilidade.** Uma [API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/) normalmente significa este endpoint. Trocar de provedor muitas vezes é só uma nova [base URL](https://broadrouter.com/pt/glossary/base-url/), uma nova chave e um novo nome de modelo.
-   **Custo.** Como o histórico inteiro é reenviado, os tokens de entrada crescem a cada turno. Corte ou resuma conversas longas.
-   **Campos que divergem.** Nem todo provedor compatível aceita todos os campos da OpenAI. Campos desconhecidos podem ser ignorados ou rejeitados, então teste os que você usa.

## Na BroadNet Inference

A BroadNet oferece chat em POST /v1/chat/completions em `https://inference.broadnet.ai/v1`, para DeepSeek V4.1 Flash, [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) e [Gemma 4 VL 26B](https://broadrouter.com/pt/models/gemma-4-vl-26b/). O [streaming](https://broadrouter.com/pt/glossary/streaming/) usa `stream=true` e termina com `data: [DONE]`. Tool calling e saída estruturada estão documentados apenas para GLM 5.3 e Qwen3.8 27B. A [referência da API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-chat-completions-api&utm_content=body) da BroadNet não documenta um endpoint Responses, então use a Chat Completions. Comece pelo [quickstart com curl](https://broadrouter.com/pt/guides/curl-quickstart/) ou pelo [guia do SDK Python](https://broadrouter.com/pt/guides/openai-python-sdk/).

## Erros comuns

-   Enviar só a última mensagem do usuário e esperar que o modelo lembre da conversa.
-   Copiar campos exclusivos da OpenAI para outro provedor sem conferir a referência dele.

## Perguntas frequentes

### A Chat Completions API foi descontinuada?

Não. O guia de migração da OpenAI diz "Chat Completions remains supported" (a Chat Completions continua com suporte), embora recomende a Responses API, mais nova, para projetos novos na OpenAI.

### A Chat Completions API lembra das mensagens anteriores?

Não. Ela é stateless. O guia da OpenAI diz que o estado da conversa "must be managed manually" (precisa ser gerenciado manualmente), então você envia o histórico completo de mensagens em toda requisição.

### Qual endpoint a BroadNet Inference usa para chat?

POST /v1/chat/completions na base URL https://inference.broadnet.ai/v1. A BroadNet não documenta um endpoint da Responses API.

## Veja também

-   [API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/) (termo)
-   [Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/) (termo)
-   [Streaming](https://broadrouter.com/pt/glossary/streaming/) (termo)
-   [finish\_reason](https://broadrouter.com/pt/glossary/finish-reason/) (termo)
-   [Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/) (termo)
-   [Prompt de sistema (system prompt)](https://broadrouter.com/pt/glossary/system-prompt/) (termo)
-   [Tokens de imagem (image tokens)](https://broadrouter.com/pt/glossary/image-tokens/) (termo)
-   [Primeira requisição à BroadNet Inference com curl](https://broadrouter.com/pt/guides/curl-quickstart/) (guia)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/) (guia)
-   [Streaming de chat completions e conexões que caem](https://broadrouter.com/pt/guides/streaming-chat-completions/) (guia)
-   [Como migrar da API da OpenAI: o código em Python, Node e cURL](https://broadrouter.com/pt/blog/migrate-from-openai-api-code-walkthrough/) (artigo)
-   [Migrar para uma API compatível com a OpenAI: checklist de migração](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/) (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-chat-completions-api&utm_content=page-cta) ·

**Fontes**

-   [Referência da API da OpenAI, criar chat completion (conferido em 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, migrar para a Responses API (conferido em 2026-11-15)](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [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-glossary-chat-completions-api&utm_content=sources)
