Gemini 3.1 Pro Preview Custom Tools je Googlova specializirana različica za agentske delovne postopke, ki združujejo terminalske ukaze in orodja po meri. Njeno značilno vedenje je dajanje prednosti orodjem, opredeljenim v aplikaciji; proizvajalec kot primera navaja view_file in search_code. To je ločena poimenovana različica Gemini 3.1 Pro Preview, ne druga oznaka za vsako zahtevo Pro. Uporabna naloga se opira na ustrezno orodje za pridobivanje dokazov pred pripravo končnega besedilnega rezultata.
Linija Pro Preview sprejema besedilo, slike, video, zvok in PDF ter vrača besedilo. Proizvajalec za to linijo navaja vhodno omejitev 1,048,576 žetonov in izhodno omejitev 65,536 žetonov. Raziskava repozitorija lahko združi izvorne datoteke, pisne zahteve in posnetek zaslona vmesnika; delovni postopek z dokumenti lahko združi strani in vprašanja. Označite vire in določite končni izdelek, da velik vhodni proračun podpira konkretno nalogo namesto neusmerjenega izpisa arhiva.
Za programskega agenta določite cilj, razpoložljiva orodja in obseg zahtevane spremembe. Iskalno orodje po meri lahko vrne lokacije ujemajočih se datotek, orodje za branje datotek pa poda natančno ustrezno vsebino. Določite njune sprejete argumente in polja, ki jih vrneta. Aplikacija izvede sprejeti klic in rezultat posreduje modelu, ki lahko naslednji korak izbere na podlagi dejanskega dogajanja. Vrnjena pot je dokaz rezultata iskanja, ne dokaz, da je bila datoteka spremenjena ali da je bil izveden preizkus.
Različica Custom Tools je namenjena primerom, ko naj imajo ta specializirana dejanja prednost pred uporabo splošnega ukaza bash. Agent lahko na primer najprej poišče izvedbo poimenovanega vedenja, prebere povezane datoteke, jih primerja z uporabnikovo zahtevo in nato predlaga omejeno spremembo. Določite, kateri vmesniki in vedenje morajo ostati nedotaknjeni, ter zahtevajte končni seznam predlaganih sprememb z uporabljenimi izvornimi informacijami. Če je na voljo nadzorovano orodje za izvajanje preizkusov, vrnite njegov dejanski rezultat, preden zahtevate sklep o spremembi.
Proizvajalčeva dokumentacija za 3.1 Pro vključuje razmišljanje, strukturirane izhode in klicanje funkcij ter izvajanje kode, utemeljevanje z iskanjem, utemeljevanje s podatki Google Maps, kontekst URL in predpomnjenje. Navedba iskanja po datotekah je izrecno omejena na Google AI Studio. Razpoložljivost orodij je zato del izbranega proizvajalčevega vmesnika in nastavitve aplikacije. Posebna prednostna uporaba orodij po meri pri tej različici sama po sebi teh orodij ne zagotavlja in ne izvede zunanje operacije. Za vsako dokončano dejanje aplikacije hranite zapis imena funkcije, preverjenih argumentov in rezultata.
Vodnik Gemini 3 opisuje ravni razmišljanja low, medium in high za 3.1 Pro, pri čemer je high privzeta. Gre za relativne obsege analize, ne stroga jamstva glede žetonov. Raven izberite glede na nalogo in podajte neposredna navodila namesto zapletenih ritualov oblikovanja pozivov. Če je potreben strukturiran izhod, določite polja, tipe in pravila za manjkajoče vrednosti. Pri poročilu o izvedbi lahko končni zapis opredeli pregledane datoteke, zahtevano vedenje, predlagano spremembo in preostala vprašanja. Preverite, ali vsak vnos izhaja iz dejanskih rezultatov orodij ali virov.
Agenti v več izmenjavah morajo ohraniti pogovor in zahtevani kontekst sklepanja. Proizvajalčev vodnik pojasnjuje podpise razmišljanja ter razlikuje med samodejno upravljano zgodovino s stanjem in ročno upravljano zgodovino brez stanja. V izbranem vmesniku uporabite dokumentirani način obravnave, zlasti pri nadaljevanju po rezultatu orodja. Pri dolgem izvornem gradivu naj konkretno vprašanje sledi kontekstu, zahtevani odgovor pa navežite na to vprašanje. Vodnik priporoča tudi privzeto temperaturo 1.0 namesto prenosa nizkotemperaturne nastavitve, ki lahko pri zahtevnih nalogah povzroči zanke.
Proizvajalec opozarja, da lahko kakovost niha pri primerih uporabe, ki jim orodja po meri ne koristijo. To je pomembno merilo izbire: ta profil uporabite za agenta, katerega delo temelji na orodjih, namesto da bi predpostavljali splošno izboljšanje pri vsakem samostojnem pozivu. Besedilni izhod je lahko načrt, predlog kode, razlaga ali strukturiran rezultat; slikovni ali zvočni vhodi različice ne spremenijo v generator medijskih vsebin. Preglejte predlagano kodo, preverite izračune in ločite potrjene operacije od predlogov. Skupaj z nalogo, definicijami orodij in vrnjenimi dokazi ohranite natančno identiteto modela Custom Tools, da ima poznejše nadaljevanje konkretno podlago.
", "aboutText": "Gemini 3.1 Pro Preview Custom Tools je Googlova specializirana različica za agentske delovne postopke, ki združujejo terminalske ukaze in orodja po meri. Njeno značilno vedenje je dajanje prednosti orodjem, opredeljenim v aplikaciji; proizvajalec kot primera navaja view_file in search_code. To je ločena poimenovana različica Gemini 3.1 Pro Preview, ne druga oznaka za vsako zahtevo Pro. Uporabna naloga se opira na ustrezno orodje za pridobivanje dokazov pred pripravo končnega besedilnega rezultata.\n\nLinija Pro Preview sprejema besedilo, slike, video, zvok in PDF ter vrača besedilo. Proizvajalec za to linijo navaja vhodno omejitev 1,048,576 žetonov in izhodno omejitev 65,536 žetonov. Raziskava repozitorija lahko združi izvorne datoteke, pisne zahteve in posnetek zaslona vmesnika; delovni postopek z dokumenti lahko združi strani in vprašanja. Označite vire in določite končni izdelek, da velik vhodni proračun podpira konkretno nalogo namesto neusmerjenega izpisa arhiva.\n\nZa programskega agenta določite cilj, razpoložljiva orodja in obseg zahtevane spremembe. Iskalno orodje po meri lahko vrne lokacije ujemajočih se datotek, orodje za branje datotek pa poda natančno ustrezno vsebino. Določite njune sprejete argumente in polja, ki jih vrneta. Aplikacija izvede sprejeti klic in rezultat posreduje modelu, ki lahko naslednji korak izbere na podlagi dejanskega dogajanja. Vrnjena pot je dokaz rezultata iskanja, ne dokaz, da je bila datoteka spremenjena ali da je bil izveden preizkus.\n\nRazličica Custom Tools je namenjena primerom, ko naj imajo ta specializirana dejanja prednost pred uporabo splošnega ukaza bash. Agent lahko na primer najprej poišče izvedbo poimenovanega vedenja, prebere povezane datoteke, jih primerja z uporabnikovo zahtevo in nato predlaga omejeno spremembo. Določite, kateri vmesniki in vedenje morajo ostati nedotaknjeni, ter zahtevajte končni seznam predlaganih sprememb z uporabljenimi izvornimi informacijami. Če je na voljo nadzorovano orodje za izvajanje preizkusov, vrnite njegov dejanski rezultat, preden zahtevate sklep o spremembi.\n\nProizvajalčeva dokumentacija za 3.1 Pro vključuje razmišljanje, strukturirane izhode in klicanje funkcij ter izvajanje kode, utemeljevanje z iskanjem, utemeljevanje s podatki Google Maps, kontekst URL in predpomnjenje. Navedba iskanja po datotekah je izrecno omejena na Google AI Studio. Razpoložljivost orodij je zato del izbranega proizvajalčevega vmesnika in nastavitve aplikacije. Posebna prednostna uporaba orodij po meri pri tej različici sama po sebi teh orodij ne zagotavlja in ne izvede zunanje operacije. Za vsako dokončano dejanje aplikacije hranite zapis imena funkcije, preverjenih argumentov in rezultata.\n\nVodnik Gemini 3 opisuje ravni razmišljanja low, medium in high za 3.1 Pro, pri čemer je high privzeta. Gre za relativne obsege analize, ne stroga jamstva glede žetonov. Raven izberite glede na nalogo in podajte neposredna navodila namesto zapletenih ritualov oblikovanja pozivov. Če je potreben strukturiran izhod, določite polja, tipe in pravila za manjkajoče vrednosti. Pri poročilu o izvedbi lahko končni zapis opredeli pregledane datoteke, zahtevano vedenje, predlagano spremembo in preostala vprašanja. Preverite, ali vsak vnos izhaja iz dejanskih rezultatov orodij ali virov.\n\nAgenti v več izmenjavah morajo ohraniti pogovor in zahtevani kontekst sklepanja. Proizvajalčev vodnik pojasnjuje podpise razmišljanja ter razlikuje med samodejno upravljano zgodovino s stanjem in ročno upravljano zgodovino brez stanja. V izbranem vmesniku uporabite dokumentirani način obravnave, zlasti pri nadaljevanju po rezultatu orodja. Pri dolgem izvornem gradivu naj konkretno vprašanje sledi kontekstu, zahtevani odgovor pa navežite na to vprašanje. Vodnik priporoča tudi privzeto temperaturo 1.0 namesto prenosa nizkotemperaturne nastavitve, ki lahko pri zahtevnih nalogah povzroči zanke.\n\nProizvajalec opozarja, da lahko kakovost niha pri primerih uporabe, ki jim orodja po meri ne koristijo. To je pomembno merilo izbire: ta profil uporabite za agenta, katerega delo temelji na orodjih, namesto da bi predpostavljali splošno izboljšanje pri vsakem samostojnem pozivu. Besedilni izhod je lahko načrt, predlog kode, razlaga ali strukturiran rezultat; slikovni ali zvočni vhodi različice ne spremenijo v generator medijskih vsebin. Preglejte predlagano kodo, preverite izračune in ločite potrjene operacije od predlogov. Skupaj z nalogo, definicijami orodij in vrnjenimi dokazi ohranite natančno identiteto modela Custom Tools, da ima poznejše nadaljevanje konkretno podlago.", "editorialOverlay": { "copy_fields": { "practical_html": "Tehnični primer v angleščini
Interpret custom-tool evidence\n\nUse 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.A file-linked proposed edit and an explicitly unexecuted validation step.The answer must not claim that settings.py was changed or a test passed.google/gemini-3.1-pro-preview-customtoolsGemini 3.1 Pro Preview Custom Tools je ločena agentsko usmerjena različica, ki poleg terminalskih ukazov daje prednost orodjem, opredeljenim v aplikaciji. Uporabite jo, kadar naj nalogo v več korakih vodijo dejanja, kot sta branje datotek ali iskanje po kodi, aplikacija pa izvede vsako orodje in vrne njegov rezultat.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Gemini 3.1 Pro Preview Custom Tools je Googlova specializirana različica za agentske delovne postopke, ki združujejo terminalske ukaze in orodja po meri. Njeno značilno vedenje je dajanje prednosti orodjem, opredeljenim v aplikaciji; proizvajalec kot primera navaja view_file in search_code. To je ločena poimenovana različica Gemini 3.1 Pro Preview, ne druga oznaka za vsako zahtevo Pro. Uporabna naloga se opira na ustrezno orodje za pridobivanje dokazov pred pripravo končnega besedilnega rezultata.
Linija Pro Preview sprejema besedilo, slike, video, zvok in PDF ter vrača besedilo. Proizvajalec za to linijo navaja vhodno omejitev 1,048,576 žetonov in izhodno omejitev 65,536 žetonov. Raziskava repozitorija lahko združi izvorne datoteke, pisne zahteve in posnetek zaslona vmesnika; delovni postopek z dokumenti lahko združi strani in vprašanja. Označite vire in določite končni izdelek, da velik vhodni proračun podpira konkretno nalogo namesto neusmerjenega izpisa arhiva.
Za programskega agenta določite cilj, razpoložljiva orodja in obseg zahtevane spremembe. Iskalno orodje po meri lahko vrne lokacije ujemajočih se datotek, orodje za branje datotek pa poda natančno ustrezno vsebino. Določite njune sprejete argumente in polja, ki jih vrneta. Aplikacija izvede sprejeti klic in rezultat posreduje modelu, ki lahko naslednji korak izbere na podlagi dejanskega dogajanja. Vrnjena pot je dokaz rezultata iskanja, ne dokaz, da je bila datoteka spremenjena ali da je bil izveden preizkus.
Različica Custom Tools je namenjena primerom, ko naj imajo ta specializirana dejanja prednost pred uporabo splošnega ukaza bash. Agent lahko na primer najprej poišče izvedbo poimenovanega vedenja, prebere povezane datoteke, jih primerja z uporabnikovo zahtevo in nato predlaga omejeno spremembo. Določite, kateri vmesniki in vedenje morajo ostati nedotaknjeni, ter zahtevajte končni seznam predlaganih sprememb z uporabljenimi izvornimi informacijami. Če je na voljo nadzorovano orodje za izvajanje preizkusov, vrnite njegov dejanski rezultat, preden zahtevate sklep o spremembi.
Proizvajalčeva dokumentacija za 3.1 Pro vključuje razmišljanje, strukturirane izhode in klicanje funkcij ter izvajanje kode, utemeljevanje z iskanjem, utemeljevanje s podatki Google Maps, kontekst URL in predpomnjenje. Navedba iskanja po datotekah je izrecno omejena na Google AI Studio. Razpoložljivost orodij je zato del izbranega proizvajalčevega vmesnika in nastavitve aplikacije. Posebna prednostna uporaba orodij po meri pri tej različici sama po sebi teh orodij ne zagotavlja in ne izvede zunanje operacije. Za vsako dokončano dejanje aplikacije hranite zapis imena funkcije, preverjenih argumentov in rezultata.
Vodnik Gemini 3 opisuje ravni razmišljanja low, medium in high za 3.1 Pro, pri čemer je high privzeta. Gre za relativne obsege analize, ne stroga jamstva glede žetonov. Raven izberite glede na nalogo in podajte neposredna navodila namesto zapletenih ritualov oblikovanja pozivov. Če je potreben strukturiran izhod, določite polja, tipe in pravila za manjkajoče vrednosti. Pri poročilu o izvedbi lahko končni zapis opredeli pregledane datoteke, zahtevano vedenje, predlagano spremembo in preostala vprašanja. Preverite, ali vsak vnos izhaja iz dejanskih rezultatov orodij ali virov.
Agenti v več izmenjavah morajo ohraniti pogovor in zahtevani kontekst sklepanja. Proizvajalčev vodnik pojasnjuje podpise razmišljanja ter razlikuje med samodejno upravljano zgodovino s stanjem in ročno upravljano zgodovino brez stanja. V izbranem vmesniku uporabite dokumentirani način obravnave, zlasti pri nadaljevanju po rezultatu orodja. Pri dolgem izvornem gradivu naj konkretno vprašanje sledi kontekstu, zahtevani odgovor pa navežite na to vprašanje. Vodnik priporoča tudi privzeto temperaturo 1.0 namesto prenosa nizkotemperaturne nastavitve, ki lahko pri zahtevnih nalogah povzroči zanke.
Proizvajalec opozarja, da lahko kakovost niha pri primerih uporabe, ki jim orodja po meri ne koristijo. To je pomembno merilo izbire: ta profil uporabite za agenta, katerega delo temelji na orodjih, namesto da bi predpostavljali splošno izboljšanje pri vsakem samostojnem pozivu. Besedilni izhod je lahko načrt, predlog kode, razlaga ali strukturiran rezultat; slikovni ali zvočni vhodi različice ne spremenijo v generator medijskih vsebin. Preglejte predlagano kodo, preverite izračune in ločite potrjene operacije od predlogov. Skupaj z nalogo, definicijami orodij in vrnjenimi dokazi ohranite natančno identiteto modela Custom Tools, da ima poznejše nadaljevanje konkretno podlago.
POST /v1/chat/completionstexttext| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-pro-preview-customtools | Privzeto— |
Poljemessages | Vrstamessage[] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 | Privzeto— |
Poljemessages[].role | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Primeri: system, user, assistant, tool, function Pogoji: Te vloge so izrecno predstavljene s tipi združljivosti v izvorni kodi; natančen nabor vlog ostaja odvisen od modela. Odvisno od modela | Privzeto— |
Poljemessages[].content | Vrstastring|content_part[]|null | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].tool_calls | Vrstatool_call[] | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].tool_call_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: role=tool; uporabite dejansko vrnjeni ID | Privzeto— |
Poljemessages[].name | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].reasoning_content | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: Pošljite nazaj dejansko vrnjeno sklepanje, kadar ga ta model uporablja | Privzeto— |
Poljemessages[].reasoning_details | Vrstaobject|array | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemax_tokens | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— |
Poljemax_completion_tokens | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljestream_options.include_usage | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetemperature | Vrstanumber | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetop_p | Vrstanumber | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljestop | Vrstastring|string[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetools | Vrstafunction_tool[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetools[].type | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve function Odvisno od modela | Privzeto— |
Poljetools[].function.name | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: podano je funkcijsko orodje | Privzeto— |
Poljetools[].function.description | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetools[].function.parameters | VrstaJSON_schema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetool_choice | Vrstastring|object | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeparallel_tool_calls | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeresponse_format | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljereasoning_effort | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljereasoning | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeservice_tier | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeinstructions | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Polje združljivosti | Privzeto— |
Poljefunctions | Vrstafunction[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljefunction_call | Vrstastring|object | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeprompt_cache_options | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemodalities | Vrstastring[] | ZahtevaIzbirno | Vrednosti in omejitve text | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: provider.options je na tej besedilni poti Ultra zavrnjen | Privzeto— |
Poljecache_control.ttl | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: 1h je zavrnjen na dejanskih mestih za predpomnjenje pozivov | Privzeto— |
Besedilo · Besedilo UTF8
messages[].content
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, messages |
Parametermaterial_types | Specifikacijatext |
Parametermessages | Specifikacijapolje sporočil s strukturo role/content |
Parameterfile_material | Specifikacijadejanski dokument UTF-8 je vstavljen kot dobesedno besedilo; ID datoteke se ne izpeljuje |
Parameteroptional_controls | Specifikacijastream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Specifikacijaodvisno od modela; uporabniška funkcijska orodja se razlikujejo od orodij, ki jih izvaja storitev |
Parameteroutput_modalities | Specifikacijatext |
Parameterhosted_operations | Specifikacijafalse |
Parametermultimodal_input_binding | Specifikacijanull |
Življenjski cikel: synchronous_or_streamed
Pošljite natančen ID modela skupaj z messages.
Dolžina konteksta ni zgornja meja izhoda.
Besedilna datoteka lahko poda dobesedno besedilo; slikovni, zvočni vhodi in vhodi z datotečnimi objekti potrebujejo natančno vezavo.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov Izhod · Izhodni žetoni razmišljanja $0.024 / 1K žetonov |
| NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključno200.000 | Strošek Vhod · Vhodni žetoni $0.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
| NastavitevRazred 2 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot200.000 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.008 / 1K žetonov Izhod · Izhodni žetoni $0.036 / 1K žetonov Vhod · Branje predpomnilnika $0.0008 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-3.1-pro-preview-customtools',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith 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:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson ali SSE
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohranite vsako možnost odgovora ter njeno vsebino, klice orodij in sklepanje. V SSE sestavite delne spremembe po indeksu možnosti/orodja ter ohranite končni razlog zaključka in podatke o porabi.
Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan.
| Polje | Vrsta |
|---|---|
Poljechoices[].index | Vrstainteger |
Poljechoices[].message.content | Vrstastring|null |
Poljechoices[].message.tool_calls | Vrstatool_call[] |
Poljechoices[].message.reasoning_content | Vrstastring |
Poljechoices[].message.reasoning_details | Vrstaobject|array |
Poljechoices[].finish_reason | Vrstastring|null |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Ailoot Ultra google/gemini-3.1-pro-preview-customtools
Uporabite zgoraj navedene poti metod.
google/gemini-3.1-pro-preview-customtoolsGemini 3.1 Pro Preview Custom Tools je ločena agentsko usmerjena različica, ki poleg terminalskih ukazov daje prednost orodjem, opredeljenim v aplikaciji. Uporabite jo, kadar naj nalogo v več korakih vodijo dejanja, kot sta branje datotek ali iskanje po kodi, aplikacija pa izvede vsako orodje in vrne njegov rezultat.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Gemini 3.1 Pro Preview Custom Tools je Googlova specializirana različica za agentske delovne postopke, ki združujejo terminalske ukaze in orodja po meri. Njeno značilno vedenje je dajanje prednosti orodjem, opredeljenim v aplikaciji; proizvajalec kot primera navaja view_file in search_code. To je ločena poimenovana različica Gemini 3.1 Pro Preview, ne druga oznaka za vsako zahtevo Pro. Uporabna naloga se opira na ustrezno orodje za pridobivanje dokazov pred pripravo končnega besedilnega rezultata.
Linija Pro Preview sprejema besedilo, slike, video, zvok in PDF ter vrača besedilo. Proizvajalec za to linijo navaja vhodno omejitev 1,048,576 žetonov in izhodno omejitev 65,536 žetonov. Raziskava repozitorija lahko združi izvorne datoteke, pisne zahteve in posnetek zaslona vmesnika; delovni postopek z dokumenti lahko združi strani in vprašanja. Označite vire in določite končni izdelek, da velik vhodni proračun podpira konkretno nalogo namesto neusmerjenega izpisa arhiva.
Za programskega agenta določite cilj, razpoložljiva orodja in obseg zahtevane spremembe. Iskalno orodje po meri lahko vrne lokacije ujemajočih se datotek, orodje za branje datotek pa poda natančno ustrezno vsebino. Določite njune sprejete argumente in polja, ki jih vrneta. Aplikacija izvede sprejeti klic in rezultat posreduje modelu, ki lahko naslednji korak izbere na podlagi dejanskega dogajanja. Vrnjena pot je dokaz rezultata iskanja, ne dokaz, da je bila datoteka spremenjena ali da je bil izveden preizkus.
Različica Custom Tools je namenjena primerom, ko naj imajo ta specializirana dejanja prednost pred uporabo splošnega ukaza bash. Agent lahko na primer najprej poišče izvedbo poimenovanega vedenja, prebere povezane datoteke, jih primerja z uporabnikovo zahtevo in nato predlaga omejeno spremembo. Določite, kateri vmesniki in vedenje morajo ostati nedotaknjeni, ter zahtevajte končni seznam predlaganih sprememb z uporabljenimi izvornimi informacijami. Če je na voljo nadzorovano orodje za izvajanje preizkusov, vrnite njegov dejanski rezultat, preden zahtevate sklep o spremembi.
Proizvajalčeva dokumentacija za 3.1 Pro vključuje razmišljanje, strukturirane izhode in klicanje funkcij ter izvajanje kode, utemeljevanje z iskanjem, utemeljevanje s podatki Google Maps, kontekst URL in predpomnjenje. Navedba iskanja po datotekah je izrecno omejena na Google AI Studio. Razpoložljivost orodij je zato del izbranega proizvajalčevega vmesnika in nastavitve aplikacije. Posebna prednostna uporaba orodij po meri pri tej različici sama po sebi teh orodij ne zagotavlja in ne izvede zunanje operacije. Za vsako dokončano dejanje aplikacije hranite zapis imena funkcije, preverjenih argumentov in rezultata.
Vodnik Gemini 3 opisuje ravni razmišljanja low, medium in high za 3.1 Pro, pri čemer je high privzeta. Gre za relativne obsege analize, ne stroga jamstva glede žetonov. Raven izberite glede na nalogo in podajte neposredna navodila namesto zapletenih ritualov oblikovanja pozivov. Če je potreben strukturiran izhod, določite polja, tipe in pravila za manjkajoče vrednosti. Pri poročilu o izvedbi lahko končni zapis opredeli pregledane datoteke, zahtevano vedenje, predlagano spremembo in preostala vprašanja. Preverite, ali vsak vnos izhaja iz dejanskih rezultatov orodij ali virov.
Agenti v več izmenjavah morajo ohraniti pogovor in zahtevani kontekst sklepanja. Proizvajalčev vodnik pojasnjuje podpise razmišljanja ter razlikuje med samodejno upravljano zgodovino s stanjem in ročno upravljano zgodovino brez stanja. V izbranem vmesniku uporabite dokumentirani način obravnave, zlasti pri nadaljevanju po rezultatu orodja. Pri dolgem izvornem gradivu naj konkretno vprašanje sledi kontekstu, zahtevani odgovor pa navežite na to vprašanje. Vodnik priporoča tudi privzeto temperaturo 1.0 namesto prenosa nizkotemperaturne nastavitve, ki lahko pri zahtevnih nalogah povzroči zanke.
Proizvajalec opozarja, da lahko kakovost niha pri primerih uporabe, ki jim orodja po meri ne koristijo. To je pomembno merilo izbire: ta profil uporabite za agenta, katerega delo temelji na orodjih, namesto da bi predpostavljali splošno izboljšanje pri vsakem samostojnem pozivu. Besedilni izhod je lahko načrt, predlog kode, razlaga ali strukturiran rezultat; slikovni ali zvočni vhodi različice ne spremenijo v generator medijskih vsebin. Preglejte predlagano kodo, preverite izračune in ločite potrjene operacije od predlogov. Skupaj z nalogo, definicijami orodij in vrnjenimi dokazi ohranite natančno identiteto modela Custom Tools, da ima poznejše nadaljevanje konkretno podlago.
POST /v1/messagestextjson, sse| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-pro-preview-customtools | Privzeto— |
Poljemessages | Vrstamessage[] | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].role | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve user, assistant | Privzeto— |
Poljemessages[].content | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljemax_tokens | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Besedilo · Besedilo UTF-8
niz messages[].content
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, messages, max_tokens |
Parameteroptional_controls | Specifikacijastream |
Parametermaterial_types | Specifikacijatext |
Parametertext_file_material | SpecifikacijaPreberite dejanski dokument UTF-8 in njegovo besedilo vstavite v navedeni vhodni niz ali niz vsebine sporočila. |
Življenjski cikel: synchronous_or_streamed
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov Izhod · Izhodni žetoni razmišljanja $0.024 / 1K žetonov |
| NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključno200.000 | Strošek Vhod · Vhodni žetoni $0.004 / 1K žetonov Izhod · Izhodni žetoni $0.024 / 1K žetonov Vhod · Branje predpomnilnika $0.0004 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
| NastavitevRazred 2 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot200.000 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.008 / 1K žetonov Izhod · Izhodni žetoni $0.036 / 1K žetonov Vhod · Branje predpomnilnika $0.0008 / 1K žetonov Vhod · Zapis v predpomnilnik $0.00075 / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
{\n "model": "google/gemini-3.1-pro-preview-customtools",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3.1-pro-preview-customtools', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3.1-pro-preview-customtools', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON ali SSE
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohranite vse vsebinske bloke, podpise sklepanja in dejanske ID uporabe orodij. Sestavite vse delne spremembe blokov SSE; prvi besedilni blok ni celoten izhod.
Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan.
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljemodel | Vrstastring |
Poljecontent[] | Vrstatext|thinking|tool_use|other content block |
Poljestop_reason | Vrstastring|null |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Ailoot Ultra google/gemini-3.1-pro-preview-customtools
Uporabite zgoraj navedene poti metod.
Tehnični primer v angleščini
Interpret custom-tool evidence\n\nUse 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.A file-linked proposed edit and an explicitly unexecuted validation step.The answer must not claim that settings.py was changed or a test passed.