modely

Google: Gemini 3.1 Pro Preview Custom Tools

Markdown · JSON

Google: Gemini 3.1 Pro Preview Custom Tools

Gemini 3.1 Pro Preview Custom Tools je osobitný variant orientovaný na agentov, ktorý popri terminálových príkazoch uprednostňuje nástroje definované aplikáciou. Použite ho, keď majú viackrokovú úlohu viesť akcie ako čítanie súborov či vyhľadávanie v kóde, pričom aplikácia vykoná každé volanie nástroja a vráti jeho výsledok.

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Gemini 3.1 Pro Preview Custom Tools je špecializovaný variant spoločnosti Google na pracovné postupy agentov, ktoré kombinujú terminálové príkazy s vlastnými nástrojmi. Jeho charakteristickým správaním je uprednostňovanie nástrojov definovaných aplikáciou; výrobca uvádza ako príklady view_file a search_code. Ide o samostatný pomenovaný variant Gemini 3.1 Pro Preview, nie o iné označenie každej požiadavky Pro. Užitočná úloha využíva správny nástroj na získanie dôkazov pred prípravou konečného textového výsledku.

Rad Pro Preview prijíma text, obrázky, video, zvuk a PDF a vracia text. Výrobca pre tento rad uvádza vstupný limit 1 048 576 tokenov a výstupný limit 65 536 tokenov. Preskúmanie repozitára môže kombinovať zdrojové súbory, písomné požiadavky a snímku rozhrania; práca s dokumentom môže kombinovať stránky a otázky. Označte zdroje a definujte konečný artefakt, aby veľký vstupný rozpočet podporoval konkrétnu úlohu namiesto nesústredeného výpisu archívu.

Pre softvérového agenta definujte cieľ, dostupné nástroje a rozsah požadovanej zmeny. Vlastný vyhľadávací nástroj môže vracať umiestnenia zodpovedajúcich súborov, zatiaľ čo nástroj na čítanie súboru poskytne presný relevantný obsah. Určte ich prijímané argumenty a vracané polia. Aplikácia vykoná prijaté volanie a odovzdá výsledok späť modelu, ktorý si môže vybrať ďalší krok podľa toho, čo sa skutočne stalo. Vrátená cesta je dôkazom výsledku vyhľadávania, nie dôkazom zmeny súboru alebo spustenia testu.

Variant Custom Tools je určený pre prípady, keď majú tieto špecializované akcie prednosť pred všeobecným príkazom bash. Agent napríklad môže najprv vyhľadať implementáciu pomenovaného správania, prečítať súvisiace súbory, porovnať ich s požiadavkou používateľa a potom navrhnúť ohraničenú zmenu. Definujte, ktoré rozhrania a správanie musia zostať zachované, a vyžiadajte si konečný zoznam navrhovaných zmien s použitými zdrojovými informáciami. Ak je dostupný riadený nástroj na spúšťanie testov, vráťte jeho skutočný výsledok ešte pred žiadosťou o záver týkajúci sa zmeny.

Dokumentácia výrobcu k 3.1 Pro zahŕňa uvažovanie, štruktúrované výstupy a volanie funkcií spolu s vykonávaním kódu, ukotvením vo vyhľadávaní, ukotvením v Google Maps, kontextom URL a ukladaním do vyrovnávacej pamäte. Uvedené vyhľadávanie v súboroch je výslovne obmedzené na Google AI Studio. Dostupnosť nástrojov je teda súčasťou vybraného rozhrania výrobcu a nastavenia aplikácie. Osobitné uprednostňovanie vlastných nástrojov týmto variantom samo osebe tieto nástroje neposkytuje ani nespúšťa externú operáciu. Pri každej dokončenej akcii aplikácie uchovajte názov funkcie, overené argumenty a výsledok.

