Pular para o conteúdo principal

O Grok 4.7 é o modelo de chat da xAI em uma chamada compatível com OpenAI, com streaming SSE. Aceita contexto de 500.000 tokens e responde com até 450.000, com esforço de raciocínio de low a xhigh; esta plataforma não adiciona nenhum filtro.

Entrada $2Saída $6por 1 milhão de tokensEntrada em cache $0.50Prompts com 200K tokens ou maisEntrada $4Saída $12

Playground

Enviar uma requisição

Início rápido

Os exemplos usam as definições públicas de parâmetros do endpoint selecionado. Troque a chave de API e as mídias de exemplo e envie a requisição a partir do seu servidor.

SDKs e integrações
POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticação da API

Guarde a chave de API na variável de ambiente do servidor SPICY_API_KEY. Use autenticação Bearer e Content-Type: application/json nas requisições JSON.

Authorization: Bearer $SPICY_API_KEY
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.7/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'

Gerado a partir do schema de entrada deste modelo — o mesmo que a API usa para validar cada requisição.

Use um Idempotency-Key para cada requisição lógica. Depois de uma interrupção de rede, não reenvie automaticamente com uma chave nova; guarde o request_id para investigar a requisição aceita. A idempotência não reproduz um stream de chat anterior.

Parâmetros de entrada

Coloque os parâmetros do modelo direto no corpo JSON da requisição, ao lado de model. Este endpoint não usa um objeto input.

messagesarray<object>Obrigatório

No máximo 256 turnos. O conteúdo pode misturar partes text e image_url dentro de uma mesma mensagem de usuário. O papel de sistema é respeitado neste endpoint (verificado de propósito), então uma premissa definida uma vez no topo vale para a conversa inteira.

Valor padrão
Não especificado
Restrições
minItems:1
maxItems:256
response_formatobjectOpcional

Peça um objeto JSON quando a resposta for lida por código e não por uma pessoa.

Valor padrão
Não especificado
tool_choicestring | objectOpcional

auto, none, required, ou um objeto nomeando a função a chamar.

Valor padrão
Não especificado
parallel_tool_callsbooleanOpcional

true ou false, padrão true: o modelo pode pedir várias chamadas de ferramenta no mesmo turno. Com false, você recebe no máximo uma chamada por turno, útil em loops em que cada chamada depende do resultado anterior. Não afeta o preço.

Valor padrão
true
toolsarray<object>Opcional

Até 128 definições de função por requisição. Esta geração é comparativamente fraca em loops agênticos longos.

Valor padrão
Não especificado
Restrições
maxItems:128
top_pnumberOpcional

De 0,01 a 1. Mexa neste valor ou em temperature, não nos dois juntos.

Valor padrão
1
Restrições
minimum:0.01
maximum:1
temperaturenumberOpcional

De 0 a 2, padrão 0,7. Perto de 0,9 para dar variedade à prosa; 0 só quando duas execuções precisam diferir por um único motivo.

Valor padrão
0.7
Restrições
minimum:0
maximum:2
max_tokensintegerOpcional

Limita a resposta visível a 450.000; o padrão de 4.096 trunca uma resposta longa em silêncio. Tokens de raciocínio são cobrados como saída, mas NÃO estão sujeitos a esse limite. Baixe reasoning_effort quando precisar de um teto previsível.

Valor padrão
4096
Restrições
minimum:1
maximum:450000
reasoning_effortstringOpcional

low, medium, high ou xhigh; o padrão é high. Para diálogo e roleplay use low ou medium: high gasta tokens de saída deliberando e soa como hesitação. O esforço é cobrado como saída, então o ajuste mais cauteloso também sai mais caro.

Valor padrão
"high"
Valores permitidos
"low""medium""high""xhigh"

Ler resultado

Com stream em false, a requisição já devolve a resposta completa: leia choices[].message, sem consultar tarefa nenhuma. Coloque stream em true se o seu cliente aceita Server-Sent Events.

Exemplo de resposta concluída
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "xai/grok-4.7/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Esta resposta serve só para mostrar o formato. usage traz a contagem de tokens; o consumo e a cobrança reais dependem da sua requisição.

SDKs e integrações

Use a SpicyAPI no seu app, terminal, assistente de IA ou fluxo visual. Escolha um guia de configuração.

Use no SillyTavern e em apps de roleplay

No SillyTavern, RisuAI, Agnai ou qualquer app com configuração compatível com OpenAI, cole a URL base abaixo e sua chave de API e escolha xai/grok-4.7/chat como modelo. Chamadas direto do navegador são aceitas, e controles que este modelo não suporta são ignorados em vez de recusados.

Base URL: https://api.spicyapi.ai/v1
Model: xai/grok-4.7/chat

Use no ComfyUI

Instale os nós da SpicyAPI pelo ComfyUI Manager ou com o comando abaixo e escolha xai/grok-4.7/chat no nó SpicyAPI Chat para usar este modelo em um grafo do ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi