Vai al contenuto principale

Gemini 2.5 Flash è il modello di reasoning ibrido di Google come endpoint di chat compatibile con OpenAI. Legge fino a 1.048.576 token e risponde fino a 65.535, con tre livelli di reasoning effort, fino a 128 tool e input di testo, immagini, video e audio.

Input $0.285Output $2.375per 1 milione di token5% sotto il prezzo di listino del produttore del modelloInput in cache $0.0285Prezzo ufficiale di GoogleInput $0.30Output $2.50

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": "google/gemini-2.5-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

Turni ordinati, dal più vecchio. Il contenuto è una stringa o un array di parti text, image_url, video_url, audio_url e input_audio. Video e audio caricati possono arrivare a 14 MB in totale per richiesta. Metti le istruzioni permanenti nel messaggio di sistema e aggiungi un turno alla volta.

Predefinito
Non specificato
Vincoli
minItems:1
response_formatobjectFacoltativo

Chiedi un oggetto JSON e nomina ogni chiave nel messaggio di sistema: è così che una risposta torna analizzabile.

Predefinito
Non specificato
tool_choicestring | objectFacoltativo

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

Predefinito
Non specificato
toolsarray<object>Facoltativo

Fino a 128 definizioni di funzione per richiesta.

Predefinito
Non specificato
Vincoli
maxItems:128
top_pnumberFacoltativo

Da 0,01 a 1. Regola questo oppure temperature, mai entrambi nello stesso confronto.

Predefinito
1
Vincoli
minimum:0.01
maximum:1
temperaturenumberFacoltativo

Da 0 a 2, 1 per impostazione predefinita. Spingila verso 0 quando la risposta viene analizzata dal codice, alzala quando la scrittura ha bisogno di una voce più sciolta.

Predefinito
1
Vincoli
minimum:0
maximum:2
seedintegerFacoltativo

Qualsiasi intero. Lo stesso seed con una richiesta per il resto identica rende le risposte molto simili, così puoi cambiare una cosa alla volta e confrontare in modo equo; non garantisce un output identico. Nessun valore predefinito: ogni richiesta estrae da capo. Nessun effetto sul prezzo.

Predefinito
Non specificato
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

low, medium o high; medium è il predefinito. Il lavoro di routine gira bene su low, e la singola richiesta che deve andare a segno può essere alzata a high da sola. Non esiste un numero pubblicato di token di ragionamento per livello, quindi non ne citiamo nessuno.

Predefinito
"medium"
Valori ammessi
"low""medium""high"
max_tokensintegerFacoltativo

Limita la risposta a 65.535; il valore predefinito è 16.384. Abbassalo quando vuoi una risposta corta da una lettura lunga: il tetto è un limite, non un obiettivo. Anche i token di ragionamento sono fatturati come output, quindi lascia margine oltre la risposta visibile che ti aspetti.

Predefinito
16384
Vincoli
minimum:1
maximum:65535

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": "google/gemini-2.5-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 google/gemini-2.5-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: google/gemini-2.5-flash/chat

Usalo in ComfyUI

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