Vai al contenuto principale

Grok 4.3 è il modello di chat di xAI dietro una chiamata compatibile con OpenAI, che accetta parti di testo e immagini in un unico array di messaggi. Legge 1.000.000 di token, risponde fino a 900.000 e offre cinque livelli di reasoning effort, incluso none.

Input $1.25Output $2.50per 1 milione di tokenInput in cache $0.20Prompt da 200K token in suInput $2.50Output $5

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.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'

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.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:256
response_formatobjectFacoltativo

Chiedi un oggetto JSON quando la risposta viene letta da codice e non 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.

Predefinito
Non specificato
Vincoli
maxItems:128
top_pnumberFacoltativo

Da 0,01 a 1. Muovi questo oppure temperature, non entrambi insieme.

Predefinito
1
Vincoli
minimum:0.01
maximum:1
temperaturenumberFacoltativo

Da 0 a 2, predefinito 0,7. Usa 0 quando confronti due mockup o due esecuzioni.

Predefinito
0.7
Vincoli
minimum:0
maximum:2
max_tokensintegerFacoltativo

Limita la risposta visibile a 900.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, lo sforzo high con limite 800 ha prodotto 18.339 token di output. Abbassa reasoning_effort quando serve un tetto prevedibile. Lo sforzo none elimina del tutto quella spesa (misurato: 145 token di output con limite 2.000).

Predefinito
4096
Vincoli
minimum:1
maximum:900000
reasoning_effortstringFacoltativo

none, low, medium, high o xhigh. low è il valore predefinito e none salta del tutto il passaggio di deliberazione; lo sforzo viene speso in token di output.

Predefinito
"low"
Valori ammessi
"none""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.3/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.3/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.3/chat

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi scegli xai/grok-4.3/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