Google: Gemma 4 31B (free)
Gemma 4 31B IT est le modèle dense de Google ajusté pour suivre des instructions, destiné au raisonnement textuel et visuel. Son contexte de 256K, sa réflexion configurable, sa compréhension des images et ses appels de fonctions natifs servent les tâches de code, de documents et d’agents, avec une sortie textuelle.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Gemma 4 31B IT est l’édition dense de la famille ouverte Gemma 4 de Google DeepMind, ajustée pour suivre des instructions. Google positionne le modèle 31B sur la qualité du modèle et son adaptation à une tâche, tandis que l’édition distincte 26B A4B utilise un mélange d’experts pour améliorer l’efficacité de l’inférence. Cette fiche concerne l’édition 31B ajustée pour suivre des instructions, et non ses poids préentraînés ou un dérivé quantifié.
Le tableau officiel de l’architecture dense indique 30,7 milliards de paramètres, 60 couches, une fenêtre glissante de 1 024 tokens et un contexte de 256K tokens. La famille associe une attention locale à fenêtre glissante à une attention globale, se termine par une couche globale et utilise un encodeur visuel dédié pour ce modèle. Ce profil est conçu pour recevoir du texte et des images et produire du texte. Ces caractéristiques décrivent l’architecture du modèle ; elles ne fixent pas le temps de réponse d’une application et n’impliquent pas la prise en charge audio proposée par d’autres tailles de Gemma 4.
Son contexte de 256K tokens permet de traiter une tâche qui associe un volume de texte conséquent à des éléments visuels. Images et texte peuvent être alternés dans un même prompt ; pour obtenir les meilleurs résultats, le fabricant recommande de placer l’image avant le texte qui s’y rapporte. Les tâches visuelles comprennent la détection d’objets, l’interprétation de pages de documents, la compréhension d’écrans et d’interfaces, les graphiques, l’OCR multilingue, l’écriture manuscrite et le pointage. La sortie est du texte : contenu extrait, explication, code ou proposition d’action à effectuer avec un outil.
La réflexion configurable permet au modèle de raisonner avant de répondre ou de donner une réponse directe. Gemma 4 ajoute un rôle système natif aux rôles utilisateur et assistant. Le format de prompt de Google active la réflexion avec le token de contrôle <|think|> dans le prompt système et sépare le canal de réflexion de la réponse finale ; le processeur documenté sait gérer ce modèle de conversation. Pour une conversation à plusieurs tours, conservez les réponses finales précédentes dans l’historique et excluez les réflexions antérieures, sauf pour les tours d’appel d’outil, où le fabricant indique qu’elles doivent être conservées.
L’appel de fonctions natif prend en charge l’utilisation structurée d’outils, et la présentation de lancement de Google documente aussi les sorties JSON structurées. Définissez la tâche, la fonction disponible et le résultat attendu ; l’application réalise l’opération demandée et renvoie son résultat pour l’étape suivante. Une tâche de programmation peut porter sur la génération, la complétion ou la correction de code, tandis qu’un assistant visuel peut utiliser le texte renvoyé pour expliquer un graphique ou un écran. Une instruction d’appel de fonction est distincte d’une action connectée réellement exécutée.
La résolution variable des images est contrôlée par le budget de tokens visuels. Les options documentées sont 70, 140, 280, 560 et 1 120 tokens. Les budgets faibles conviennent à la classification ou aux légendes ; les budgets élevés préservent davantage de détails pour l’OCR, l’analyse de documents et les petits caractères, avec un coût de calcul supplémentaire. Déterminez si vous avez besoin de la scène dans son ensemble ou du texte exact avant de préparer l’image. Un recadrage net d’une étiquette peut être plus utile pour une extraction qu’une demande générale d’examiner chaque détail d’une page entière.
Google recommande temperature 1.0, top-p 0.95 et top-k 64 comme configuration d’échantillonnage de la famille. La fiche du modèle distingue un entraînement dans plus de 140 langues d’une prise en charge immédiate de plus de 35 langues. Précisez la langue de réponse et indiquez explicitement dans le brief les noms de domaine, noms de champs ou formules à conserver. La valeur 256K est une spécification de contexte ; la fiche citée ne définit pas de maximum de sortie universel distinct pour cette édition.
Pour une tâche associant document et code, fournissez l’image de la page pertinente, l’exigence écrite et le fragment de code source : « Lisez les libellés, expliquez en quoi cet écran diffère de la spécification et proposez une correction ciblée du code fourni. » Pour un graphique, demandez de distinguer les valeurs visibles d’une tendance déduite. La fiche de Gemma mentionne des limites liées au langage ambigu, aux tâches très complexes et aux affirmations factuelles inexactes ou dépassées ; joignez donc les faits de référence que le résultat doit utiliser, plutôt que de compter sur les connaissances acquises pendant l’entraînement.
Via Ailoot, sélectionnez cet identifiant de modèle exact dans /v1/chat/completions et indiquez la tâche dans messages. Chaque message comporte un role et son content ; gardez ensemble la consigne pertinente et les documents sources. Récupérez la réponse JSON complète ou tous les segments SSE lorsque stream est activé, et conservez usage avec le résultat écrit.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions google/gemma-4-31b-it:free
google/gemma-4-31b-it:freePremiers pas
Gemma 4 31B IT est le modèle dense de Google ajusté pour suivre des instructions, destiné au raisonnement textuel et visuel. Son contexte de 256K, sa réflexion configurable, sa compréhension des images et ses appels de fonctions natifs servent les tâches de code, de documents et d’agents, avec une sortie textuelle.
- Entrées acceptées
- Texte · Images
- Résultats
- Texte
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- Entrée
text,image- Sortie
text- Format de sortie
- JSON or SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites google/gemma-4-31b-it:free Conditions: Utilisez exactement ce sélecteur de routage Ailoot. | Par défaut— |
Champmessages | Typearray | ExigenceObligatoire | Valeurs et limites Conditions: | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites Conditions: | Par défautfalse |
Combinaisons d’éléments d’entrée
text_input · Obligatoire : messages
image_with_text · Obligatoire : messages with actual image content blocks
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, messages |
Paramètreoptional | Contratstream |
Paramètrematerial_types | Contrattext, image |
Paramètreconditions | ContratUtilisez exactement ce sélecteur de routage Ailoot., Ce protocole transmet le contenu des images lorsque le modèle précis sélectionné prend en charge la vision. L’admission par le protocole n’établit pas que chaque modèle peut traiter des images. |
Alias de méthode : /chat/completions
Cycle de vie : synchronous_or_streamed
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Tarif standard Lorsque le mode rapide est sélectionné
- Mode Flex
- Tarif standard Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Tarif standard Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
- Tarification du cache explicite
- Non activé Lorsqu’un cache explicite est demandé
- Tarifs nuls pour le texte uniquement
- Le cache, les outils et les médias sont soumis à leurs conditions tarifaires respectives, indiquées séparément. Pour une entrée et une sortie exclusivement textuelles
Tarifs Ailoot
Prix par configuration
| Configuration | Barème tarifaire | Coût |
|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Coût Entrée · Tokens en entrée $0 / 1K tokens Sortie · Tokens en sortie $0 / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/gemma-4-31b-it:free", "messages": [{"role": "user", "content": "Explain how a rainbow forms."}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Recevoir et enregistrer les résultats
Ailoot Ultra · OpenAI Chat
JSON or SSE
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez chaque bloc de contenu, chaque identifiant d’appel d’outil, la signature de raisonnement lorsqu’elle est renvoyée, tous les deltas SSE et les données complètes de consommation. Le premier fragment de texte ne représente pas l’intégralité du résultat.
Si la réponse d’origine doit être vérifiée
Conservez le X-Client-Request-ID d’origine, la réponse et les en-têtes. Un résultat inconnu ou à l’état result_pending_check n’autorise pas une deuxième création.
Champs de la réponse
| Champ | Type |
|---|---|
Champchoices[] | Typeobject |
Champusage | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionUn champ obligatoire, un sélecteur de modèle, un type ou une représentation de l’entrée est invalide. | Étape suivanteExaminez les détails de validation renvoyés avant de préparer une requête distincte. |
Réponse | ConditionLa requête d’origine ou son résultat est inconnu ou nécessite une vérification. | Étape suivanteConservez les identifiants et les en-têtes d’origine ; consultez uniquement les enregistrements d’état ou de bibliothèque pris en charge. Ne soumettez pas à nouveau la requête de création. |
Alias
Alias du modèle
Ailoot Ultra google/gemma-4-31b-it:free
Alias des chemins de méthode
/chat/completions
ID d’appel associés
FAQ · Google: Gemma 4 31B (free)
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/chat/completions·google/gemma-4-31b-it:free:text,image→text- Quels champs la requête utilise-t-elle ?
POST /v1/chat/completions·google/gemma-4-31b-it:free:model,messages,stream