Introdução
Chat compatível com OpenAI para o Grok 4.3: um array de mensagens que carrega partes de texto e imagem, cinco níveis de esforço de raciocínio incluindo none, e respostas de até 900.000 tokens.
O Grok 4.3 é o Grok rápido e confiável da xAI, publicado como um único endpoint compatível com OpenAI em /v1/chat/completions. Uma requisição comporta no máximo 256 turnos ordenados e até 1.000.000 de tokens, com o conteúdo das imagens contado dentro desse orçamento, e devolve ou um objeto chat.completion ou um fluxo SSE de fragmentos. Desde 15 de maio de 2026 a xAI redireciona grok-4-fast, grok-4-1-fast, grok-4-0709, grok-code-fast-1 e grok-3 para cá, então é neste modelo que essas integrações rodam hoje.
Recursos e destaques
none é um interruptor, não um nível mais baixo
O reasoning_effort aceita none, low, medium, high e xhigh, e o padrão deste modelo é low, não high. Em none o modelo responde sem nenhuma passagem de deliberação: uma classificação de sim ou não volta como um único token, em vez de um parágrafo de raciocínio seguido da palavra que você queria. O esforço é cobrado como tokens de saída, então o nível escolhido mexe ao mesmo tempo na latência e na conta. Entre os modelos Grok publicados aqui, só este oferece o none.
A janela é de 1.000.000 de tokens e a linha de contexto longo continua em 200.000
São dois números diferentes, e é na distância entre eles que moram as surpresas. A requisição passa para a tarifa de contexto longo a partir de 200.000 tokens somando entrada e entrada em cache, um quinto do que este modelo ainda aceita: existe então uma faixa larga em que o prompt cabe com folga e já é cobrado na tarifa longa. A estimativa exibida antes do envio diz em qual faixa a requisição cai.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
messages | Sim | No máximo 256 turnos. O conteúdo pode misturar partes de texto e |
reasoning_effort | Não | none, low, medium, high ou xhigh. low é o padrão e none pula a deliberação por completo; o esforço é gasto em tokens de saída. |
max_tokens | Não | Limita a resposta visível a 900.000; o padrão de 4.096 corta uma resposta longa sem avisar. |
temperature | Não | De 0 a 2, padrão 0,7. Use 0 ao comparar dois mockups ou duas execuções. |
top_p | Não | De 0,01 a 1. Mexa neste ou em temperature, não nos dois juntos. |
tools | Não | Até 128 definições de função por requisição. no máximo 128 itens |
parallel_tool_calls | Não | true ou false, padrão true: o modelo pode pedir várias chamadas de ferramenta no mesmo turno. Valor padrão: |
tool_choice | Não | auto, none, required ou um objeto nomeando a função a chamar. |
response_format | Não | Peça um objeto JSON quando a resposta for lida por código, e não por uma pessoa. |
Preços
Entrada $1.25 / Saída $2.50 por 1 milhão de tokens; Prompts com 200K tokens ou mais: Entrada $2.50 / Saída $5
O total de entrada inclui tokens em cache. A partir de 200.000 tokens de entrada, as tarifas de contexto longo se aplicam a toda a entrada, entrada em cache e saída da requisição; abaixo desse limite, valem as tarifas padrão. A saída inclui tokens de raciocínio e, no nível none, como não há deliberação, não há nenhum a pagar. Confira o orçamento antes do envio. A reserva inicial não considera economia de cache; na liquidação, a diferença é devolvida conforme o uso medido.
Casos de uso
Classificar, extrair e rotear no nível none
Rotular um chamado, tirar os campos de uma nota fiscal ou decidir qual modelo adiante recebe a requisição: o none pula a deliberação, a resposta chega na velocidade em que o modelo consegue escrever e nenhum token de raciocínio entra na conta. Junte com response_format para receber um objeto JSON que o seu código lê direto, em vez de uma frase que alguém vai ter que desmontar.
Mudar uma integração de um identificador aposentado
A xAI aposentou grok-4-fast-reasoning, grok-4-fast-non-reasoning, grok-4-1-fast-reasoning, grok-4-1-fast-non-reasoning, grok-4-0709, grok-code-fast-1 e grok-3 em 15 de maio de 2026 e redireciona todos para este modelo. Aponte o cliente para xai/grok-4.3, ponha reasoning_effort em low onde o identificador antigo era variante reasoning e em none onde não era. O orçamento de contexto aumenta junto.
Um milhão de tokens de material num só turno
Um repositório inteiro, um ano de atendimentos ou uma pilha de contratos cabe numa única requisição, então a resposta não é montada com pedaços que nunca se viram. Peça a citação da redação cláusula por cláusula e aumente o max_tokens quando a própria resposta precisar ser longa: o padrão de 4.096 corta sem retornar erro nenhum.
Capturas de tela e stack traces na mesma mensagem
Anexe um painel quebrado como parte image_url em detalhe high, cole o stack trace como texto no mesmo turno do usuário e então peça as causas em ordem. A imagem e o log chegam juntos, então o modelo não trabalha em cima da sua transcrição de nenhum dos dois, e ambos são contabilizados dentro da mesma janela que o prompt.
Guia de prompt e dicas práticas
Escolha o nível de esforço de propósito
Decida por tarefa em vez de confiar no padrão: none para classificar, extrair, rotear e converter formato; low para seguir instruções no dia a dia e para loops de ferramentas; medium, high ou xhigh quando a resposta realmente precisa ser elaborada. O esforço é gasto em tokens de saída, então ele desconta tanto do max_tokens quanto da fatura, e uma resposta longa em xhigh pode bater no teto antes de terminar.
Uma requisição pronta para colar
O conteúdo de uma mensagem de usuário pode ser uma string simples ou um array de partes, e este modelo declara dois tipos de parte:
{"type": "text", "text": "..."}{"type": "image_url", "image_url": {"url": "...", "detail": "auto|low|high"}}
curl https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "xai/grok-4.3",
"messages": [{"role": "user", "content": [
{"type": "text", "text": "Which panel shows the regression, and what changed?"},
{"type": "image_url", "image_url": {"url": "https://cdn.spicyapi.ai/models/examples/inputs/c681580c3c6a0b63.jpeg", "detail": "high"}},
{"type": "image_url", "image_url": {"url": "https://cdn.spicyapi.ai/models/examples/inputs/59f0bc6291069978.jpeg", "detail": "high"}}
]}],
"max_tokens": 4000
}'
Leia a resposta e também o medidor
Streaming é o jeito prático de consumir uma geração longa: stream: true devolve eventos chat.completion.chunk até data: [DONE], e uma chamada sem streaming em xhigh sobre uma janela cheia pode demorar o bastante para estourar o tempo limite do cliente. Antes de somar mais um documento, veja se a requisição passou de 200.000 tokens de entrada, porque é ali que começa a tarifa de contexto longo. Partes de arquivo e PDF não são aceitas neste endpoint, então um anexo precisa virar texto ou imagem antes de ser enviado.
Início rápido da API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "xai/grok-4.3/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.










