Estado de legado e o princípio stateless
Nesta página
Atualizado a 3 de novembro de 2026 com base nas melhores práticas da xAI: a xAI classifica agora as Chat Completions como obsoletas (deprecated) e recomenda a API de Respostas (Responses API) para os modelos de raciocínio Grok. Motivo concreto: as Chat Completions não dispõem de um campo para o raciocínio encriptado do modelo, pelo que cada conversa com várias trocas ou chamada de ferramenta perde o raciocínio das interações anteriores. As novas funcionalidades também chegam primeiro à API de Respostas. Fontes: Melhores práticas da xAI · Chat Completions (legado).
O endpoint Chat Completions no ecossistema xAI
A API da xAI oferece dois endpoints principais para interagir com os modelos Grok: a API de Respostas (endpoint principal) e o endpoint Chat Completions. Este último está assinalado como legado: continua totalmente funcional, mas as novas funcionalidades são agora priorizadas para a API de Respostas.
Por que razão deve importar-se com isto? Porque as Chat Completions continuam a ser o endpoint mais adotado no ecossistema. Todos os SDKs existentes da OpenAI, frameworks como o LangChain ou o LlamaIndex e milhares de tutoriais utilizam este formato. Se estiver a migrar de outro fornecedor ou a trabalhar com ferramentas de terceiros, este será provavelmente o primeiro endpoint que irá utilizar.
Um endpoint stateless: envie tudo em cada pedido
O princípio fundamental das Chat Completions é que estas são stateless: o servidor não guarda qualquer histórico de conversação. Em cada chamada, deve incluir todo o histórico das mensagens anteriores no seu pedido.
Especificamente, isto significa que, numa conversação com 10 trocas, o seu 11.º pedido deve conter as 10 mensagens anteriores (utilizador + assistente) mais a nova mensagem. A sua aplicação gere este histórico.
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Explain deep learning to me."}
]
}
Neste exemplo, as primeiras três mensagens representam o histórico da conversação. Apenas a última é a nova mensagem do utilizador. O modelo necessita de todo este contexto para produzir uma resposta coerente.
Implicações práticas
Esta abordagem stateless tem várias implicações:
- Controlo total: decide exatamente quais as mensagens enviadas ao modelo. Pode filtrar, resumir ou modificar o histórico antes de cada chamada.
- Custo proporcional: cada pedido é faturado por todos os tokens enviados, incluindo o histórico. Quanto mais longa for a conversação, mais cara será cada troca.
- Sem persistência no servidor: nenhuns dados são armazenados do lado da xAI entre pedidos. Isto é uma vantagem para a privacidade, mas exige que gere a persistência por sua conta.
Comparação com a API de Respostas
A API de Respostas, por outro lado, é stateful: mantém o histórico no lado do servidor através do parâmetro previous_response_id. Não precisa de reenviar as mensagens anteriores; basta um simples identificador. As respostas podem ser armazenadas até 30 dias com store: true.
A escolha entre os dois depende do seu caso de uso. Se estiver a trabalhar com um SDK existente da OpenAI ou a migrar de outro fornecedor, as Chat Completions são o ponto de partida lógico. Para um novo projeto, recomenda-se a API de Respostas.
Pontos-chave
- As Chat Completions estão assinaladas como legado, mas permanecem totalmente funcionais e compatíveis com o ecossistema OpenAI
- O endpoint é stateless: deve reenviar o histórico completo em cada pedido
- O custo de cada pedido inclui todos os tokens do histórico
- A API de Respostas oferece uma alternativa stateful com persistência no lado do servidor
- Para modelos de raciocínio, recomenda-se um timeout de 3600 segundos