Vai al contenuto principale

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": "deepseek/v4-flash/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

Battute in ordine, dalla più vecchia, al massimo 256. Contenuto solo testuale; reasoning_content è valido sui messaggi assistant.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:256
response_formatobjectFacoltativo

Chiedi un oggetto JSON quando la risposta alimenta un parser e non una persona.

Predefinito
Non specificato
tool_choicestring | objectFacoltativo

auto, none, required oppure un oggetto che nomina una singola funzione.

Predefinito
Non specificato
toolsarray<object>Facoltativo

Fino a 128 definizioni di funzione in una richiesta.

Predefinito
Non specificato
Vincoli
maxItems:128
max_tokensintegerFacoltativo

Limita la risposta a 65.536. Il valore predefinito è 32.768, che tronca in silenzio una consegna lunga. Anche i token di ragionamento sono fatturati come output, quindi lascia margine oltre la risposta visibile che ti aspetti.

Predefinito
32768
Vincoli
minimum:1
maximum:65536
stopstring | arrayFacoltativo

Fino a 4 sequenze, come stringa o come array. La risposta si ferma appena il modello ne scrive una, e il testo corrispondente non viene restituito. Nessun valore predefinito. La tariffa non cambia: una risposta interrotta prima viene addebitata solo per i token prodotti.

Predefinito
Non specificato
Vincoli
minLength:1
minItems:1
maxItems:4
reasoning_effortstringFacoltativo

none, low o high, high come predefinito. none salta del tutto il passaggio di ragionamento: è l'unico modo per tenere i token di ragionamento fuori dal conto, perché vengono fatturati come output. low per i passaggi di volume, high per le risposte che non possono essere sbagliate.

Predefinito
"high"
Valori ammessi
"none""low""high"

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": "deepseek/v4-flash/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 deepseek/v4-flash/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: deepseek/v4-flash/chat

Usalo in ComfyUI

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