Google: Gemma 4 31B (free)
Gemma 4 31B IT est le modèle dense de Google ajusté pour suivre des instructions et effectuer des raisonnements textuels et visuels. Son contexte de 256K, son raisonnement configurable, sa compréhension des images et ses appels de fonctions natifs accompagnent 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, ajustée pour suivre des instructions, de la famille ouverte Gemma 4 de Google DeepMind. Google met en avant la qualité du modèle 31B 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 nommée, ajustée pour suivre des instructions, et non ses poids préentraînés ou une version quantifiée dérivée.
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 combine une attention locale à fenêtre glissante et une attention globale, avec une couche globale en dernier, et utilise un encodeur visuel dédié pour ce modèle. Le profil obtenu reçoit du texte et des images et produit du texte. Ces données décrivent l’architecture du modèle ; elles ne déterminent pas le temps de réponse d’une application et n’impliquent pas la prise en charge audio d’autres tailles de Gemma 4.
Son contexte de 256K tokens permet de réunir un volume important de texte et des éléments visuels dans une tâche. Images et texte peuvent être entrelacés dans un même prompt ; le fabricant recommande de placer le contenu visuel avant le texte associé pour obtenir les meilleurs résultats. 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 textuelle : contenu extrait, explication, code ou action d’outil proposée.
Le raisonnement configurable permet au modèle de réfléchir avant de répondre ou de fournir 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 le raisonnement 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é peut gérer ce gabarit. Dans une conversation à plusieurs tours, conservez les réponses finales précédentes dans l’historique et excluez les réflexions antérieures, sauf dans les tours d’appel d’outil, où le fabricant indique qu’elles doivent être conservées.
Les appels de fonctions natifs permettent une utilisation structurée des outils ; 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 exécute l’opération demandée et renvoie sa sortie pour l’étape suivante. Une tâche de code peut demander une génération, une complétion ou une correction, tandis qu’un assistant visuel peut utiliser le texte renvoyé pour expliquer un graphique ou un écran. Une instruction d’appel de fonction se distingue d’une action connectée effectivement 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 plus élevés préservent davantage de détails pour l’OCR, l’analyse de documents et les petits caractères, au prix de calculs supplémentaires. Déterminez si vous avez besoin de la scène d’ensemble ou du lettrage exact avant de préparer l’image. Un recadrage net d’une étiquette peut être plus utile à 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 les noms de domaine, noms de champs ou formules à conserver explicitement dans les consignes. Le chiffre 256K décrit le contexte ; la fiche citée n’établit pas de plafond universel distinct pour la sortie de cette édition.
Pour une tâche mêlant document et code, fournissez l’image de la page concernée, l’exigence écrite et l’extrait 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 séparer les valeurs visibles de la tendance déduite. La fiche de Gemma signale des limites concernant le langage ambigu, les tâches très complexes et les affirmations factuelles inexactes ou dépassées ; joignez donc les faits faisant autorité que le résultat doit utiliser, sans compter sur les connaissances d’entraînement pour les fournir.
Avec Ailoot, sélectionnez cet identifiant exact de modèle dans /v1/chat/completions et fournissez la tâche dans messages. Chaque message contient un rôle et son contenu ; regroupez l’instruction pertinente et les sources. Recueillez 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 et effectuer des raisonnements textuels et visuels. Son contexte de 256K, son raisonnement configurable, sa compréhension des images et ses appels de fonctions natifs accompagnent 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 les images lorsque le modèle précis sélectionné prend en charge la vision. L’admission par le protocole ne démontre pas que tous les modèles prennent en charge les 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 suivent leurs conditions tarifaires respectives, indiquées séparément. Pour des entrées et des sorties 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 l’ensemble des données de consommation. Le premier fragment de texte ne constitue pas le résultat complet.
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 seconde 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 des données d’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 un contrôle. | É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 une nouvelle fois 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