Vai al contenuto principale

Grok 4.5 è il modello per il codice di xAI per software agentico e lavoro di ingegneria, dietro una chiamata di chat compatibile con OpenAI. Accetta fino a 500.000 token, risponde fino a 450.000 e il reasoning effort arriva fino a xhigh.

Input $2Output $6per 1 milione di tokenInput in cache $0.30Prompt da 200K token in suInput $4Output $12

Playground

Invia una richiesta

Guida rapida

Gli esempi usano le definizioni pubbliche dei parametri dell’endpoint selezionato. Sostituisci la chiave API e i media di esempio, poi invia la richiesta dal tuo server.

SDK e integrazioni
POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticazione dell’API

Tieni la chiave API nella variabile d’ambiente del server SPICY_API_KEY. Per le richieste JSON usa l’autenticazione Bearer e Content-Type: application/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.5/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'

Generato dallo schema di input di questo modello, lo stesso su cui l’API valida ogni richiesta.

Tieni una sola Idempotency-Key per ogni richiesta logica. Dopo un’interruzione di rete, non rispedire automaticamente con una chiave nuova; conserva il request_id per indagare sulla richiesta accettata. L’idempotenza non ritrasmette uno stream di chat già avvenuto.

Parametri di input

Metti i parametri del modello direttamente nel corpo JSON della richiesta, accanto a model. Questo endpoint non usa un contenitore input.

messagesarray<object>Obbligatorio

Al massimo 256 turni. Il contenuto può mescolare parti text e image_url dentro un singolo messaggio utente; su questo endpoint non esistono parti file né PDF.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:256
response_formatobjectFacoltativo

Chiedi un oggetto JSON quando la risposta viene interpretata dal passo successivo di un agente e non letta da una persona.

Predefinito
Non specificato
tool_choicestring | objectFacoltativo

auto, none, required, oppure un oggetto che nomina la funzione da chiamare.

Predefinito
Non specificato
parallel_tool_callsbooleanFacoltativo

true o false, predefinito true: il modello può chiedere più chiamate agli strumenti nello stesso turno. Con false ottieni al massimo una chiamata per turno, utile nei cicli in cui ogni chiamata dipende dal risultato precedente. Nessun effetto sul prezzo.

Predefinito
true
toolsarray<object>Facoltativo

Fino a 128 definizioni di funzione per richiesta. Tenerne stabile l'ordine fra un passo e l'altro aiuta il prefisso a restare in cache.

Predefinito
Non specificato
Vincoli
maxItems:128
top_pnumberFacoltativo

Da 0,01 a 1. Regola questo valore oppure temperature, non entrambi.

Predefinito
1
Vincoli
minimum:0.01
maximum:1
temperaturenumberFacoltativo

Da 0 a 2, predefinito 0,7. Usa 0 quando confronti due patch o due esecuzioni dello stesso compito.

Predefinito
0.7
Vincoli
minimum:0
maximum:2
max_tokensintegerFacoltativo

Limita la risposta visibile a 450.000; il valore predefinito di 4.096 tronca silenziosamente una risposta lunga. I token di ragionamento sono fatturati come output ma NON sono vincolati da questo limite: misurato su questo endpoint, reasoning_effort high con limite 800 ha prodotto 18.339 token di output. Abbassa reasoning_effort quando serve un tetto prevedibile.

Predefinito
4096
Vincoli
minimum:1
maximum:450000
reasoning_effortstringFacoltativo

low, medium, high o xhigh. High è il valore predefinito; lo sforzo viene speso in token di output, quindi xhigh alza il conto anche con una risposta corta.

Predefinito
"high"
Valori ammessi
"low""medium""high""xhigh"

Leggi il risultato

Con stream impostato a false la richiesta restituisce direttamente la risposta di chat completata. Leggi choices[].message; non serve interrogare nessuna attività. Imposta stream a true quando il tuo client supporta i Server-Sent Events.

Esempio di risposta completata
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "xai/grok-4.5/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
  }
}

L’esempio di risposta è illustrativo. usage riporta il conteggio dei token; conteggi e addebiti dipendono dalla tua richiesta reale.

SDK e integrazioni

Usa SpicyAPI nella tua app, nel terminale, con un assistente IA o in un workflow visivo. Scegli una guida di configurazione.

Usalo in SillyTavern e nelle app di roleplay

In SillyTavern, RisuAI, Agnai o in qualsiasi app con un’impostazione compatibile con OpenAI, incolla l’URL di base qui sotto e la tua chiave API, poi scegli xai/grok-4.5/chat come modello. Le chiamate dal browser sono consentite, e i cursori che questo modello non supporta vengono ignorati invece di essere rifiutati.

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

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi scegli xai/grok-4.5/chat nel nodo SpicyAPI Chat per usare questo modello dentro un grafo di ComfyUI.

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