Vai al contenuto principale

Gemini 3.7 Flash è il modello di chat ad alta velocità di Google per coding quotidiano, uso agentico dei tool e attività multi-step, tramite API compatibile con OpenAI. Legge fino a 1.048.576 token e risponde fino a 65.536, con tre livelli di reasoning effort.

Input $0.675Output $3.375per 1 milione di token10% sotto il prezzo di listino del produttore del modelloInput in cache $0.0675Prezzo ufficiale di GoogleInput $0.75Output $3.75

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-3.7-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 testo, image_url e video_url. Il video viene inviato come file caricato, e il video di una richiesta può arrivare a 14 MB in totale. Metti le regole del compito e il contratto sugli strumenti 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 i risultati di estrazione tornano analizzabili.

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, di serie 1. Google consiglia di lasciare i modelli Gemini 3 a 1,0: sotto quel valore la generazione può entrare in loop o peggiorare. Dai forma all'output strutturato con response_format e il messaggio di sistema.

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

minimal, low, medium o high; medium è il valore di serie. I passi di routine girano bene su low, e il passo che deve venire giusto può essere alzato a high per conto suo.

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

Mette un tetto alla risposta a 65.536; di serie vale 16.384. I token di ragionamento escono da questo stesso budget, quindi un tetto molto basso può essere speso in deliberazione prima che la risposta cominci e restituire una stringa vuota. Lascia spazio vero, oppure abbassa reasoning_effort quando la risposta deve essere breve.

Predefinito
16384
Vincoli
minimum:1
maximum:65536

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-3.7-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-3.7-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-3.7-flash/chat

Usalo in ComfyUI

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