Príručka Gemini 3 opisuje pre 3.1 Pro úrovne uvažovania low, medium a high, pričom predvolená je high. Ide o relatívny priestor na analýzu, nie o striktné záruky počtu tokenov. Úroveň voľte podľa úlohy a poskytujte priame pokyny namiesto zložitých promptovacích rituálov. Ak sa vyžaduje štruktúrovaný výstup, definujte polia, typy a pravidlá pre chýbajúce hodnoty. Pri správe o implementácii môže konečný záznam identifikovať preskúmané súbory, požadované správanie, navrhovanú úpravu a zostávajúce otázky. Skontrolujte, či každá položka vyplýva zo skutočných výsledkov nástrojov alebo zdrojov.

Viacťahoví agenti musia zachovať konverzáciu a požadovaný kontext uvažovania. Príručka výrobcu vysvetľuje podpisy uvažovania a odlišuje automaticky spravovanú stavovú históriu od ručne spravovanej bezstavovej histórie. Použite dokumentovaný postup vo vybranom rozhraní, najmä pri pokračovaní po výsledku nástroja. Pri dlhom zdrojovom materiáli umiestnite konkrétnu otázku za kontext a požadovanú odpoveď s ňou prepojte. Príručka tiež odporúča predvolenú temperature 1.0 namiesto prenášania nastavenia s nízkou teplotou, ktoré môže pri zložitých úlohách vyvolávať slučky.

Výrobca upozorňuje, že kvalita môže kolísať v prípadoch použitia, ktoré nemajú úžitok z vlastných nástrojov. Ide o zmysluplné kritérium výberu: tento profil používajte pre agenta, ktorého práca stojí na nástrojoch, a nepredpokladajte všeobecné zlepšenie pri každom samostatnom prompte. Textovým výstupom môže byť plán, návrh kódu, vysvetlenie alebo štruktúrovaný výsledok; obrazové či zvukové vstupy nemenia tento variant na generátor médií. Kontrolujte navrhovaný kód, overujte výpočty a odlišujte potvrdené operácie od návrhov. Uchovajte presnú identitu modelu Custom Tools spolu s úlohou, definíciami nástrojov a vrátenými dôkazmi, aby neskoršie pokračovanie malo konkrétny základ.

Praktická úloha

Praktická úloha

Technický príklad v angličtine

Interpret custom-tool evidence

Use this supplied tool transcript. search_code returned settings.py:12 and view_file returned: 'RETRY_LIMIT = 3'. No edit or test result is present. Requirement: increase the retry limit to five. Return the examined file, the exact proposed edit and the remaining check. Distinguish the retrieved value from actions that have not occurred.

Očakávaný výsledok

A file-linked proposed edit and an explicitly unexecuted validation step.

Overenie výsledku

The answer must not claim that settings.py was changed or a test passed.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions google/gemini-3.1-pro-preview-customtools

google/gemini-3.1-pro-preview-customtools

Google /google/gemini-3.1-pro-preview-customtools

Úvod

Gemini 3.1 Pro Preview Custom Tools je osobitný variant orientovaný na agentov, ktorý popri terminálových príkazoch uprednostňuje nástroje definované aplikáciou. Použite ho, keď majú viackrokovú úlohu viesť akcie ako čítanie súborov či vyhľadávanie v kóde, pričom aplikácia vykoná každé volanie nástroja a vráti jeho výsledok.

