models

Google: Gemini 3.1 Pro Preview (batch)

Markdown · JSON

Google: Gemini 3.1 Pro Preview (batch)

Gemini 3.1 Pro Preview est le modèle de raisonnement multimodal de Google pour les tâches complexes de logiciels, d’algorithmes et de connaissances. Il accepte texte, images, audio, vidéo et PDF et renvoie texte ou code, avec outils et sortie structurée. Les niveaux low, medium et high orientent l’effort; high est le réglage documenté par défaut.

À 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.

Gemini 3.1 Pro Preview est le modèle textuel de Google axé sur le raisonnement pour les tâches complexes qui nécessitent du génie logiciel, du développement algorithmique ou une synthèse de données probantes multimodales. Il s’appuie sur Gemini 3 Pro, en mettant l’accent sur l’utilisation précise des outils, un raisonnement plus efficace et une exécution fiable à plusieurs étapes. Le texte, les images, l’audio, la vidéo et les PDF peuvent contribuer à une réponse écrite, à un livrable de code ou à un résultat structuré.

Pour une tâche de programmation exigeante, fournissez l’objectif, les éléments pertinents du dépôt, le comportement observé et les contraintes à conserver. Des dépôts de code entiers peuvent fournir du contexte à la tâche. Pour vérifier un contrat de code, demandez au modèle de comparer la gestion d’un contrat de données partagé dans deux modules, d’identifier l’écart et de proposer une correction ciblée avec des références au code à l’appui. La sortie utile distingue l’analyse, la révision proposée et les données probantes de toute validation effectuée par l’application connectée.

Les éléments de lancement montrent des explications visuelles basées sur du code et des projets interactifs, notamment une sortie SVG animée à partir d’une consigne textuelle. Ce sont des livrables de code plutôt que de la génération d’images matricielles. Une consigne claire peut définir ce qui doit être expliqué, le comportement du visuel et les données qu’il doit représenter. Vérifiez le code et le rendu obtenus à partir de ces exigences. Pour une tâche de synthèse de données, fournissez les sources réelles et demandez une vue unique qui préserve les relations et les nuances qu’elles contiennent.

Les niveaux de réflexion documentés sont faible, moyen et élevé, le niveau élevé étant la valeur par défaut de 3.1 Pro Preview. La réflexion ne peut pas être complètement désactivée dans ce profil Pro. Choisissez un effort moindre pour une réponse délimitée et davantage de raisonnement pour le travail difficile à plusieurs étapes, tout en laissant une capacité de sortie suffisante pour le livrable final. Une petite limite de sortie peut interrompre le raisonnement avant qu’une réponse finale utilisable n’apparaisse. Le guide de réflexion distingue un résumé du raisonnement du processus interne complet et explique pourquoi le contexte de signatures de pensée de la conversation compte.

Le tableau Preview exact indique les appels de fonctions, l’exécution de code, l’ancrage par recherche, l’ancrage avec Maps, le contexte URL et les sorties structurées. Il limite File Search à AI Studio. Fournissez la finalité des fonctions et les définitions de paramètres, puis continuez à partir du résultat réellement renvoyé. Le profil distinct Custom Tools Preview est optimisé pour prioriser les outils personnalisés et bash; il s’agit d’un point de terminaison nommé distinct du producteur, et cette spécialisation ne doit donc pas être traitée discrètement comme une propriété de chaque requête 3.1 Pro. Sélectionnez un schéma de résultat structuré lorsqu’une tâche nécessite des enregistrements définis plutôt que de la prose libre.

Pour une analyse multimodale, identifiez la page, le visuel, l’intervalle d’enregistrement ou l’événement vidéo pertinent. Pour une analyse documentaire, comparez un diagramme à sa spécification écrite et renvoyez chaque écart avec le passage à l’appui. Une source parlée peut fournir une transcription ou une interprétation textuelle. Préservez les références aux sources pour les conclusions à vérifier et distinguez ce qui est visible ou énoncé de ce qui est inféré. La sortie de ce profil reste du texte, y compris du code; la génération native d’images ou de parole ne fait pas partie de son tableau exact de capacités.

La fiche native 3.1 Pro précise un contexte allant jusqu’à 1M et une sortie textuelle de 64K, et le tableau API Preview exact donne 1 048 576 jetons d’entrée et 65 536 jetons de sortie. Incluez les instructions, l’historique de conversation et les médias dans le budget d’entrée. La mise en cache et le traitement par lots sont documentés, les options Flex et Priority étant aussi indiquées pour le profil du producteur. Pour plusieurs éléments indépendants, définissez la sortie requise et conservez chaque identifiant de source plutôt que de combiner des données probantes sans rapport dans une réponse impossible à retracer.

