Porquê a API de Respostas?
Nesta página
Um Novo Endpoint para Novas Ambições
A API de Respostas é o novo endpoint principal da xAI para interagir com os modelos Grok. Se já está familiarizado com o endpoint de Completions de Chat (compatível com a OpenAI), provavelmente questiona-se por que razão a xAI criou um segundo endpoint. A resposta resume-se a uma palavra: evolução.
O endpoint de Completions de Chat mantém-se disponível para garantir a retrocompatibilidade com os SDKs da OpenAI, mas a xAI adiciona todas as novas funcionalidades da plataforma primeiro à API de Respostas. Este é o endpoint que vale o seu investimento de aprendizagem.
Com Estado vs. Sem Estado: A Mudança Fundamental
A diferença mais importante entre os dois endpoints reside na forma como gerem o estado da conversação.
Completions de Chat (sem estado)
Com os Completions de Chat, cada pedido é independente. Deve enviar todo o histórico da conversação em cada chamada:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are an assistant."},
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Tell me about AI."}
]
}
Quanto mais longa for a conversação, maior será o pedido. Gere o contexto manualmente.
API de Respostas (com estado)
Com a API de Respostas, o servidor da xAI retém o histórico. Basta enviar a sua nova mensagem e uma referência à resposta anterior:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
O servidor reconstrói o contexto completo para si. Menos dados para transmitir, menos código para escrever, menos erros possíveis.
Funcionalidades Exclusivas
Várias funcionalidades estão disponíveis apenas através da API de Respostas:
- Ferramentas nativas no servidor:
web_search,x_searchecode_interpreterexecutam diretamente nos servidores da xAI, sem qualquer configuração da sua parte - Encadeamento de conversações: através de
previous_response_id, o modelo retém todo o contexto sem que tenha de o reenviar - Armazenamento persistente: com
store: true, as suas respostas são retidas durante 30 dias e podem ser recuperadas via GET - Raciocínio encriptado: recupere o raciocínio interno dos modelos Grok recentes sob forma encriptada para reutilizar em pedidos subsequentes
- Acompanhamento granular de custos:
cost_in_nano_usdem cada resposta para um controlo preciso das suas despesas
Quando Utilizar Cada Endpoint?
Utilize os Completions de Chat apenas se estiver a migrar um projeto existente a partir da API da OpenAI e não puder modificar o seu código imediatamente.
Para qualquer novo projeto, utilize a API de Respostas. É mais simples, mais poderosa e receberá todas as melhorias futuras da plataforma xAI.
Pontos-chave
- A API de Respostas é o endpoint principal da xAI; os Completions de Chat são legados
- É com estado: o servidor gere o histórico da conversação
- Oferece ferramentas nativas no servidor (pesquisa na web, X, interpretador de código)
- O armazenamento persistente permite retomar conversações até 30 dias depois
- Qualquer novo projeto deve utilizar a API de Respostas