Povolené vstupy
Text
Výsledky
Text

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
Vstup
text
Výstup
text
Výstupný formát
json alebo SSE
PoleTypPožiadavkaHodnoty a limityPredvolené
PolemodelTypstringPožiadavkaPovinnéHodnoty a limity
google/gemini-3.1-pro-preview-customtools
Predvolené—
PolemessagesTypmessage[]PožiadavkaPovinnéHodnoty a limity
Minimálny počet položiek: 1
Predvolené—
Polemessages[].roleTypstringPožiadavkaPovinnéHodnoty a limity
Príklady: system, user, assistant, tool, function
Podmienky: Tieto roly sú výslovne zastúpené typmi kompatibility v zdrojovom kóde; presný súbor rolí zostáva závislý od modelu.
Závisí od modelu
Predvolené—
Polemessages[].contentTypstring|content_part[]|nullPožiadavkaVoliteľnéHodnoty a limityPredvolené—
Polemessages[].tool_callsTyptool_call[]PožiadavkaVoliteľnéHodnoty a limityPredvolené—
Polemessages[].tool_call_idTypstringPožiadavkaVoliteľnéHodnoty a limity
Platí, keď: role=tool; použite skutočne vrátené ID
Predvolené—
Polemessages[].nameTypstringPožiadavkaVoliteľnéHodnoty a limityPredvolené—
Polemessages[].reasoning_contentTypstringPožiadavkaVoliteľnéHodnoty a limity
Platí, keď: Posielajte späť skutočne vrátené uvažovanie, ak ho tento model používa
Predvolené—
Polemessages[].reasoning_detailsTypobject|arrayPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Polemax_tokensTypintegerPožiadavkaVoliteľnéHodnoty a limity
Minimum: 1
Závisí od modelu
Predvolené—
Polemax_completion_tokensTypintegerPožiadavkaVoliteľnéHodnoty a limity
Minimum: 1
Závisí od modelu
Predvolené—
PolestreamTypbooleanPožiadavkaVoliteľnéHodnoty a limityPredvolenéfalse
Polestream_options.include_usageTypbooleanPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
PoletemperatureTypnumberPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Poletop_pTypnumberPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
PolestopTypstring|string[]PožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
PoletoolsTypfunction_tool[]PožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Poletools[].typeTypstringPožiadavkaVoliteľnéHodnoty a limity
function
Závisí od modelu
Predvolené—
Poletools[].function.nameTypstringPožiadavkaPovinnéHodnoty a limity
Platí, keď: poskytnutý nástroj typu funkcia
Predvolené—
Poletools[].function.descriptionTypstringPožiadavkaVoliteľnéHodnoty a limityPredvolené—
Poletools[].function.parametersTypJSON_schemaPožiadavkaVoliteľnéHodnoty a limityPredvolené—
Poletool_choiceTypstring|objectPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Poleparallel_tool_callsTypbooleanPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Poleresponse_formatTypobjectPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Polereasoning_effortTypstringPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
PolereasoningTypobjectPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Poleservice_tierTypstringPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
PoleinstructionsTypstringPožiadavkaVoliteľnéHodnoty a limity
Pole kompatibility
Predvolené—
PolefunctionsTypfunction[]PožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Polefunction_callTypstring|objectPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
Poleprompt_cache_optionsTypobjectPožiadavkaVoliteľnéHodnoty a limity
Závisí od modelu
Predvolené—
PolemodalitiesTypstring[]PožiadavkaVoliteľnéHodnoty a limity
text
Predvolené—
PoleproviderTypobjectPožiadavkaVoliteľnéHodnoty a limity
Podmienky: provider.options sa na tejto textovej trase Ultra odmieta
Predvolené—
Polecache_control.ttlTypstringPožiadavkaVoliteľnéHodnoty a limity
Podmienky: Hodnota 1h sa v skutočne používaných poliach cache promptov odmieta
Predvolené—
Kombinácie vstupných podkladov

Text · Text UTF8

messages[].content

Parametre a životný cyklus metódy
ParameterŠpecifikácia
Parametercontent_typeŠpecifikáciaapplication/json
ParameterrequiredŠpecifikáciamodel, messages
Parametermaterial_typesŠpecifikáciatext
ParametermessagesŠpecifikáciapole správ so štruktúrou role/content
Parameterfile_materialŠpecifikáciaskutočný dokument UTF-8 vložený ako doslovný text; ID súboru sa neodvodzuje
Parameteroptional_controlsŠpecifikáciastream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice
Parametercontrol_scopeŠpecifikáciazávisí od modelu; používateľské nástroje typu funkcia sa líšia od nástrojov prevádzkovaných službou
Parameteroutput_modalitiesŠpecifikáciatext
Parameterhosted_operationsŠpecifikáciafalse
Parametermultimodal_input_bindingŠpecifikácianull

Životný cyklus: synchronous_or_streamed

Pošlite presné ID modelu spolu s messages.

Dĺžka kontextu nie je horná hranica výstupu.

Textový súbor môže poskytnúť doslovný text; obrazové a zvukové vstupy a vstupy so súborovými objektmi potrebujú presné naviazanie.