L’édition nommée Preview reste distincte du profil Custom Tools de Pro et des versions Flash ou Pro ultérieures. Ses forces concernent le raisonnement complexe, la programmation et la synthèse de données probantes; le livrable final doit tout de même être vérifié à partir de la source et des résultats d’outils réels. Conservez les ambiguïtés non résolues lorsque l’information fournie n’appuie pas une conclusion certaine. Un livrable utile est la réponse, le code ou l’enregistrement étayé par les sources que la tâche demande, avec assez de données probantes pour en évaluer les limites pratiques.

Ailoot Ultra · Traitement par lots POST /v1/batches google/gemini-3.1-pro-preview:batch

google/gemini-3.1-pro-preview:batch

Google /google/gemini-3.1-pro-preview:batch

Pour commencer

Gemini 3.1 Pro Preview est le modèle de raisonnement multimodal de Google pour les tâches complexes de logiciels, d’algorithmes et de connaissances. Il accepte texte, images, audio, vidéo et PDF et renvoie texte ou code, avec outils et sortie structurée. Les niveaux low, medium et high orientent l’effort; high est le réglage documenté par défaut.

Entrées acceptées
Texte
Résultats
Texte

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Traitement par lots POST /v1/batches
Entrée
text
Sortie
text
Format de sortie
JSON results[].response.body intégré
ChampTypeExigenceValeurs et limitesPar défaut
ChampendpointTypestringExigenceObligatoireValeurs et limites
/v1/chat/completions
Par défaut—
ChampmodelTypestringExigenceObligatoireValeurs et limites
google/gemini-3.1-pro-preview:batch
Par défaut—
ChamprequestsTypebatch_item[]ExigenceObligatoireValeurs et limites
Nombre minimal d’éléments: 1
Par défaut—
Champrequests[].custom_idTypestringExigenceObligatoireValeurs et limitesPar défaut—
Champrequests[].body.messagesTypemessage[]ExigenceObligatoireValeurs et limitesPar défaut—
Champcompletion_windowTypestringExigenceFacultatifValeurs et limites
24h
Par défaut—
ChampproviderTypeobject|nullExigenceFacultatifValeurs et limitesPar défaut—
Champrequests[].body.modelTypestringExigenceFacultatifValeurs et limites
google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview
Par défaut—
Champprovider.onlyTypestring[]ExigenceFacultatifValeurs et limites
google-vertex/global
Par défaut—
Champprovider.allow_fallbacksTypeboolean|nullExigenceFacultatifValeurs et limites
false, null
Par défaut—
Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratendpoint, model, requests
Paramètrematerial_typesContrattext
ParamètrerepresentationContratrequests[] intégré ; chaque élément comporte custom_id et body
Paramètrerequest_endpoint_profileContrat/v1/chat/completions
Paramètrefile_materialContratL’appelant peut charger localement le contenu JSONL UTF-8 effectif dans requests[]. Aucun paramètre purpose de téléversement, input_file_id ni référence à un fichier n’est utilisé. Si les données du client sont absentes ou vides, la préparation s’arrête avant le POST.
Paramètreserialization_orderContratendpoint, model, provider (si fourni), completion_window (si fourni), requests en dernier
Paramètreoptional_controlsContratprovider.only, provider.allow_fallbacks, completion_window
Paramètreschema_scopeContratCorps de requêtes Chat Completions textuelles dans l’enveloppe Batch intégrée documentée.

Cycle de vie : asynchronous

GET /v1/batches/{operation_id} · response.id effectivement renvoyé lors de la création d’origine ; même utilisateur, même clé et même groupe

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
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarification du cache explicite
Non activé Lorsque la mise en cache explicite est demandée

Tarifs Ailoot

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationBarème tarifaireJetons de contexte, plus deJetons de contexte, jusqu’à la limite incluseCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseJetons de contexte, plus de—Jetons de contexte, jusqu’à la limite incluseSans borne supérieureCoût
Entrée · Jetons en entrée $0.002 / 1K jetons
Sortie · Jetons en sortie $0.012 / 1K jetons
Entrée · Lecture du cache — / 1K jetons
Entrée · Écriture dans le cache — / 1K jetons
Entrée · Écriture dans le cache, 1 h — / 1K jetons
ConfigurationPalier 1 de longueur de requêteBarème tarifaire—Jetons de contexte, plus de0Jetons de contexte, jusqu’à la limite incluse200 000Coût
Entrée · Jetons en entrée $0.002 / 1K jetons
Sortie · Jetons en sortie $0.012 / 1K jetons
Entrée · Lecture du cache — / 1K jetons
Entrée · Écriture dans le cache — / 1K jetons
Entrée · Écriture dans le cache, 1 h — / 1K jetons
ConfigurationPalier 2 de longueur de requêteBarème tarifaire—Jetons de contexte, plus de200 000Jetons de contexte, jusqu’à la limite incluseSans borne supérieureCoût
Entrée · Jetons en entrée $0.004 / 1K jetons
Sortie · Jetons en sortie $0.018 / 1K jetons
Entrée · Lecture du cache — / 1K jetons
Entrée · Écriture dans le cache — / 1K jetons
Entrée · Écriture dans le cache, 1 h — / 1K jetons

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 · Traitement par lots

