Source: https://ailoot.ai/models/fr/gemini-2-5-pro/
Canonical: https://ailoot.ai/models/fr/gemini-2-5-pro/
Language: fr
# Google: Gemini 2.5 Pro
[Markdown](https://ailoot.ai/models/fr/gemini-2-5-pro/index.md) · [JSON](https://ailoot.ai/models/fr/gemini-2-5-pro/facts.json)
## [Google: Gemini 2.5 Pro](https://ailoot.ai/models/fr/gemini-2-5-pro/)
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
- [**Ailoot · Messages Anthropic** `POST /v1/messages` `gemini-2.5-pro`](https://ailoot.ai/models/fr/gemini-2-5-pro/#method-0)
- [**Ailoot · Gemini generateContent** `POST /v1beta/models/{model}:generateContent` `gemini-2.5-pro`](https://ailoot.ai/models/fr/gemini-2-5-pro/#method-1)
- [**Ailoot Ultra · Chat OpenAI** `POST /v1/chat/completions` `gemini-2.5-pro`](https://ailoot.ai/models/fr/gemini-2-5-pro/#method-2)
- [**Ailoot Ultra · Messages Anthropic** `POST /v1/messages` `gemini-2.5-pro`](https://ailoot.ai/models/fr/gemini-2-5-pro/#method-3)
- [**Ailoot Ultra · Chat OpenAI** `POST /v1/chat/completions` `google/gemini-2.5-pro`](https://ailoot.ai/models/fr/gemini-2-5-pro/#method-4)
- [**Ailoot Ultra · Messages Anthropic** `POST /v1/messages` `google/gemini-2.5-pro`](https://ailoot.ai/models/fr/gemini-2-5-pro/#method-5)
À 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 2.5 Pro est le profil de réflexion stable de Google pour la programmation avancée, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il peut comprendre du texte, de l’audio, des images, de la vidéo et des dépôts de code entiers ; son profil Gemini API accepte également les PDF en entrée. La sortie est du texte, notamment du code, une analyse écrite ou un enregistrement structuré. Une mission utile fournit les éléments probants et demande un résultat vérifiable, comme une solution expliquée, un constat sur une base de code ou une comparaison de plusieurs documents.
Pour la programmation, fournissez les fichiers concernés, le comportement observé et la modification ou la question pertinente. Un long contexte peut aider le modèle à relier les modules plutôt qu’à raisonner à partir d’un extrait isolé. Pour examiner un parcours dans le code, demandez-lui de suivre un identifiant depuis un formulaire de saisie jusqu’au traitement et au stockage, de repérer l’endroit où un contrat change et de proposer une correction ciblée. Conservez les contraintes et demandez des références à l’appui. Toute révision proposée doit être comparée au code réel et aux validations effectuées à l’aide des outils connectés.
Pour les mathématiques ou l’analyse scientifique, indiquez le problème, les hypothèses, les unités et la forme de réponse requise. Fournissez les données ou les figures dont dépend le calcul. Demandez le résultat étayé et les vérifications permettant de l’évaluer, comme les cas limites ou une comparaison avec les valeurs d’origine. La capacité de raisonnement du modèle ne supprime pas les ambiguïtés de l’énoncé. Laissez apparaître une quantité inconnue ou une hypothèse non étayée au lieu de la remplacer par une valeur commode.
La réflexion dynamique est le fonctionnement par défaut documenté. Le guide Gemini 2.5 GenerateContent permet de définir pour Pro un budget de raisonnement explicite de 128 à 32,768 tokens, ou -1 pour une réflexion adaptative. Cette édition ne permet pas de désactiver entièrement la réflexion. Ces réglages diffèrent de l’option de budget nul de Flash et des réglages de niveau de réflexion de Gemini 3. Le budget de réflexion guide le raisonnement sans garantir un nombre exact de tokens internes, et le plafond de réponse doit également laisser de la place au livrable final.
Pour un travail documentaire multimodal, précisez les pages, le graphique, la région d’image ou l’événement de l’enregistrement qui doivent étayer la réponse. Une tâche de synthèse pratique peut demander les affirmations concurrentes de plusieurs documents sources, les passages qui les étayent et les différences pertinentes pour une décision donnée. Demandez au modèle de distinguer un fait énoncé d’une déduction. Pour la vidéo ou l’audio, définissez si le résultat doit être une description, une transcription, un résumé ou une comparaison. Dans ce profil, l’image et le son servent de preuves pour un résultat textuel.
La page de cette API précise documente l’appel de fonctions, l’exécution de code, la recherche de fichiers, l’ancrage dans la recherche, l’ancrage dans Maps, le contexte d’URL et les sorties structurées. Définissez la finalité des fonctions et les champs de paramètres, et conservez leurs résultats réels lors des échanges suivants. Pour un enregistrement soumis à un schéma, précisez les champs requis et la représentation des informations manquantes. L’architecture native est un transformer multimodal à mélange parcimonieux d’experts ; cette conception du modèle ne fournit pas, à elle seule, l’exécution d’un outil externe ou une application achevée au-delà du texte ou du code renvoyé.
La fiche native indique un contexte d’entrée de 1M et une sortie textuelle de 64K ; le tableau de l’API précise 1,048,576 tokens en entrée et 65,536 tokens en sortie. Les instructions, le contenu source et l’historique conservé contribuent à la préparation de l’entrée. L’allocation maximale de réponse inclut les tokens de raisonnement ; un plafond trop bas peut donc interrompre la réponse finale. La mise en cache et le traitement par lots sont documentés, ainsi que les options Flex et Priority. Conservez l’identifiant de chaque source et la forme finale demandée lorsque vous préparez des tâches indépendantes à long contexte.
L’identifiant stable est distinct des éditions Experimental et Preview présentées séparément dans la fiche partagée du modèle Pro. N’attribuez pas à ce profil leurs résultats propres à une version simplement parce qu’elles portent aussi le nom Pro. La fiche signale des hallucinations possibles et des limites dans la compréhension causale, les déductions complexes et le raisonnement contrefactuel, avec une date limite des connaissances en janvier 2025. Fournissez des éléments actuels lorsque cela compte et examinez les références aux sources, les calculs et les modifications proposées. La sortie utile est le livrable textuel ou le code étayé demandé par la tâche.
Cas pratique
### Cas pratique
Exemple technique en anglais
```
Trace an identifier through storage
Trace this identifier through three excerpts: form sends {customer_id:'0017'}; service computes id=Number(body.customer_id); repository stores String(id). Requirement: preserve leading zeros. Identify where the contract changes, propose a minimal consistent correction and give tests for '0017', '17' and a missing ID. Do not claim the tests were executed.
```
#### Résultat attendu
```
A source-path explanation, a proposed patch and a three-case regression-test plan.
```
#### Vérifier le résultat
```
Check that the proposed path preserves distinct strings 0017 and 17 while specifying missing-ID behavior.
```
**Ailoot · Messages Anthropic** `POST /v1/messages` `gemini-2.5-pro`
[`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages)
Google /`gemini-2.5-pro`
### Premiers pas
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
Entrées acceptées
Texte · Images
Résultats
Texte
### Disponible dans Ailoot · entrées et méthodes
**Ailoot · Messages Anthropic** `POST /v1/messages`
Types d’entrée
`text`, `image`
Types de sortie
`text`
Contexte
1 048 576 tokens
Sortie maximale
65 536 tokens
Format de sortie
json ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites gemini-2.5-pro | Par défaut— |
| Champ`messages` | Type`message[]` | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 | Par défaut— |
| Champ`messages[].role` | Type`string` | ExigenceObligatoire | Valeurs et limites user, assistant | Par défaut— |
| Champ`messages[].content` | Type`string\|content_block[]` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`system` | Type`string\|content_block[]` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`max_tokens` | Type`integer` | ExigenceObligatoire | Valeurs et limites Minimum: 1 La limite s’applique à: plafond exact du modèle ou de la fiche sélectionnés | Par défaut— |
| Champ`stream` | Type`boolean` | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
| Champ`temperature` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`top_p` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`stop_sequences` | Type`string[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`tools` | Type`tool[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`tools[].name` | Type`string` | ExigenceFacultatif | Valeurs et limites S’applique lorsque: outil fourni | Par défaut— |
| Champ`tools[].description` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`tools[].input_schema` | Type`JSON_schema` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`tool_choice` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`thinking.type` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`thinking.budget_tokens` | Type`integer` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`output_config.effort` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`metadata` | Type`object` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`cache_control` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
Combinaisons d’éléments d’entrée
**Texte** · Texte UTF8
`messages[].content ou bloc type=text`
**Texte + image**
`{type:image,source:{type:base64,media_type,data}} ou source type=url`
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
| --- | --- |
| Paramètre`material_types` | Contrattext, image |
| Paramètre`required` | Contratmodel, messages, max\_tokens |
| Paramètre`optional_controls` | Contratnull |
| Paramètre`content_type` | Contratapplication/json |
| Paramètre`text_file_material` | Contratcontenu UTF-8 réel inséré sous forme de texte ; les identifiants de fichiers et les URLs nécessitent une prise en charge exacte distincte |
Cycle de vie : `exact retained published method`
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
### Tarifs
#### Tarifs des méthodes Ailoot
Entrée
0,00125 USD */ 1K*
Sortie
0,01 USD */ 1K*
Lecture du cache
0,000125 USD */ 1K*
#### Prix selon la longueur de la requête · Messages Anthropic
| Taille de la requête, en tokens | Entrée | Sortie | Lecture du cache | Écriture dans le cache | Cache 5 min | Cache 1 h |
| --- | --- | --- | --- | --- | --- | --- |
| Taille de la requête, en tokens(0; 200 000\] | Entrée0,00125 USD | Sortie0,01 USD | Lecture du cache0,000125 USD | Écriture dans le cacheTarif de base : — | Cache 5 minTarif de base : — | Cache 1 hTarif de base : — |
| Taille de la requête, en tokens(200 000; ∞) | Entrée0,0025 USD | Sortie0,015 USD | Lecture du cache0,00025 USD | Écriture dans le cacheTarif de base : — | Cache 5 minTarif de base : — | Cache 1 hTarif de base : — |
Tarifs en USD par 1K tokens. Si aucun tarif n’est défini, le tarif de base de cette méthode est hérité ; «—» signifie qu’aucun tarif de base n’est défini.
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 →](https://ailoot.ai/docs/fr/billing/reserve/)
#### Détails du tarif de référence
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
Barèmes de référence du modèle
#### Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
| --- | --- | --- | --- | --- |
| ConfigurationOpenAI Chat · Tarifs de base par token | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationOpenAI Chat · Palier 1 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationOpenAI Chat · Palier 2 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationAnthropic Messages · Tarifs de base par token | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationAnthropic Messages · Palier 1 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationAnthropic Messages · Palier 2 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
### Exemples de requêtes
#### Ailoot · Messages Anthropic
Exemple de texteEntrée, imagePython SDKNode.js SDKStreaming Python
```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 source-material file}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "gemini-2.5-pro", "max_tokens": 1024, "messages": []}')
f=Path(os.environ["AILOOT_TEXT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")
text=f.read_text(encoding="utf-8")
if not text.strip():raise SystemExit("Source material must contain text")
p["messages"]=[{"role":"user","content":"Summarize this material and quote supporting source passages.\n\n"+text}]
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/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
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```
```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_FILE:?Set your actual PNG JPEG or WebP image}"
export AILOOT_IMAGE_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "gemini-2.5-pro", "max_tokens": 1024, "messages": [{"role": "user", "content": [{"type": "text", "text": "Read labels and numbers in this image; flag unreadable text."}]}]}')
import base64
f=Path(os.environ["AILOOT_IMAGE_FILE"])
if not f.is_file():raise SystemExit("Choose an actual PNG JPEG or WebP image")
raw=f.read_bytes()
mime="image/png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "image/jpeg" if raw.startswith(b"\xff\xd8") else "image/webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else None
if not mime:raise SystemExit("Use PNG JPEG or WebP")
b64=base64.b64encode(raw).decode()
p["messages"][0]["content"].append({"type":"image","source":{"type":"base64","media_type":mime,"data":b64}})
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/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
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```
```python
import anthropic
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client = anthropic.Anthropic(base_url="https://api.ailoot.ai", api_key=os.environ["AILOOT_API_KEY"], max_retries=0)
msg = client.messages.create(
model="gemini-2.5-pro",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}],
)
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(msg.to_dict(mode="json"))
```
```js
import Anthropic from "@anthropic-ai/sdk";
if (!process.env.AILOOT_API_KEY?.trim()) throw new Error("Set AILOOT_API_KEY before making a request");
const client = new Anthropic({ baseURL: "https://api.ailoot.ai", apiKey: process.env.AILOOT_API_KEY, maxRetries: 0 });
const msg = await client.messages.create({
model: "gemini-2.5-pro",
max_tokens: 1024,
messages: [{ role: "user", content: "Explain the difference between an observation and a hypothesis in three sentences." }],
});
import { writeFileSync } from "node:fs";
function saveResult(data, stem = "result") {
writeFileSync(stem + ".json", JSON.stringify(data, null, 2));
console.log(JSON.stringify(data, null, 2));
const saveBlob = (encoded, suffix, label) => {
const raw = Buffer.from(encoded, "base64");
const ext = raw.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])) ? "png" : raw[0]===255 && raw[1]===216 ? "jpg" : raw.subarray(0,4).toString()==="RIFF" && raw.subarray(8,12).toString()==="WEBP" ? "webp" : suffix;
const file = `${stem}-${label}.${ext}`;
writeFileSync(file, raw); console.log("Saved", file);
};
for (const [i, block] of (data.content || []).entries()) console.log("Content", i, JSON.stringify(block));
for (const choice of data.choices || []) console.log("Choice", choice.index, JSON.stringify(choice.message || choice.delta || {}));
for (const [i, item] of (data.output || []).entries()) {
console.log("Output", i, JSON.stringify(item));
if (item.type === "image_generation_call" && item.result) saveBlob(item.result, item.output_format || "bin", `output-${i}`);
}
for (const [ci, candidate] of (data.candidates || []).entries()) {
for (const [pi, part] of (candidate.content?.parts || []).entries()) {
console.log("Candidate/part", ci, pi, JSON.stringify(part));
const blob = part.inlineData || part.inline_data;
if (blob?.data) {
const mime = blob.mimeType || blob.mime_type;
const suffix = ({"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"})[mime] || "bin";
saveBlob(blob.data, suffix, `candidate-${ci}-part-${pi}`);
}
}
}
}
saveResult(msg);
```
```python
import anthropic,os
from pathlib import Path
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=anthropic.Anthropic(base_url="https://api.ailoot.ai",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
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))
with client.messages.stream(model='gemini-2.5-pro',max_tokens=1024,messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:
with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:
for event in stream:
payload=event.to_dict(mode="json")
log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush()
print(json.dumps(payload,ensure_ascii=False))
final=stream.get_final_message()
save_result(final.to_dict(mode="json"),"stream-result")
```
### Recevoir et enregistrer les résultats
#### Ailoot · Messages Anthropic
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 identifiants 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 identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
Champs de la réponse
| Champ | Type |
| --- | --- |
| Champ`id` | Typestring |
| Champ`model` | Typestring |
| Champ`content[]` | Typetext\|thinking\|tool\_use\|other content block |
| Champ`stop_reason` | Typestring\|null |
| Champ`usage` | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse400 · `invalid_request_error` | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
### Alias
#### Alias du modèle
Ailoot [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages)
**Ailoot Ultra** [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages), [`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages)
#### Alias des chemins de méthode
`/chat/completions`
#### ID d’appel associés
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages)
**Ailoot · Gemini generateContent** `POST /v1beta/models/{model}:generateContent` `gemini-2.5-pro`
[`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=gemini)
Google /`gemini-2.5-pro`
### Premiers pas
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
Entrées acceptées
Texte · Images
Résultats
Texte
### Disponible dans Ailoot · entrées et méthodes
**Ailoot · Gemini generateContent** `POST /v1beta/models/{model}:generateContent`
Types d’entrée
`text`, `image`
Types de sortie
`text`
Contexte
1 048 576 tokens
Sortie maximale
65 536 tokens
Format de sortie
json ou streaming pris en charge
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`path.model` | Type`string` | ExigenceObligatoire | Valeurs et limites gemini-2.5-pro | Par défaut— |
| Champ`contents` | Type`content[]` | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 | Par défaut— |
| Champ`contents[].role` | Type`string` | ExigenceFacultatif | Valeurs et limites user, model | Par défaut— |
| Champ`contents[].parts` | Type`part[]` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`systemInstruction` | Type`content` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`generationConfig.maxOutputTokens` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Selon le modèle | Par défaut— |
| Champ`generationConfig.temperature` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`generationConfig.topP` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`generationConfig.topK` | Type`integer` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`generationConfig.stopSequences` | Type`string[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`generationConfig.thinkingConfig.includeThoughts` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`generationConfig.thinkingConfig.thinkingBudget` | Type`integer` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`tools[].functionDeclarations` | Type`function_declaration[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`toolConfig.functionCallingConfig.mode` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`safetySettings` | Type`object[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`sessionId` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Combinaisons d’éléments d’entrée
**Texte** · Texte UTF8
`contents[].parts[].text`
**Texte + image**
`parts[].inlineData={mimeType,data}`
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
| --- | --- |
| Paramètre`material_types` | Contrattext, image |
| Paramètre`required` | Contratcontents |
| Paramètre`optional_controls` | Contratnull |
| Paramètre`content_type` | Contratapplication/json |
| Paramètre`text_file_material` | Contratcontenu UTF-8 réel inséré sous forme de texte ; les identifiants de fichiers et les URLs nécessitent une prise en charge exacte distincte |
Cycle de vie : `exact retained published method`
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
### Tarifs
#### Tarifs des méthodes Ailoot
Entrée
0,00125 USD */ 1K*
Sortie
0,01 USD */ 1K*
Lecture du cache
0,000125 USD */ 1K*
#### Prix selon la longueur de la requête · Gemini generateContent
| Taille de la requête, en tokens | Entrée | Sortie | Lecture du cache | Écriture dans le cache | Cache 5 min | Cache 1 h |
| --- | --- | --- | --- | --- | --- | --- |
| Taille de la requête, en tokens(0; 200 000\] | Entrée0,00125 USD | Sortie0,01 USD | Lecture du cache0,000125 USD | Écriture dans le cacheTarif de base : — | Cache 5 minTarif de base : — | Cache 1 hTarif de base : — |
| Taille de la requête, en tokens(200 000; ∞) | Entrée0,0025 USD | Sortie0,015 USD | Lecture du cache0,00025 USD | Écriture dans le cacheTarif de base : — | Cache 5 minTarif de base : — | Cache 1 hTarif de base : — |
Tarifs en USD par 1K tokens. Si aucun tarif n’est défini, le tarif de base de cette méthode est hérité ; «—» signifie qu’aucun tarif de base n’est défini.
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 →](https://ailoot.ai/docs/fr/billing/reserve/)
#### Détails du tarif de référence
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
Barèmes de référence du modèle
#### Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
| --- | --- | --- | --- | --- |
| ConfigurationOpenAI Chat · Tarifs de base par token | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationOpenAI Chat · Palier 1 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationOpenAI Chat · Palier 2 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationAnthropic Messages · Tarifs de base par token | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationAnthropic Messages · Palier 1 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationAnthropic Messages · Palier 2 selon la longueur de la requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
### Exemples de requêtes
#### Ailoot · Gemini generateContent
Exemple de texteEntrée, imagePython SDKNode.js SDKStreaming Python
```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 source-material file}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"contents": []}')
f=Path(os.environ["AILOOT_TEXT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")
text=f.read_text(encoding="utf-8")
if not text.strip():raise SystemExit("Source material must contain text")
p["contents"]=[{"role":"user","parts":[{"text":"Summarize this material and quote supporting source passages.\n\n"+text}]}]
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1beta/models/gemini-2.5-pro:generateContent \
-H "x-goog-api-key: $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
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(json.loads(Path("result.json").read_text(encoding="utf-8")))
PY_RESULT
```
```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_FILE:?Set your actual PNG JPEG or WebP image}"
export AILOOT_IMAGE_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"contents": [{"role": "user", "parts": [{"text": "Read labels and numbers in this image; flag unreadable text."}]}]}')
import base64
f=Path(os.environ["AILOOT_IMAGE_FILE"])
if not f.is_file():raise SystemExit("Choose an actual PNG JPEG or WebP image")
raw=f.read_bytes()
mime="image/png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "image/jpeg" if raw.startswith(b"\xff\xd8") else "image/webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else None
if not mime:raise SystemExit("Use PNG JPEG or WebP")
b64=base64.b64encode(raw).decode()
p["contents"][0]["parts"].append({"inlineData":{"mimeType":mime,"data":b64}})
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1beta/models/gemini-2.5-pro:generateContent \
-H "x-goog-api-key: $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
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(json.loads(Path("result.json").read_text(encoding="utf-8")))
PY_RESULT
```
```python
from google import genai
from google.genai import types
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client = genai.Client(
api_key=os.environ["AILOOT_API_KEY"],
http_options=types.HttpOptions(base_url="https://api.ailoot.ai"),
)
resp = client.models.generate_content(model="gemini-2.5-pro", contents="Explain the difference between an observation and a hypothesis in three sentences.")
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(resp.to_json_dict())
```
```js
import { GoogleGenAI } from "@google/genai";
if (!process.env.AILOOT_API_KEY?.trim()) throw new Error("Set AILOOT_API_KEY before making a request");
const ai = new GoogleGenAI({ apiKey: process.env.AILOOT_API_KEY, httpOptions: { baseUrl: "https://api.ailoot.ai" } });
const resp = await ai.models.generateContent({ model: "gemini-2.5-pro", contents: "Explain the difference between an observation and a hypothesis in three sentences." });
import { writeFileSync } from "node:fs";
function saveResult(data, stem = "result") {
writeFileSync(stem + ".json", JSON.stringify(data, null, 2));
console.log(JSON.stringify(data, null, 2));
const saveBlob = (encoded, suffix, label) => {
const raw = Buffer.from(encoded, "base64");
const ext = raw.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])) ? "png" : raw[0]===255 && raw[1]===216 ? "jpg" : raw.subarray(0,4).toString()==="RIFF" && raw.subarray(8,12).toString()==="WEBP" ? "webp" : suffix;
const file = `${stem}-${label}.${ext}`;
writeFileSync(file, raw); console.log("Saved", file);
};
for (const [i, block] of (data.content || []).entries()) console.log("Content", i, JSON.stringify(block));
for (const choice of data.choices || []) console.log("Choice", choice.index, JSON.stringify(choice.message || choice.delta || {}));
for (const [i, item] of (data.output || []).entries()) {
console.log("Output", i, JSON.stringify(item));
if (item.type === "image_generation_call" && item.result) saveBlob(item.result, item.output_format || "bin", `output-${i}`);
}
for (const [ci, candidate] of (data.candidates || []).entries()) {
for (const [pi, part] of (candidate.content?.parts || []).entries()) {
console.log("Candidate/part", ci, pi, JSON.stringify(part));
const blob = part.inlineData || part.inline_data;
if (blob?.data) {
const mime = blob.mimeType || blob.mime_type;
const suffix = ({"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"})[mime] || "bin";
saveBlob(blob.data, suffix, `candidate-${ci}-part-${pi}`);
}
}
}
}
saveResult(resp);
```
```python
from google import genai
from google.genai import types
import os
from pathlib import Path
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=genai.Client(api_key=os.environ["AILOOT_API_KEY"],http_options=types.HttpOptions(base_url="https://api.ailoot.ai"))
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))
count=0
with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:
for chunk in client.models.generate_content_stream(model='gemini-2.5-pro',contents="Explain observations and hypotheses in three sentences."):
payload=chunk.to_json_dict()
log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush()
save_result(payload,"stream-chunk-"+str(count))
count+=1
```
### Recevoir et enregistrer les résultats
#### Ailoot · Gemini generateContent
json ou streaming pris en charge
##### 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 candidats et toutes les parties, y compris les appels de fonctions, les signatures de raisonnement et les données d’utilisation ; assemblez les fragments du flux dans l’ordre.
##### Si la réponse d’origine doit être vérifiée
Conservez les identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
Champs de la réponse
| Champ | Type |
| --- | --- |
| Champ`responseId` | Typestring |
| Champ`modelVersion` | Typestring |
| Champ`candidates[].content.parts[]` | Typetext\|inlineData\|functionCall\|other part |
| Champ`candidates[].finishReason` | Typestring |
| Champ`usageMetadata` | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse400 · `invalid_request_error` | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
### Alias
#### Alias du modèle
Ailoot [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=gemini)
**Ailoot Ultra** [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro), [`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro)
#### Alias des chemins de méthode
`/chat/completions`
#### ID d’appel associés
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=gemini), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro)
**Ailoot Ultra · Chat OpenAI** `POST /v1/chat/completions` `gemini-2.5-pro`
[`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=chat)
Google /`gemini-2.5-pro`
ID du modèle
- `gemini-2.5-pro`
- `google/gemini-2.5-pro`
### Premiers pas
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
Entrées acceptées
Texte
Résultats
Texte
### Disponible dans Ailoot · entrées et méthodes
**Ailoot Ultra · Chat OpenAI** `POST /v1/chat/completions`
Types d’entrée
`text`
Types de sortie
`text`
Format de sortie
json ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites gemini-2.5-pro | Par défaut— |
| Champ`messages` | Type`message[]` | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 | Par défaut— |
| Champ`messages[].role` | Type`string` | ExigenceObligatoire | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`messages[].content` | Type`string` | ExigenceFacultatif | Valeurs et limites S’applique lorsque: Conversation textuelle | Par défaut— |
| Champ`stream` | Type`boolean` | 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ètre`content_type` | Contratapplication/json |
| Paramètre`required` | Contratmodel, messages |
| Paramètre`material_types` | Contrattext |
| Paramètre`messages` | Contrattableau de messages avec une structure role/content |
| Paramètre`file_material` | Contratdocument UTF-8 réel inséré sous forme de texte littéral ; aucun identifiant de fichier déduit |
| Paramètre`optional_controls` | Contratstream |
| Paramètre`control_scope` | ContratConversation textuelle ; stream est un booléen dont la valeur par défaut est false. |
| Paramètre`output_modalities` | Contrattext |
| Paramètre`hosted_operations` | Contratfalse |
| Paramètre`multimodal_input_binding` | Contratnull |
Alias de méthode : `/chat/completions`
Cycle de vie : `synchronous_or_streamed`
Envoyez l’identifiant 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/objets 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
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é
Sortie de raisonnement
Le raisonnement utilise le tarif du sous-ensemble indiqué dans le total de sortie ; ne comptez pas ces tokens deux fois. Lorsque la sortie comprend des tokens de raisonnement
#### Tarifs Ailoot
#### Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
| --- | --- | --- | --- | --- |
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationPalier 2 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 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 →](https://ailoot.ai/docs/fr/billing/reserve/)
### Exemples de requêtes
#### Ailoot Ultra · Chat OpenAI
curlPython SDK
```bash
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-2.5-pro","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
```
```python
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-2.5-pro", 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 · Chat OpenAI
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, puis conservez le motif final de terminaison et les données d’utilisation.
##### Si la réponse d’origine doit être vérifiée
Conservez les identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
Champs de la réponse
| Champ | Type |
| --- | --- |
| Champ`choices[].index` | Typeinteger |
| Champ`choices[].message.content` | Typestring\|null |
| Champ`choices[].message.tool_calls` | Typetool\_call\[\] |
| Champ`choices[].message.reasoning_content` | Typestring |
| Champ`choices[].message.reasoning_details` | Typeobject\|array |
| Champ`choices[].finish_reason` | Typestring\|null |
| Champ`usage` | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse400 · `invalid_request_error` | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
### Alias
#### Alias du modèle
Ailoot [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro)
**Ailoot Ultra** [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=chat), [`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=chat)
#### Alias des chemins de méthode
`/chat/completions`
#### ID d’appel associés
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=chat), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=chat)
**Ailoot Ultra · Messages Anthropic** `POST /v1/messages` `gemini-2.5-pro`
[`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages)
Google /`gemini-2.5-pro`
ID du modèle
- `gemini-2.5-pro`
- `google/gemini-2.5-pro`
### Premiers pas
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
Entrées acceptées
Texte
Résultats
json · sse
### Disponible dans Ailoot · entrées et méthodes
**Ailoot Ultra · Messages Anthropic** `POST /v1/messages`
Types d’entrée
`text`
Types de sortie
`json`, `sse`
Format de sortie
JSON ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites gemini-2.5-pro | Par défaut— |
| Champ`messages` | Type`message[]` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`messages[].role` | Type`string` | ExigenceObligatoire | Valeurs et limites user, assistant | Par défaut— |
| Champ`messages[].content` | Type`string` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`max_tokens` | Type`integer` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`stream` | Type`boolean` | 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ètre`content_type` | Contratapplication/json |
| Paramètre`required` | Contratmodel, messages, max\_tokens |
| Paramètre`optional_controls` | Contratstream |
| Paramètre`material_types` | Contrattext |
| Paramètre`text_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
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é
Sortie de raisonnement
Le raisonnement utilise le tarif du sous-ensemble indiqué dans le total de sortie ; ne comptez pas ces tokens deux fois. Lorsque la sortie comprend des tokens de raisonnement
#### Tarifs Ailoot
#### Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
| --- | --- | --- | --- | --- |
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationPalier 2 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 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 →](https://ailoot.ai/docs/fr/billing/reserve/)
### Exemples de requêtes
#### Ailoot Ultra · Messages Anthropic
Corps JSON minimal completcurl · utilisez votre document UTF-8Python · enregistrez le résultat complet
```json
{
"model": "gemini-2.5-pro",
"max_tokens": 128,
"messages": [
{
"role": "user",
"content": "Summarize the incident report."
}
],
"stream": false
}
```
```bash
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-2.5-pro', '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
```
```python
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-2.5-pro', '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 · Messages Anthropic
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 identifiants 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 identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
Champs de la réponse
| Champ | Type |
| --- | --- |
| Champ`id` | Typestring |
| Champ`model` | Typestring |
| Champ`content[]` | Typetext\|thinking\|tool\_use\|other content block |
| Champ`stop_reason` | Typestring\|null |
| Champ`usage` | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse400 · `invalid_request_error` | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
### Alias
#### Alias du modèle
Ailoot [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages)
**Ailoot Ultra** [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages), [`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages)
#### Alias des chemins de méthode
`/chat/completions`
#### ID d’appel associés
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages)
**Ailoot Ultra · Chat OpenAI** `POST /v1/chat/completions` `google/gemini-2.5-pro`
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=chat)
Google /`google/gemini-2.5-pro`
ID du modèle
- `gemini-2.5-pro`
- `google/gemini-2.5-pro`
### Premiers pas
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
Entrées acceptées
Texte
Résultats
Texte
### Disponible dans Ailoot · entrées et méthodes
**Ailoot Ultra · Chat OpenAI** `POST /v1/chat/completions`
Types d’entrée
`text`
Types de sortie
`text`
Format de sortie
json ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites google/gemini-2.5-pro | Par défaut— |
| Champ`messages` | Type`message[]` | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 | Par défaut— |
| Champ`messages[].role` | Type`string` | ExigenceObligatoire | Valeurs et limites Exemples : system, user, assistant, tool, function Conditions: Ces rôles sont explicitement représentés par les types de compatibilité du code source ; l’ensemble exact des rôles reste propre à chaque modèle. Selon le modèle | Par défaut— |
| Champ`messages[].content` | Type`string\|content_part[]\|null` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`messages[].tool_calls` | Type`tool_call[]` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`messages[].tool_call_id` | Type`string` | ExigenceFacultatif | Valeurs et limites S’applique lorsque: role=tool ; utilisez l’identifiant réellement renvoyé | Par défaut— |
| Champ`messages[].name` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`messages[].reasoning_content` | Type`string` | ExigenceFacultatif | Valeurs et limites S’applique lorsque: Réinjectez le raisonnement réellement renvoyé lorsque ce modèle l’utilise | Par défaut— |
| Champ`messages[].reasoning_details` | Type`object\|array` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`max_tokens` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Selon le modèle | Par défaut— |
| Champ`max_completion_tokens` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: 1 Selon le modèle | Par défaut— |
| Champ`stream` | Type`boolean` | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
| Champ`stream_options.include_usage` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`temperature` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`top_p` | Type`number` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`stop` | Type`string\|string[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`tools` | Type`function_tool[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`tools[].type` | Type`string` | ExigenceFacultatif | Valeurs et limites function Selon le modèle | Par défaut— |
| Champ`tools[].function.name` | Type`string` | ExigenceObligatoire | Valeurs et limites S’applique lorsque: outil de fonction fourni | Par défaut— |
| Champ`tools[].function.description` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`tools[].function.parameters` | Type`JSON_schema` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`tool_choice` | Type`string\|object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`parallel_tool_calls` | Type`boolean` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`response_format` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`reasoning_effort` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`reasoning` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`service_tier` | Type`string` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`instructions` | Type`string` | ExigenceFacultatif | Valeurs et limites Champ de compatibilité | Par défaut— |
| Champ`functions` | Type`function[]` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`function_call` | Type`string\|object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`prompt_cache_options` | Type`object` | ExigenceFacultatif | Valeurs et limites Selon le modèle | Par défaut— |
| Champ`modalities` | Type`string[]` | ExigenceFacultatif | Valeurs et limites text | Par défaut— |
| Champ`provider` | Type`object` | ExigenceFacultatif | Valeurs et limites Conditions: provider.options est rejeté sur cette route textuelle Ultra | Par défaut— |
| Champ`cache_control.ttl` | Type`string` | ExigenceFacultatif | Valeurs et limites Conditions: 1h est rejeté dans les emplacements réels du cache de prompt | Par défaut— |
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ètre`content_type` | Contratapplication/json |
| Paramètre`required` | Contratmodel, messages |
| Paramètre`material_types` | Contrattext |
| Paramètre`messages` | Contrattableau de messages avec une structure role/content |
| Paramètre`file_material` | Contratdocument UTF-8 réel inséré sous forme de texte littéral ; aucun identifiant de fichier déduit |
| Paramètre`optional_controls` | Contratstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice |
| Paramètre`control_scope` | Contratpropre au modèle ; les outils de fonctions de l’utilisateur diffèrent des outils hébergés |
| Paramètre`output_modalities` | Contrattext |
| Paramètre`hosted_operations` | Contratfalse |
| Paramètre`multimodal_input_binding` | Contratnull |
Cycle de vie : `synchronous_or_streamed`
Envoyez l’identifiant 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/objets 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
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é
Sortie de raisonnement
Le raisonnement utilise le tarif du sous-ensemble indiqué dans le total de sortie ; ne comptez pas ces tokens deux fois. Lorsque la sortie comprend des tokens de raisonnement
#### Tarifs Ailoot
#### Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
| --- | --- | --- | --- | --- |
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationPalier 2 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 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 →](https://ailoot.ai/docs/fr/billing/reserve/)
### Exemples de requêtes
#### Ailoot Ultra · Chat OpenAI
curlPython SDKStreaming Python
```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/gemini-2.5-pro", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')
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
```
```python
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='google/gemini-2.5-pro',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])
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"))
```
```python
from openai import OpenAI
import os
from pathlib import Path
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)
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))
with client.chat.completions.stream(model='google/gemini-2.5-pro',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:
with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:
for event in stream:
payload=event.to_dict(mode="json")
log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush()
print(json.dumps(payload,ensure_ascii=False))
final=stream.get_final_completion()
save_result(final.to_dict(mode="json"),"stream-result")
```
### Recevoir et enregistrer les résultats
#### Ailoot Ultra · Chat OpenAI
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, puis conservez le motif final de terminaison et les données d’utilisation.
##### Si la réponse d’origine doit être vérifiée
Conservez les identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
Champs de la réponse
| Champ | Type |
| --- | --- |
| Champ`choices[].index` | Typeinteger |
| Champ`choices[].message.content` | Typestring\|null |
| Champ`choices[].message.tool_calls` | Typetool\_call\[\] |
| Champ`choices[].message.reasoning_content` | Typestring |
| Champ`choices[].message.reasoning_details` | Typeobject\|array |
| Champ`choices[].finish_reason` | Typestring\|null |
| Champ`usage` | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse400 · `invalid_request_error` | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
### Alias
#### Alias du modèle
Ailoot [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro)
**Ailoot Ultra** [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=chat), [`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=chat)
#### Alias des chemins de méthode
`/chat/completions`
#### ID d’appel associés
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=chat), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=chat)
**Ailoot Ultra · Messages Anthropic** `POST /v1/messages` `google/gemini-2.5-pro`
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages)
Google /`google/gemini-2.5-pro`
ID du modèle
- `gemini-2.5-pro`
- `google/gemini-2.5-pro`
### Premiers pas
Gemini 2.5 Pro est le modèle de réflexion stable de Google pour le code complexe, les mathématiques, les disciplines STEM et l’analyse de longs contextes. Il accepte du texte, des images, de l’audio, de la vidéo et des PDF, et renvoie du texte, avec des outils et des sorties structurées. Son budget de raisonnement dynamique prend en charge 128–32,768 tokens et ne peut pas être entièrement désactivé.
Entrées acceptées
Texte
Résultats
json · sse
### Disponible dans Ailoot · entrées et méthodes
**Ailoot Ultra · Messages Anthropic** `POST /v1/messages`
Types d’entrée
`text`
Types de sortie
`json`, `sse`
Format de sortie
JSON ou SSE
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites google/gemini-2.5-pro | Par défaut— |
| Champ`messages` | Type`message[]` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`messages[].role` | Type`string` | ExigenceObligatoire | Valeurs et limites user, assistant | Par défaut— |
| Champ`messages[].content` | Type`string` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`max_tokens` | Type`integer` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`stream` | Type`boolean` | 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ètre`content_type` | Contratapplication/json |
| Paramètre`required` | Contratmodel, messages, max\_tokens |
| Paramètre`optional_controls` | Contratstream |
| Paramètre`material_types` | Contrattext |
| Paramètre`text_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
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é
Sortie de raisonnement
Le raisonnement utilise le tarif du sous-ensemble indiqué dans le total de sortie ; ne comptez pas ces tokens deux fois. Lorsque la sortie comprend des tokens de raisonnement
#### Tarifs Ailoot
#### Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
| --- | --- | --- | --- | --- |
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens Sortie · Jetons de raisonnement en sortie **$0.02** / 1K tokens |
| ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluse200 000 | Coût Entrée · Tokens en entrée **$0.0025** / 1K tokens Sortie · Tokens en sortie **$0.02** / 1K tokens Entrée · Lecture du cache **$0.00025** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 1K tokens Entrée · Écriture dans le cache, 1 h **—** / 1K tokens |
| ConfigurationPalier 2 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de200 000 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée **$0.005** / 1K tokens Sortie · Tokens en sortie **$0.03** / 1K tokens Entrée · Lecture du cache **$0.0005** / 1K tokens Entrée · Écriture dans le cache **$0.00075** / 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 →](https://ailoot.ai/docs/fr/billing/reserve/)
### Exemples de requêtes
#### Ailoot Ultra · Messages Anthropic
Corps JSON minimal completcurl · utilisez votre document UTF-8Python · enregistrez le résultat complet
```json
{
"model": "google/gemini-2.5-pro",
"max_tokens": 128,
"messages": [
{
"role": "user",
"content": "Summarize the incident report."
}
],
"stream": false
}
```
```bash
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': 'google/gemini-2.5-pro', '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
```
```python
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': 'google/gemini-2.5-pro', '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 · Messages Anthropic
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 identifiants 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 identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
Champs de la réponse
| Champ | Type |
| --- | --- |
| Champ`id` | Typestring |
| Champ`model` | Typestring |
| Champ`content[]` | Typetext\|thinking\|tool\_use\|other content block |
| Champ`stop_reason` | Typestring\|null |
| Champ`usage` | Typeobject |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse400 · `invalid_request_error` | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
### Alias
#### Alias du modèle
Ailoot [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages)
**Ailoot Ultra** [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages), [`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages)
#### Alias des chemins de méthode
`/chat/completions`
#### ID d’appel associés
[`google/gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=google%2Fgemini-2.5-pro&fmt=messages), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Core&caller=gemini-2.5-pro&fmt=messages), [`gemini-2.5-pro`](https://ailoot.ai/models/fr/#m=google%2Fgemini-2.5-pro&route=Ultra&caller=gemini-2.5-pro&fmt=messages)
FAQ · Google: Gemini 2.5 Pro
Quelles entrées et quels résultats sont disponibles ?
`POST /v1/messages` · `gemini-2.5-pro`: `text`, `image` → `text` `POST /v1beta/models/{model}:generateContent` · `gemini-2.5-pro`: `text`, `image` → `text` `POST /v1/chat/completions` · `gemini-2.5-pro`: `text` → `text` `POST /v1/messages` · `gemini-2.5-pro`: `text` → `json`, `sse` `POST /v1/chat/completions` · `google/gemini-2.5-pro`: `text` → `text` `POST /v1/messages` · `google/gemini-2.5-pro`: `text` → `json`, `sse`
Quels champs la requête utilise-t-elle ?
`POST /v1/messages` · `gemini-2.5-pro`: `model`, `messages`, `system`, `max_tokens`, `stream`, `metadata` `POST /v1beta/models/{model}:generateContent` · `gemini-2.5-pro`: `contents`, `systemInstruction`, `sessionId` `POST /v1/chat/completions` · `gemini-2.5-pro`: `model`, `messages`, `stream` `POST /v1/messages` · `gemini-2.5-pro`: `model`, `messages`, `max_tokens`, `stream` `POST /v1/chat/completions` · `google/gemini-2.5-pro`: `model`, `messages`, `stream`, `modalities`, `provider` `POST /v1/messages` · `google/gemini-2.5-pro`: `model`, `messages`, `max_tokens`, `stream`
Quelles limites s’appliquent ?
`POST /v1/messages` · `gemini-2.5-pro`: `ctx`: `1048576`; `max_out`: `65536`; `messages.min_items`: `1`; `max_tokens.minimum`: `1` `POST /v1beta/models/{model}:generateContent` · `gemini-2.5-pro`: `ctx`: `1048576`; `max_out`: `65536`; `contents.min_items`: `1` `POST /v1/chat/completions` · `gemini-2.5-pro`: `messages.min_items`: `1` `POST /v1/chat/completions` · `google/gemini-2.5-pro`: `messages.min_items`: `1`
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](https://ailoot.ai/docs/fr/billing/subscriptions/) · [Voir les prix des modèles](https://ailoot.ai/models/fr/)
## 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](mailto:support@ailoot.ai) · [Offre officielle et contrat de licence](https://ailoot.ai/legal/offer?lang=fr)
## Ailoot · L’entreprise et son portefeuille de projets
Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.
L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.
Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.