Aller au contenu principal

Gemini 2.5 Flash est le modèle de raisonnement hybride de Google, en endpoint de chat compatible OpenAI. Il lit jusqu’à 1 048 576 tokens et répond jusqu’à 65 535, avec trois niveaux d’effort, 128 outils max et entrée texte, image, vidéo et audio.

Entrée $0.285Sortie $2.375par 1 million de tokens5 % sous le tarif officielEntrée en cache $0.0285Tarif officiel de GoogleEntrée $0.30Sortie $2.50

Atelier

Envoyer une requête

Démarrage rapide

Les exemples suivent les paramètres publics du point de terminaison choisi. Remplacez la clé API et les médias d’exemple, puis envoyez la requête depuis votre serveur.

SDK et intégrations
POSThttps://api.spicyapi.ai/v1/chat/completions

Authentification API

Conservez la clé API dans la variable serveur SPICY_API_KEY. Utilisez l’authentification Bearer et Content-Type: application/json pour les requêtes 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'

Généré à partir du schéma d’entrée de ce modèle, le même que l’API utilise pour valider chaque requête.

Conservez le même Idempotency-Key pour chaque requête logique. Après une coupure réseau, ne renvoyez pas automatiquement la requête avec une nouvelle clé. Gardez request_id pour retrouver la requête acceptée. Le flux de chat précédent n’est pas rejoué.

Paramètres d’entrée

Placez les paramètres du modèle au même niveau que model dans le corps JSON. Ce point de terminaison ne les encapsule pas dans un objet input.

messagesarray<object>Obligatoire

Tours ordonnés, du plus ancien au plus récent. Le contenu est une chaîne ou un tableau de parties text, image_url, video_url, audio_url et input_audio. La vidéo et l’audio téléversés peuvent totaliser 14 MB par requête. Les consignes permanentes vont dans le message système, puis vous ajoutez un tour à la fois.

Valeur par défaut
Non définie
Contraintes
minItems:1
response_formatobjectFacultatif

Réclamez un objet JSON et nommez chaque clé dans le message système — c’est ainsi que la réponse revient analysable.

Valeur par défaut
Non définie
tool_choicestring | objectFacultatif

auto, none, required, ou un objet qui nomme une fonction.

Valeur par défaut
Non définie
toolsarray<object>Facultatif

Jusqu’à 128 définitions de fonctions par requête.

Valeur par défaut
Non définie
Contraintes
maxItems:128
top_pnumberFacultatif

0,01 à 1. Ajustez celui-ci ou temperature, jamais les deux dans la même comparaison.

Valeur par défaut
1
Contraintes
minimum:0.01
maximum:1
temperaturenumberFacultatif

0 à 2, 1 par défaut. Poussez vers 0 quand la réponse est lue par du code, montez quand le texte doit avoir la voix plus libre.

Valeur par défaut
1
Contraintes
minimum:0
maximum:2
seedintegerFacultatif

N’importe quel entier. Le même seed avec une requête par ailleurs identique rend les réponses très proches, ce qui permet de changer une seule chose à la fois et de comparer équitablement ; il ne garantit pas une sortie identique. Pas de valeur par défaut : chaque requête tire à nouveau. Aucun effet sur le prix.

Valeur par défaut
Non définie
stopstring | arrayFacultatif

Jusqu’à 4 séquences, sous forme de chaîne ou de tableau. La réponse s’arrête dès que le modèle en écrit une, et le texte correspondant n’est pas renvoyé. Pas de valeur par défaut. Le tarif ne change pas : une réponse coupée plus tôt n’est facturée que pour les tokens produits.

Valeur par défaut
Non définie
Contraintes
minLength:1
minItems:1
maxItems:4
reasoning_effortstringFacultatif

low, medium ou high ; medium est le défaut. Le travail courant passe très bien en low, et la requête qui doit porter se monte seule en high. Le nombre de tokens de réflexion par niveau n’est pas publié ; nous n’en avançons donc aucun.

Valeur par défaut
"medium"
Valeurs autorisées
"low""medium""high"
max_tokensintegerFacultatif

Plafonne la réponse à 65 535 ; le défaut est 16 384. Abaissez-le quand une longue lecture doit donner une réponse brève : le plafond est une limite, pas un objectif. Les tokens de raisonnement sont aussi facturés en sortie : prévoyez donc de la marge au-dessus de la réponse visible attendue.

Valeur par défaut
16384
Contraintes
minimum:1
maximum:65535

Lire le résultat

Avec stream à false, la requête renvoie directement la réponse complète : lisez choices[].message, sans interroger de tâche. Passez stream à true si votre client gère les Server-Sent Events.

Exemple de réponse terminée
{
  "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
  }
}

Cette réponse n’illustre que la structure. usage donne le nombre de tokens ; la consommation et le coût réels dépendent de votre requête.

SDK et intégrations

Utilisez SpicyAPI dans votre application, terminal, assistant IA ou workflow visuel. Choisissez un guide de configuration.

L’utiliser dans SillyTavern et les applis de jeu de rôle

Dans SillyTavern, RisuAI, Agnai ou toute appli dotée d’un réglage compatible OpenAI, collez l’URL de base ci-dessous et votre clé d’API, puis choisissez google/gemini-2.5-flash/chat comme modèle. Les appels depuis le navigateur sont acceptés, et les curseurs que ce modèle ne prend pas en charge sont ignorés au lieu d’être refusés.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-2.5-flash/chat

À utiliser dans ComfyUI

Installez les nœuds SpicyAPI depuis ComfyUI Manager ou avec la commande ci-dessous, puis choisissez google/gemini-2.5-flash/chat dans le nœud SpicyAPI Chat pour utiliser ce modèle dans un graphe ComfyUI.

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