curl · jeu de données de test conservéPython HTTP · JSONL réel du clientPython · enregistrez chaque résultat finalisé
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.1-pro-preview:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['google/gemini-3.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-preview:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
    raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
    raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.

Recevoir et enregistrer les résultats

Ailoot Ultra · Traitement par lots

JSON results[].response.body intégré

  • GET /v1/batches/{operation_id}
Vérifier l’état de la tâche
curl · état de l’opération d’origine
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
Conserver tous les résultats terminés

Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.

Conservez l’intégralité du JSON de statut d’origine, chaque résultat/custom_id et le corps complet de la réponse ou de l’erreur. Enregistrez les results[] terminés au format JSONL sans filtrage.

Si la réponse d’origine doit être vérifiée

Conservez l’identifiant de l’opération d’origine. La réponse 503 result_pending_check contient X-Should-Retry:false ; ne soumettez jamais à nouveau un lot d’origine dont l’issue est inconnue.

Champs de la réponse
ChampType
Champresults[].custom_idTypestring
Champresults[].response.body.choices[].message.contentTypestring|null
Champresults[].errorTypeobject|null
ChampusageTypeobject|null
ChampidTypestring
ChampmodelTypestring
ChampendpointTypestring
ChampstatusTypestring
Champrequest_countsTypeobject
Champresults[].idTypestring
Champresults[].response.status_codeTypeinteger
Champresults[].response.request_idTypestring
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionEnveloppe intégrée documentée invalide, clés dupliquées, identité d’élément incorrecte ou conflit avec les capacités configurées du modèle.Étape suivanteCorrigez les champs indiqués avant toute nouvelle soumission.
Réponse401 · authentication_errorConditionClé API invalide.Étape suivanteUtilisez la clé Ailoot autorisée.
Réponse403 · permission_errorConditionGroupe de traitement par lots indisponible.Étape suivanteVérifiez les droits d’accès de la clé/du groupe.
Réponse422 · invalid_request_errorConditionLe traitement par lots est facturé sur le solde ; la création via un abonnement est refusée.Étape suivanteUtilisez le groupe autorisé dont la facturation est prélevée sur le solde.
Réponse422 · price_unavailableConditionImpossible d’établir un devis pour les données d’entrée du traitement par lots.Étape suivanteConservez la réponse ; utilisez les données d’entrée documentées pour cette famille.
Réponse402 · billing_errorConditionRéserve pour le traitement par lots indisponible.Étape suivanteRésolvez le problème d’admission avant d’envoyer une nouvelle requête.
Réponse503 · price_unavailableConditionPrix de la méthode Batch/tarifs natifs indisponibles.Étape suivanteConservez la réponse ; ne remplacez pas les prix par d’autres.
Réponse503 · api_errorConditionRoute exacte du fournisseur indisponible.Étape suivanteConservez la réponse pour réparer la route.
Réponse503 · result_pending_checkConditionLe résultat d’origine nécessite une vérification ; X-Should-Retry:false.Étape suivanteConservez l’operation_id/id d’origine et consultez son statut ; ne répétez jamais le POST d’origine.
Réponse404 · not_foundConditionOpération de suivi du traitement par lots absente ou appartenant à une autre identité.Étape suivanteUtilisez l’id exact d’origine avec le même utilisateur, la même clé et le même groupe.

Alias

Alias du modèle

Ailoot Ultra google/gemini-3.1-pro-preview:batch

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)
Quelles entrées et quels résultats sont disponibles ?

POST /v1/batches · google/gemini-3.1-pro-preview:batch: text → text

Quels champs la requête utilise-t-elle ?

POST /v1/batches · google/gemini-3.1-pro-preview:batch: endpoint, model, requests, completion_window, provider

Quelles limites s’appliquent ?

POST /v1/batches · google/gemini-3.1-pro-preview:batch: requests.min_items: 1

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence