Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Porquê a API de Respostas?

Aula 1 de 16 Atualizada a 28 de julho de 2026 Programador
Nesta página
  1. Um Novo Endpoint para Novas Ambições
  2. Com Estado vs. Sem Estado: A Mudança Fundamental
  3. Funcionalidades Exclusivas
  4. Quando Utilizar Cada Endpoint?
  5. Pontos-chave

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.

Com estado
Histórico no servidor
30 dias
Retenção de respostas
4
Ferramentas integradas no servidor
128
Máximo de ferramentas por pedido

Funcionalidades Exclusivas

Várias funcionalidades estão disponíveis apenas através da API de Respostas:

  • Ferramentas nativas no servidor: web_search, x_search e code_interpreter executam 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_usd em 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