gemini-3-pro-preview
Gemini 3 Pro Preview est le modèle de raisonnement multimodal de Google pour le texte, les images, l’audio, la vidéo et les PDF, avec une sortie textuelle. Sa grande capacité d’entrée, ses fonctions de programmation et les processus avec outils qu’il prend en charge conviennent à l’analyse détaillée, à la comparaison de documents et à l’exécution de tâches fondée sur des éléments probants.
- Ailoot Ultra · OpenAI Chat
POST /v1/chat/completionsgemini-3-pro-preview - Ailoot Ultra · Anthropic Messages
POST /v1/messagesgemini-3-pro-preview
À 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 Pro Preview est le profil de préversion nommé Gemini 3 Pro de Google pour le raisonnement multimodal et la génération de texte. Il peut traiter du texte, des images, de l’audio, de la vidéo et des documents PDF, puis renvoyer un résultat écrit. Les usages prévus comprennent l’analyse complexe, la programmation avancée, le développement d’algorithmes et les tâches qui combinent un ensemble substantiel de sources avec une question précise.
Modèle et structure des entrées
Gemini 3 Pro est un modèle à mélange parcimonieux d’experts fondé sur les transformeurs, avec prise en charge native des entrées multimodales. Son architecture achemine chaque jeton vers un sous-ensemble d’experts sélectionnés. Il s’agit d’une distinction de conception du modèle, et non d’une commande permettant à l’utilisateur de choisir un expert précis ou de fixer une configuration de service.
Préparez les entrées en fonction des renseignements nécessaires à la tâche. Un document, une capture d’écran et un enregistrement audio peuvent chacun apporter des éléments probants différents. Indiquez ce que contient chaque fichier et comment il doit contribuer à la réponse. La sortie demeure textuelle; comprendre du contenu visuel ou parlé ne fait pas de cette préversion un générateur d’images, de paroles ou de vidéos.
Analyse multimodale
Utilisez les images pour les questions sur le contenu visible, l’audio pour les renseignements parlés ou acoustiques et la vidéo pour une séquence dont les changements dans le temps comptent. Joignez le fichier réel à la question plutôt que de le décrire seulement de mémoire. Si vous comparez plusieurs fichiers, identifiez-les clairement pour que la réponse puisse citer la bonne source.
Par exemple, une consigne d’analyse de produit peut combiner un cahier des charges écrit, une capture d’écran de l’interface et une démonstration enregistrée. Demandez une comparaison qui distingue les promesses du cahier des charges de ce qui est visible ou audible dans le contenu fourni. Définissez le résultat souhaité sous forme de constats, d’observations à l’appui et de questions non résolues.
Pour une tâche sur un PDF, fournissez le document et désignez les sections ou les affirmations à examiner. Une question utile demande une comparaison, une extraction ou une explication liée à la source, plutôt qu’un simple résumé général d’un gros fichier.
Contexte long et capacité de sortie
Les spécifications exactes de la préversion indiquent une limite d’entrée de 1 048 576 jetons et une limite de sortie de 65 536 jetons. Le fabricant situe la limite des connaissances à janvier 2025; fournissez des éléments plus récents lorsque la question dépend d’événements ou de renseignements ultérieurs. Ces capacités sont distinctes. Un grand ensemble de sources peut être lu pour produire une réponse ciblée sans que le modèle doive reproduire chaque partie de l’entrée.
Organisez les longs contenus de manière à rendre leur structure claire : titres des documents, limites des sections, chemins de fichiers de code et question à laquelle la sortie doit répondre. Gardez les exceptions et les définitions pertinentes près du contenu qu’elles précisent. Si la tâche exige un long rapport, indiquez ses sections et les éléments probants attendus dans chacune.
Une grande fenêtre de contexte ne garantit ni une attention égale à tous les détails ni l’exactitude de chaque conclusion. Google signale aussi une dégradation possible au fil des conversations à plusieurs tours; vérifiez les faits importants des sources et le contexte réutilisé à mesure que l’échange avance. Confrontez la réponse aux passages ou aux fichiers précis qui appuient ses affirmations importantes.
Programmation et développement d’algorithmes
Les usages prévus par le fabricant comprennent la programmation avancée et le travail algorithmique. Fournissez le code pertinent, les hypothèses sur l’environnement, l’échec observé et le comportement attendu. Pour un algorithme, définissez l’entrée, la sortie souhaitée et les conditions, comme l’ordre, les doublons ou les données invalides.
Une bonne consigne de débogage associe l’entrée en échec et l’erreur à la plus petite portion de code pertinente. Demandez un diagnostic et une modification ciblée, puis vérifiez si la modification proposée corrige le comportement signalé. Du code généré et l’affirmation qu’il devrait fonctionner diffèrent d’une implémentation exécutée et vérifiée.
Pour une question portant sur un dépôt plus vaste, utilisez la capacité d’entrée pour fournir les fichiers nécessaires avec des chemins clairement indiqués. Précisez si le livrable attendu est une explication, une proposition de correctif ou une analyse d’options afin de donner au résultat un objectif concret.
Outils, sources et résultats structurés
Les spécifications du fabricant pour cette préversion prennent en charge les appels de fonctions, l’exécution de code, la recherche de fichiers, l’ancrage dans les résultats de recherche et le contexte d’URL. Ces fonctions ont des rôles distincts. Un appel de fonction décrit une opération à exécuter par une application; un résultat d’outil fournit ensuite des éléments probants pour l’étape suivante du modèle. L’exécution de code est un processus avec outil, et non une garantie que du code applicatif généré arbitrairement a déjà été testé.
L’ancrage dans les résultats de recherche et le contexte d’URL permettent des processus centrés sur les sources, tandis que la recherche de fichiers utilise une collection de fichiers préparée. Conservez les résultats des outils et leurs liens avec les sources dans la réponse pour permettre l’examen d’une conclusion. Selon ses spécifications, ce profil ne prend en charge ni l’utilisation d’un ordinateur ni l’ancrage dans Maps.
La prise en charge des sorties structurées permet d’exprimer un résultat selon un schéma défini. Précisez les champs et leur sens avant la génération, puis vérifiez aussi bien le contenu que le format. Un objet structuré valide exige encore une vérification factuelle et propre à la tâche.
Raisonnement, réutilisation et limites entre éditions
Cette préversion prend en charge la réflexion. Pour un travail qui exige plusieurs étapes de raisonnement, fournissez une tâche claire, des éléments probants pertinents et des contraintes explicites. Le résultat doit expliquer les hypothèses et la conclusion utile; un raisonnement caché ou l’existence d’un mode de réflexion ne constitue pas en soi une vérification.
Le fabricant indique aussi la prise en charge de la mise en cache et du traitement par lots. Ce sont des fonctions de traitement distinctes des capacités de contenu du modèle; leur présence ne prouve ni qu’une requête particulière a été mise en cache ni qu’un résultat de lot est exact.
Distinguez Gemini 3 Pro Preview de Gemini 3.1 Pro Preview, de Gemini 3 Pro Image et des profils audio ou Live. La sortie de cette préversion est textuelle, et ses spécifications ne comprennent pas la génération d’images, la génération audio ou le fonctionnement Live. Évaluez la réponse, le code ou le résultat structuré renvoyé à partir des sources fournies et de la tâche prévue.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions gemini-3-pro-preview
gemini-3-pro-previewPour commencer
Gemini 3 Pro Preview est le modèle de raisonnement multimodal de Google pour le texte, les images, l’audio, la vidéo et les PDF, avec une sortie textuelle. Sa grande capacité d’entrée, ses fonctions de programmation et les processus avec outils qu’il prend en charge conviennent à l’analyse détaillée, à la comparaison de documents et à l’exécution de tâches fondée sur des éléments probants.
- Entrées acceptées
- Texte
- Résultats
- Texte
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- Entrée
text- Sortie
text- Format de sortie
- json ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites gemini-3-pro-preview | Par défaut— |
Champmessages | Typemessage[] | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 | Par défaut— |
Champmessages[].role | Typestring | ExigenceObligatoire | Valeurs et limites Selon le modèle | Par défaut— |
Champmessages[].content | Typestring | ExigenceFacultatif | Valeurs et limites S’applique lorsque: Conversation textuelle | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
Combinaisons d’éléments d’entrée
Texte · Texte UTF8
messages[].content
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, messages |
Paramètrematerial_types | Contrattext |
Paramètremessages | ContratTableau de messages avec une structure role/content |
Paramètrefile_material | ContratDocument UTF-8 réel inséré comme texte littéral ; aucun ID de fichier déduit |
Paramètreoptional_controls | Contratstream |
Paramètrecontrol_scope | ContratConversation textuelle ; stream est un booléen dont la valeur par défaut est false. |
Paramètreoutput_modalities | Contrattext |
Paramètrehosted_operations | Contratfalse |
Paramètremultimodal_input_binding | Contratnull |
Alias de méthode : /chat/completions
Cycle de vie : synchronous_or_streamed
Envoyez l’ID exact du modèle avec messages.
La longueur du contexte n’est pas un plafond de sortie.
Un fichier texte peut fournir du texte littéral ; les entrées image/audio/objet fichier nécessitent une liaison exacte.
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
| Configuration | Barème tarifaire | Coût |
|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Coût Entrée · Jetons en entrée $0.004 / 1K jetons Sortie · Jetons en sortie $0.024 / 1K jetons Entrée · Lecture du cache $0 / 1K jetons Entrée · Écriture dans le cache $0 / 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 · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"gemini-3-pro-preview","messages":[{"role":"user","content":"hello"}],"stream":false}')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("choices",[]):
if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model="gemini-3-pro-preview", messages=[{"role":"user","content":"hello"}], stream=False)
import base64, json
from pathlib import Path
def save_result(data, stem="result"):
# Keep every field, including usage, IDs, reasoning and tool requests.
Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
def save_blob(encoded, suffix, label):
raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
file = Path(stem + "-" + label + "." + ext)
file.write_bytes(raw)
print("Saved", file)
for index, block in enumerate(data.get("content") or []):
print("Content", index, json.dumps(block, ensure_ascii=False))
for choice in data.get("choices") or []:
print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
for index, item in enumerate(data.get("output") or []):
print("Output", index, json.dumps(item, ensure_ascii=False))
if item.get("type") == "image_generation_call" and item.get("result"):
save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
for ci, candidate in enumerate(data.get("candidates") or []):
for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
blob = part.get("inlineData") or part.get("inline_data")
if blob and blob.get("data"):
mime = blob.get("mimeType") or blob.get("mime_type")
suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))
save_result(result.to_dict(mode="json"))
Recevoir et enregistrer les résultats
Ailoot Ultra · OpenAI Chat
json ou 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 choix avec son contenu, ses appels d’outils et son raisonnement. En SSE, assemblez les deltas par index de choix et d’outil, et conservez le motif final d’arrêt et les données d’utilisation.
Si la réponse d’origine doit être vérifiée
Conservez les ID et les en-têtes de requête/réponse. Aucune URL générique de récupération de tâche textuelle n’est fournie.
Champs de la réponse
| Champ | Type |
|---|---|
Champchoices[].index | Typeinteger |
Champchoices[].message.content | Typestring|null |
Champchoices[].message.tool_calls | Typetool_call[] |
Champchoices[].message.reasoning_content | Typestring |
Champchoices[].message.reasoning_details | Typeobject|array |
Champchoices[].finish_reason | Typestring|null |
Champusage | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des éléments fournis ou valeur de paramètre invalides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Alias
Alias du modèle
Ailoot Ultra gemini-3-pro-preview
Alias des chemins de méthode
/chat/completions
ID d’appel associés
Ailoot Ultra · Anthropic Messages POST /v1/messages gemini-3-pro-preview
gemini-3-pro-previewPour commencer
Gemini 3 Pro Preview est le modèle de raisonnement multimodal de Google pour le texte, les images, l’audio, la vidéo et les PDF, avec une sortie textuelle. Sa grande capacité d’entrée, ses fonctions de programmation et les processus avec outils qu’il prend en charge conviennent à l’analyse détaillée, à la comparaison de documents et à l’exécution de tâches fondée sur des éléments probants.
- Entrées acceptées
- Texte
- Résultats
- json · sse
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Anthropic Messages POST /v1/messages
- Entrée
text- Sortie
json,sse- Format de sortie
- JSON ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites gemini-3-pro-preview | Par défaut— |
Champmessages | Typemessage[] | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmessages[].role | Typestring | ExigenceObligatoire | Valeurs et limites user, assistant | Par défaut— |
Champmessages[].content | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmax_tokens | Typeinteger | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
Combinaisons d’éléments d’entrée
Texte · Texte UTF-8
Chaîne messages[].content
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, messages, max_tokens |
Paramètreoptional_controls | Contratstream |
Paramètrematerial_types | Contrattext |
Paramètretext_file_material | ContratLisez le document UTF-8 réel et placez son texte dans l’entrée indiquée ou dans la chaîne de contenu du message. |
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
- 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
| Configuration | Barème tarifaire | Coût |
|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Coût Entrée · Jetons en entrée $0.004 / 1K jetons Sortie · Jetons en sortie $0.024 / 1K jetons Entrée · Lecture du cache $0 / 1K jetons Entrée · Écriture dans le cache $0 / 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 · Anthropic Messages
{
"model": "gemini-3-pro-preview",
"max_tokens": 128,
"messages": [
{
"role": "user",
"content": "Summarize the incident report."
}
],
"stream": false
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path
source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
raise SystemExit('Choose a document containing text')
payload = {'model': 'gemini-3-pro-preview', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
-H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path
source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
raise SystemExit('Choose a document containing text')
payload = {'model': 'gemini-3-pro-preview', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
from urllib.request import Request, urlopen
from urllib.error import HTTPError
api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}
headers['x-api-key'] = api_key
request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
with urlopen(request, timeout=120) as response:
raw = response.read()
Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
Path('result.json').write_bytes(error.read())
Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path
result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
Recevoir et enregistrer les résultats
Ailoot Ultra · Anthropic Messages
JSON ou SSE
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez tous les blocs de contenu, les signatures de raisonnement et les ID réels d’utilisation d’outils. Assemblez tous les deltas de blocs SSE ; un premier bloc de texte ne constitue pas la sortie complète.
Si la réponse d’origine doit être vérifiée
Conservez les ID et les en-têtes de requête/réponse. Aucune URL générique de récupération de tâche textuelle n’est fournie.
Champs de la réponse
| Champ | Type |
|---|---|
Champid | Typestring |
Champmodel | Typestring |
Champcontent[] | Typetext|thinking|tool_use|other content block |
Champstop_reason | Typestring|null |
Champusage | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des éléments fournis ou valeur de paramètre invalides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Alias
Alias du modèle
Ailoot Ultra gemini-3-pro-preview
Alias des chemins de méthode
/chat/completions
ID d’appel associés
FAQ · gemini-3-pro-preview
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/chat/completions·gemini-3-pro-preview:text→textPOST /v1/messages·gemini-3-pro-preview:text→json,sse- Quels champs la requête utilise-t-elle ?
POST /v1/chat/completions·gemini-3-pro-preview:model,messages,streamPOST /v1/messages·gemini-3-pro-preview:model,messages,max_tokens,stream- Quelles limites s’appliquent ?
POST /v1/chat/completions·gemini-3-pro-preview:messages.min_items:1