Cenník

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim
Štandardná sadzba Keď je zvolený rýchly režim
Režim Flex
Štandardná sadzba Keď je zvolený režim flex
Maximálna úroveň uvažovania
Štandardná sadzba Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Úroveň uvažovania · vysoká
Štandardná sadzba Keď je úroveň uvažovania vysoká
Úroveň uvažovania · nízka
Štandardná sadzba Keď je úroveň uvažovania nízka
Úroveň uvažovania · stredná
Štandardná sadzba Keď je úroveň uvažovania stredná
Ceny explicitnej cache
Nie je zapnuté Keď sa požaduje explicitná cache
Výstup uvažovania
Uvažovanie používa uvedenú sadzbu pre podmnožinu v rámci súhrnného výstupu; tieto tokeny nepripočítavajte dvakrát. Keď výstup obsahuje tokeny uvažovania

Sadzby Ailoot

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

KonfiguráciaSadzobníkPočet tokenov kontextu väčší nežTokeny kontextu, najviac (vrátane hranice)Poplatok
KonfiguráciaZákladné sadzby za tokenySadzobníkZákladná sadzbaPočet tokenov kontextu väčší než—Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranicePoplatok
Vstup · Vstupné tokeny $0.004 / 1K tokenov
Výstup · Výstupné tokeny $0.024 / 1K tokenov
Vstup · Čítanie cache $0.0004 / 1K tokenov
Vstup · Zápis do cache $0.00075 / 1K tokenov
Vstup · Zápis do cache, 1 hod — / 1K tokenov
Výstup · Výstupné tokeny uvažovania $0.024 / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 1Sadzobník—Počet tokenov kontextu väčší než0Tokeny kontextu, najviac (vrátane hranice)200 000Poplatok
Vstup · Vstupné tokeny $0.004 / 1K tokenov
Výstup · Výstupné tokeny $0.024 / 1K tokenov
Vstup · Čítanie cache $0.0004 / 1K tokenov
Vstup · Zápis do cache $0.00075 / 1K tokenov
Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 2Sadzobník—Počet tokenov kontextu väčší než200 000Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranicePoplatok
Vstup · Vstupné tokeny $0.008 / 1K tokenov
Výstup · Výstupné tokeny $0.036 / 1K tokenov
Vstup · Čítanie cache $0.0008 / 1K tokenov
Vstup · Zápis do cache $0.00075 / 1K tokenov
Vstup · Zápis do cache, 1 hod — / 1K tokenov

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · OpenAI Chat

curlPython SDKStreamovanie v jazyku Python
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-3.1-pro-preview-customtools", "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
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-3.1-pro-preview-customtools',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"))
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-3.1-pro-preview-customtools',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")

Prijať a uložiť výsledky

Ailoot Ultra · OpenAI Chat

json alebo SSE

Uchovať všetky dokončené výsledky

Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.

Zachovajte každý variant odpovede a jeho obsah, volania nástrojov a uvažovanie. V SSE zostavujte čiastkové zmeny podľa indexu variantu/nástroja a zachovajte konečný dôvod ukončenia aj údaje o spotrebe.

Ak treba overiť pôvodnú odpoveď

Zachovajte ID požiadaviek/odpovedí aj hlavičky. Všeobecná URL na načítanie textovej úlohy nie je poskytnutá.

Polia odpovede
PoleTyp
Polechoices[].indexTypinteger
Polechoices[].message.contentTypstring|null
Polechoices[].message.tool_callsTyptool_call[]
Polechoices[].message.reasoning_contentTypstring
Polechoices[].message.reasoning_detailsTypobject|array
Polechoices[].finish_reasonTypstring|null
PoleusageTypobject
Chyby a ďalšie kroky
OdpoveďPodmienkaĎalší krok
Odpoveď400 · invalid_request_errorPodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametraĎalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia.

Aliasy

Aliasy modelov

Ailoot Ultra google/gemini-3.1-pro-preview-customtools

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

google/gemini-3.1-pro-preview-customtools

Ailoot Ultra · Anthropic Messages POST /v1/messages google/gemini-3.1-pro-preview-customtools

google/gemini-3.1-pro-preview-customtools

Google /google/gemini-3.1-pro-preview-customtools

Úvod

Gemini 3.1 Pro Preview Custom Tools je osobitný variant orientovaný na agentov, ktorý popri terminálových príkazoch uprednostňuje nástroje definované aplikáciou. Použite ho, keď majú viackrokovú úlohu viesť akcie ako čítanie súborov či vyhľadávanie v kóde, pričom aplikácia vykoná každé volanie nástroja a vráti jeho výsledok.

Povolené vstupy
Text
Výsledky
json · sse

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Anthropic Messages POST /v1/messages
Vstup
text
Výstup
json, sse
Výstupný formát
JSON alebo SSE
PoleTypPožiadavkaHodnoty a limityPredvolené
PolemodelTypstringPožiadavkaPovinnéHodnoty a limity
google/gemini-3.1-pro-preview-customtools
Predvolené—
PolemessagesTypmessage[]PožiadavkaPovinnéHodnoty a limityPredvolené—
Polemessages[].roleTypstringPožiadavkaPovinnéHodnoty a limity
user, assistant
Predvolené—
Polemessages[].contentTypstringPožiadavkaPovinnéHodnoty a limityPredvolené—
Polemax_tokensTypintegerPožiadavkaPovinnéHodnoty a limityPredvolené—
PolestreamTypbooleanPožiadavkaVoliteľnéHodnoty a limityPredvolenéfalse
Kombinácie vstupných podkladov

Text · Text UTF-8

reťazec messages[].content

Parametre a životný cyklus metódy
ParameterŠpecifikácia
Parametercontent_typeŠpecifikáciaapplication/json
ParameterrequiredŠpecifikáciamodel, messages, max_tokens
Parameteroptional_controlsŠpecifikáciastream
Parametermaterial_typesŠpecifikáciatext
Parametertext_file_materialŠpecifikáciaPrečítajte skutočný dokument UTF-8 a vložte jeho text do uvedeného vstupného reťazca alebo reťazca obsahu správy.

Životný cyklus: synchronous_or_streamed

Cenník

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim
Štandardná sadzba Keď je zvolený rýchly režim
Režim Flex
Štandardná sadzba Keď je zvolený režim flex
Maximálna úroveň uvažovania
Štandardná sadzba Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Úroveň uvažovania · vysoká
Štandardná sadzba Keď je úroveň uvažovania vysoká
Úroveň uvažovania · nízka
Štandardná sadzba Keď je úroveň uvažovania nízka
Úroveň uvažovania · stredná
Štandardná sadzba Keď je úroveň uvažovania stredná
Ceny explicitnej cache
Nie je zapnuté Keď sa požaduje explicitná cache
Výstup uvažovania
Uvažovanie používa uvedenú sadzbu pre podmnožinu v rámci súhrnného výstupu; tieto tokeny nepripočítavajte dvakrát. Keď výstup obsahuje tokeny uvažovania

Sadzby Ailoot

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

KonfiguráciaSadzobníkPočet tokenov kontextu väčší nežTokeny kontextu, najviac (vrátane hranice)Poplatok
KonfiguráciaZákladné sadzby za tokenySadzobníkZákladná sadzbaPočet tokenov kontextu väčší než—Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranicePoplatok
Vstup · Vstupné tokeny $0.004 / 1K tokenov
Výstup · Výstupné tokeny $0.024 / 1K tokenov
Vstup · Čítanie cache $0.0004 / 1K tokenov
Vstup · Zápis do cache $0.00075 / 1K tokenov
Vstup · Zápis do cache, 1 hod — / 1K tokenov
Výstup · Výstupné tokeny uvažovania $0.024 / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 1Sadzobník—Počet tokenov kontextu väčší než0Tokeny kontextu, najviac (vrátane hranice)200 000Poplatok
Vstup · Vstupné tokeny $0.004 / 1K tokenov
Výstup · Výstupné tokeny $0.024 / 1K tokenov
Vstup · Čítanie cache $0.0004 / 1K tokenov
Vstup · Zápis do cache $0.00075 / 1K tokenov
Vstup · Zápis do cache, 1 hod — / 1K tokenov
KonfiguráciaPásmo dĺžky požiadavky 2Sadzobník—Počet tokenov kontextu väčší než200 000Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranicePoplatok
Vstup · Vstupné tokeny $0.008 / 1K tokenov
Výstup · Výstupné tokeny $0.036 / 1K tokenov
Vstup · Čítanie cache $0.0008 / 1K tokenov
Vstup · Zápis do cache $0.00075 / 1K tokenov
Vstup · Zápis do cache, 1 hod — / 1K tokenov

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Anthropic Messages

Úplné minimálne telo požiadavky vo formáte JSONcurl · použite svoj dokument UTF-8Python · uložte úplný výsledok
{
  "model": "google/gemini-3.1-pro-preview-customtools",
  "max_tokens": 128,
  "messages": [
    {
      "role": "user",
      "content": "Summarize the incident report."
    }
  ],
  "stream": false
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'google/gemini-3.1-pro-preview-customtools', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'google/gemini-3.1-pro-preview-customtools', '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))

Prijať a uložiť výsledky

Ailoot Ultra · Anthropic Messages

JSON alebo SSE

Uchovať všetky dokončené výsledky

Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.

Zachovajte všetky bloky obsahu, podpisy uvažovania a skutočné ID volaní nástrojov. Zostavte všetky čiastkové zmeny blokov SSE; prvý textový blok nie je celý výstup.

Ak treba overiť pôvodnú odpoveď

Zachovajte ID požiadaviek/odpovedí aj hlavičky. Všeobecná URL na načítanie textovej úlohy nie je poskytnutá.

Polia odpovede
PoleTyp
PoleidTypstring
PolemodelTypstring
Polecontent[]Typtext|thinking|tool_use|other content block
Polestop_reasonTypstring|null
PoleusageTypobject
Chyby a ďalšie kroky
OdpoveďPodmienkaĎalší krok
Odpoveď400 · invalid_request_errorPodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametraĎalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia.

Aliasy

Aliasy modelov

Ailoot Ultra google/gemini-3.1-pro-preview-customtools

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

google/gemini-3.1-pro-preview-customtools

FAQ · Google: Gemini 3.1 Pro Preview Custom Tools
Aké vstupy a výsledky sú dostupné?

POST /v1/chat/completions · google/gemini-3.1-pro-preview-customtools: text → text

POST /v1/messages · google/gemini-3.1-pro-preview-customtools: text → json, sse

Aké polia používa požiadavka?

POST /v1/chat/completions · google/gemini-3.1-pro-preview-customtools: model, messages, stream, modalities, provider

POST /v1/messages · google/gemini-3.1-pro-preview-customtools: model, messages, max_tokens, stream

Aké limity platia?

POST /v1/chat/completions · google/gemini-3.1-pro-preview-customtools: messages.min_items: 1

Viac podrobností

Pripojte Ailoot k Claude Code, OpenCode, Hermes alebo vlastnej aplikácii.

Spoločnosť a jej portfólio projektov

Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.

Nakupujte tokeny so zľavou.

Zľava predplatného na pravidelnú prácu. Promo kódy až 50% na nákup tokenov.

Predplatné
Na pravidelné požiadavky vyberte tarifu so zľavou.
Promo kód až 50%
Pri nákupe zadajte kód. Cena sa prepočíta podľa prebiehajúcej akcie.
Výdavky v histórii
Pri každej požiadavke sa uloží model, tokeny a suma.

Vybrať predplatné · Zobraziť ceny modelov

Pripojte API k produktu, ktorý predávate.

SaaS, aplikácie a boti podľa ponuky a licenčnej zmluvy Ailoot. Na ďalší predaj požiadajte o licenciu predajcu.

Komerčná aplikácia
Začleňte generovanie textu, obrázkov, videa a zvuku do platených funkcií svojej služby.
Licencia pre predajcu
Pošlite popis projektu a spôsob poskytovania prístupu. Vyžiadajte písomné podmienky použitia a ďalšieho predaja.
Dokumenty na webe
Ponuka, licenčná zmluva a zásady spracovania dát sú dostupné pred pripojením.

Požiadať o licenciu predajcu · Ponuka a licenčná zmluva