Gemini 3.5 Flash on Googlen multimodaalinen Flash-malliprofiili pitkäkestoiseen ohjelmointiin ja agenttityöskentelyyn. Sen dokumentoidut syötteet ovat teksti, kuvat, video, ääni ja PDF-tiedostot, ja tulos on tekstiä. Mallin keskeisiä käyttökohteita ovat iteratiivinen ohjelmointi, vaihtoehtoisten ratkaisujen tutkiminen sekä pitkät ohjeiden noudattamisen ja työkalujen käytön ketjut. 3.5-versio tarjoaa dokumentoidut päättelyn säätömahdollisuudet, multimodaaliset syötteet ja työkaluihin perustuvat työnkulut.
Ohjelmointitehtävässä voidaan yhdistää kirjallinen vaatimus, olennaiset lähdetiedostot ja kuvakaappaus tavoitellusta tuloksesta. Kuvaa havaittu toiminta, odotettu toiminta ja reunaehdot, joiden on säilyttävä muuttumattomina. Havainnollistava tehtävänanto on: ”Vertaa kuvakaappausta komponentin tekstiin, tunnista lomakkeen työnkulussa oleva ristiriita ja ehdota yhtä kohdennettua korjausta. Selitä, mitkä lähdeaineiston yksityiskohdat perustelevat muutoksen.” Anna dokumenttitehtävään olennaiset sivut ja pyydä vertaamaan niitä selkeästi määriteltyihin vaatimuksiin sekä esittämään lähdeviitteet kunkin havainnon tueksi.
Version dokumentaatiossa määritellään päättelytasot minimal, low, medium ja high. Oletustaso on medium, johon on siirrytty Gemini 3 Flash Preview -mallin high-oletustasosta. Minimal sopii yksinkertaisiin vastauksiin ja suoraviivaisiin työkalujen käyttöä koskeviin päätöksiin, mutta se ei takaa päättelyn täydellistä poistamista käytöstä; low on tarkoitettu vähemmän vaiheita vaativiin tehtäviin; high tarjoaa syvempää päättelyä matematiikan, ohjelmoinnin ja agenttityön vaikeisiin ongelmiin. Google suosittelee päättelyn määrän ohjaamiseen thinking_level-asetusta ja näytteenoton oletusasetusten säilyttämistä sen sijaan, että päättelyä yritettäisiin pakottaa muuttamalla temperature-, top-p- tai top-k-asetusta.
Yksi mallin keskeisistä toimintatavoista on päättelykontekstin säilyttäminen usean keskusteluvuoron ajan jatkuvassa tehtävässä. Googlen Interactions-työnkulku välittää tämän kontekstin automaattisesti; GenerateContent-työnkulku puolestaan vaatii koko keskusteluhistorian muuttamattomana, päättelyn allekirjoitukset mukaan lukien. Tämä tukee jatkuvaa virheenjäljitys- tai refaktorointitehtävää, jossa aiempi päättely ohjaa seuraavaa vaihetta. Säilytä keskustelun todellinen rakenne sen sijaan, että muuttaisit jokaisen jatkopyynnön irralliseksi kehotteeksi, ja pidä pyydetty lopputuotos selkeästi määriteltynä työn edetessä.
Dokumentoituun työkalujoukkoon kuuluvat Google Search, Google Mapsiin perustuva lähteistys, File Search, Code Execution, URL Context ja tavanomainen Function Calling. Työkalujen yhteiskäyttö ja Computer Use on merkitty esikatseluvaiheen ominaisuuksiksi. Structured Outputs voi tuottaa määritellyn rakenteen mukaisen tietueen. Määrittele funktioiden tarkoitus ja parametrit selkeästi: malli valitsee funktion, ja siihen liitetty sovellus suorittaa funktion toimenpiteen ja palauttaa tuloksen. Google edellyttää, että funktioiden tulokset vastaavat niitä edeltäviä kutsuja tunnisteiden, nimien ja lukumäärän osalta; multimodaaliset tulokset tulee sisällyttää funktiovastaukseen.
Mallin API-taulukossa syötteen enimmäispituudeksi ilmoitetaan 1 048 576 tokenia ja tuloksen enimmäispituudeksi 65 536 tokenia. Keskusteluhistoria ja annettu media lasketaan mukaan syötebudjettiin. Tälle profiilille on dokumentoitu välimuistin käyttö ja eräkäsittely, ja Googlen taulukossa mainitaan lisäksi Flex- ja Priority-käsittelyvaihtoehdot. Nämä rajat ja ominaisuudet kuvaavat valmistajan versiota; ne eivät edellytä vastauksen olevan enimmäispituinen eivätkä tee jokaisesta työkalusta välttämätöntä tehtävän suorittamiselle.
Tämä profiili tuottaa tekstiä kuvien tai äänen sijaan eikä käytä Live API -rajapintaa. Sen kehittäjäopas sulkee pois myös kuvien segmentoinnin. Pyydä kuvallista aineistoa koskevassa kysymyksessä kuvausta, tietojen poimintaa tai tulkintaa annetusta aineistosta ja puhetallenteesta tekstimuotoista tulosta. Kun vastaus riippuu tuoreemmista tiedoista, dokumentoitu hakutuloksiin perustuva lähteistystyönkulku voi täydentää koulutuksessa saatuja tietoja ulkoisilla lähteillä. Ilmoita, tarvitaanko ulkopuolista tietoa ja mitä näyttöä lopullisessa vastauksessa on säilytettävä.
Hyödyllistä pitkäkestoista tehtävää varten lopputulos ja valmistumiskriteeri on määriteltävä ennen ensimmäistä vaihetta. Tukipalvelun analyysitehtävässä voidaan pyytää taulukkoa, jossa esitetään havaitut ongelmat, niitä tukevat tekstikohdat ja ehdotettu vastaus; ohjelmointitehtävässä voidaan edellyttää kohdennettua muutosta ja siihen liittyvää validointitulosta. Liitä mukaan tehtävän kannalta olennainen lähdekonteksti, määrittele sallitut työkalutoimenpiteet ja pyydä selkeä lopullinen vastaus, jossa valmistunut työ erotetaan kysymyksistä, joihin vastaaminen vaatii vielä lisätietoja. Näin mallin pitkäkestoinen työnkulku muuttuu konkreettiseksi tekstiksi, koodiksi tai rakenteiseksi tuotokseksi.
", "aboutText": "Gemini 3.5 Flash on Googlen multimodaalinen Flash-malliprofiili pitkäkestoiseen ohjelmointiin ja agenttityöskentelyyn. Sen dokumentoidut syötteet ovat teksti, kuvat, video, ääni ja PDF-tiedostot, ja tulos on tekstiä. Mallin keskeisiä käyttökohteita ovat iteratiivinen ohjelmointi, vaihtoehtoisten ratkaisujen tutkiminen sekä pitkät ohjeiden noudattamisen ja työkalujen käytön ketjut. 3.5-versio tarjoaa dokumentoidut päättelyn säätömahdollisuudet, multimodaaliset syötteet ja työkaluihin perustuvat työnkulut.\n\nOhjelmointitehtävässä voidaan yhdistää kirjallinen vaatimus, olennaiset lähdetiedostot ja kuvakaappaus tavoitellusta tuloksesta. Kuvaa havaittu toiminta, odotettu toiminta ja reunaehdot, joiden on säilyttävä muuttumattomina. Havainnollistava tehtävänanto on: ”Vertaa kuvakaappausta komponentin tekstiin, tunnista lomakkeen työnkulussa oleva ristiriita ja ehdota yhtä kohdennettua korjausta. Selitä, mitkä lähdeaineiston yksityiskohdat perustelevat muutoksen.” Anna dokumenttitehtävään olennaiset sivut ja pyydä vertaamaan niitä selkeästi määriteltyihin vaatimuksiin sekä esittämään lähdeviitteet kunkin havainnon tueksi.\n\nVersion dokumentaatiossa määritellään päättelytasot minimal, low, medium ja high. Oletustaso on medium, johon on siirrytty Gemini 3 Flash Preview -mallin high-oletustasosta. Minimal sopii yksinkertaisiin vastauksiin ja suoraviivaisiin työkalujen käyttöä koskeviin päätöksiin, mutta se ei takaa päättelyn täydellistä poistamista käytöstä; low on tarkoitettu vähemmän vaiheita vaativiin tehtäviin; high tarjoaa syvempää päättelyä matematiikan, ohjelmoinnin ja agenttityön vaikeisiin ongelmiin. Google suosittelee päättelyn määrän ohjaamiseen thinking_level-asetusta ja näytteenoton oletusasetusten säilyttämistä sen sijaan, että päättelyä yritettäisiin pakottaa muuttamalla temperature-, top-p- tai top-k-asetusta.\n\nYksi mallin keskeisistä toimintatavoista on päättelykontekstin säilyttäminen usean keskusteluvuoron ajan jatkuvassa tehtävässä. Googlen Interactions-työnkulku välittää tämän kontekstin automaattisesti; GenerateContent-työnkulku puolestaan vaatii koko keskusteluhistorian muuttamattomana, päättelyn allekirjoitukset mukaan lukien. Tämä tukee jatkuvaa virheenjäljitys- tai refaktorointitehtävää, jossa aiempi päättely ohjaa seuraavaa vaihetta. Säilytä keskustelun todellinen rakenne sen sijaan, että muuttaisit jokaisen jatkopyynnön irralliseksi kehotteeksi, ja pidä pyydetty lopputuotos selkeästi määriteltynä työn edetessä.\n\nDokumentoituun työkalujoukkoon kuuluvat Google Search, Google Mapsiin perustuva lähteistys, File Search, Code Execution, URL Context ja tavanomainen Function Calling. Työkalujen yhteiskäyttö ja Computer Use on merkitty esikatseluvaiheen ominaisuuksiksi. Structured Outputs voi tuottaa määritellyn rakenteen mukaisen tietueen. Määrittele funktioiden tarkoitus ja parametrit selkeästi: malli valitsee funktion, ja siihen liitetty sovellus suorittaa funktion toimenpiteen ja palauttaa tuloksen. Google edellyttää, että funktioiden tulokset vastaavat niitä edeltäviä kutsuja tunnisteiden, nimien ja lukumäärän osalta; multimodaaliset tulokset tulee sisällyttää funktiovastaukseen.\n\nMallin API-taulukossa syötteen enimmäispituudeksi ilmoitetaan 1 048 576 tokenia ja tuloksen enimmäispituudeksi 65 536 tokenia. Keskusteluhistoria ja annettu media lasketaan mukaan syötebudjettiin. Tälle profiilille on dokumentoitu välimuistin käyttö ja eräkäsittely, ja Googlen taulukossa mainitaan lisäksi Flex- ja Priority-käsittelyvaihtoehdot. Nämä rajat ja ominaisuudet kuvaavat valmistajan versiota; ne eivät edellytä vastauksen olevan enimmäispituinen eivätkä tee jokaisesta työkalusta välttämätöntä tehtävän suorittamiselle.\n\nTämä profiili tuottaa tekstiä kuvien tai äänen sijaan eikä käytä Live API -rajapintaa. Sen kehittäjäopas sulkee pois myös kuvien segmentoinnin. Pyydä kuvallista aineistoa koskevassa kysymyksessä kuvausta, tietojen poimintaa tai tulkintaa annetusta aineistosta ja puhetallenteesta tekstimuotoista tulosta. Kun vastaus riippuu tuoreemmista tiedoista, dokumentoitu hakutuloksiin perustuva lähteistystyönkulku voi täydentää koulutuksessa saatuja tietoja ulkoisilla lähteillä. Ilmoita, tarvitaanko ulkopuolista tietoa ja mitä näyttöä lopullisessa vastauksessa on säilytettävä.\n\nHyödyllistä pitkäkestoista tehtävää varten lopputulos ja valmistumiskriteeri on määriteltävä ennen ensimmäistä vaihetta. Tukipalvelun analyysitehtävässä voidaan pyytää taulukkoa, jossa esitetään havaitut ongelmat, niitä tukevat tekstikohdat ja ehdotettu vastaus; ohjelmointitehtävässä voidaan edellyttää kohdennettua muutosta ja siihen liittyvää validointitulosta. Liitä mukaan tehtävän kannalta olennainen lähdekonteksti, määrittele sallitut työkalutoimenpiteet ja pyydä selkeä lopullinen vastaus, jossa valmistunut työ erotetaan kysymyksistä, joihin vastaaminen vaatii vielä lisätietoja. Näin mallin pitkäkestoinen työnkulku muuttuu konkreettiseksi tekstiksi, koodiksi tai rakenteiseksi tuotokseksi.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9d4cca5f5d9f7d42a9eb560c32e79c7c01d2902e48a8bf4cab8578879027300e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "google/gemini-3.5-flash:batchGemini 3.5 Flash yhdistää multimodaalisen ymmärtämisen päättelyyn ohjelmointia ja monivaiheisia agenttitehtäviä varten. Se hyväksyy syötteeksi tekstiä, kuvia, videota, ääntä ja PDF-tiedostoja ja tuottaa tekstiä. Sen dokumentoitu profiili tukee rakenteisia tuloksia ja työkalujen käyttöä, ja syötteen enimmäispituus on 1 048 576 tokenia.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Gemini 3.5 Flash on Googlen multimodaalinen Flash-malliprofiili pitkäkestoiseen ohjelmointiin ja agenttityöskentelyyn. Sen dokumentoidut syötteet ovat teksti, kuvat, video, ääni ja PDF-tiedostot, ja tulos on tekstiä. Mallin keskeisiä käyttökohteita ovat iteratiivinen ohjelmointi, vaihtoehtoisten ratkaisujen tutkiminen sekä pitkät ohjeiden noudattamisen ja työkalujen käytön ketjut. 3.5-versio tarjoaa dokumentoidut päättelyn säätömahdollisuudet, multimodaaliset syötteet ja työkaluihin perustuvat työnkulut.
Ohjelmointitehtävässä voidaan yhdistää kirjallinen vaatimus, olennaiset lähdetiedostot ja kuvakaappaus tavoitellusta tuloksesta. Kuvaa havaittu toiminta, odotettu toiminta ja reunaehdot, joiden on säilyttävä muuttumattomina. Havainnollistava tehtävänanto on: ”Vertaa kuvakaappausta komponentin tekstiin, tunnista lomakkeen työnkulussa oleva ristiriita ja ehdota yhtä kohdennettua korjausta. Selitä, mitkä lähdeaineiston yksityiskohdat perustelevat muutoksen.” Anna dokumenttitehtävään olennaiset sivut ja pyydä vertaamaan niitä selkeästi määriteltyihin vaatimuksiin sekä esittämään lähdeviitteet kunkin havainnon tueksi.
Version dokumentaatiossa määritellään päättelytasot minimal, low, medium ja high. Oletustaso on medium, johon on siirrytty Gemini 3 Flash Preview -mallin high-oletustasosta. Minimal sopii yksinkertaisiin vastauksiin ja suoraviivaisiin työkalujen käyttöä koskeviin päätöksiin, mutta se ei takaa päättelyn täydellistä poistamista käytöstä; low on tarkoitettu vähemmän vaiheita vaativiin tehtäviin; high tarjoaa syvempää päättelyä matematiikan, ohjelmoinnin ja agenttityön vaikeisiin ongelmiin. Google suosittelee päättelyn määrän ohjaamiseen thinking_level-asetusta ja näytteenoton oletusasetusten säilyttämistä sen sijaan, että päättelyä yritettäisiin pakottaa muuttamalla temperature-, top-p- tai top-k-asetusta.
Yksi mallin keskeisistä toimintatavoista on päättelykontekstin säilyttäminen usean keskusteluvuoron ajan jatkuvassa tehtävässä. Googlen Interactions-työnkulku välittää tämän kontekstin automaattisesti; GenerateContent-työnkulku puolestaan vaatii koko keskusteluhistorian muuttamattomana, päättelyn allekirjoitukset mukaan lukien. Tämä tukee jatkuvaa virheenjäljitys- tai refaktorointitehtävää, jossa aiempi päättely ohjaa seuraavaa vaihetta. Säilytä keskustelun todellinen rakenne sen sijaan, että muuttaisit jokaisen jatkopyynnön irralliseksi kehotteeksi, ja pidä pyydetty lopputuotos selkeästi määriteltynä työn edetessä.
Dokumentoituun työkalujoukkoon kuuluvat Google Search, Google Mapsiin perustuva lähteistys, File Search, Code Execution, URL Context ja tavanomainen Function Calling. Työkalujen yhteiskäyttö ja Computer Use on merkitty esikatseluvaiheen ominaisuuksiksi. Structured Outputs voi tuottaa määritellyn rakenteen mukaisen tietueen. Määrittele funktioiden tarkoitus ja parametrit selkeästi: malli valitsee funktion, ja siihen liitetty sovellus suorittaa funktion toimenpiteen ja palauttaa tuloksen. Google edellyttää, että funktioiden tulokset vastaavat niitä edeltäviä kutsuja tunnisteiden, nimien ja lukumäärän osalta; multimodaaliset tulokset tulee sisällyttää funktiovastaukseen.
Mallin API-taulukossa syötteen enimmäispituudeksi ilmoitetaan 1 048 576 tokenia ja tuloksen enimmäispituudeksi 65 536 tokenia. Keskusteluhistoria ja annettu media lasketaan mukaan syötebudjettiin. Tälle profiilille on dokumentoitu välimuistin käyttö ja eräkäsittely, ja Googlen taulukossa mainitaan lisäksi Flex- ja Priority-käsittelyvaihtoehdot. Nämä rajat ja ominaisuudet kuvaavat valmistajan versiota; ne eivät edellytä vastauksen olevan enimmäispituinen eivätkä tee jokaisesta työkalusta välttämätöntä tehtävän suorittamiselle.
Tämä profiili tuottaa tekstiä kuvien tai äänen sijaan eikä käytä Live API -rajapintaa. Sen kehittäjäopas sulkee pois myös kuvien segmentoinnin. Pyydä kuvallista aineistoa koskevassa kysymyksessä kuvausta, tietojen poimintaa tai tulkintaa annetusta aineistosta ja puhetallenteesta tekstimuotoista tulosta. Kun vastaus riippuu tuoreemmista tiedoista, dokumentoitu hakutuloksiin perustuva lähteistystyönkulku voi täydentää koulutuksessa saatuja tietoja ulkoisilla lähteillä. Ilmoita, tarvitaanko ulkopuolista tietoa ja mitä näyttöä lopullisessa vastauksessa on säilytettävä.
Hyödyllistä pitkäkestoista tehtävää varten lopputulos ja valmistumiskriteeri on määriteltävä ennen ensimmäistä vaihetta. Tukipalvelun analyysitehtävässä voidaan pyytää taulukkoa, jossa esitetään havaitut ongelmat, niitä tukevat tekstikohdat ja ehdotettu vastaus; ohjelmointitehtävässä voidaan edellyttää kohdennettua muutosta ja siihen liittyvää validointitulosta. Liitä mukaan tehtävän kannalta olennainen lähdekonteksti, määrittele sallitut työkalutoimenpiteet ja pyydä selkeä lopullinen vastaus, jossa valmistunut työ erotetaan kysymyksistä, joihin vastaaminen vaatii vielä lisätietoja. Näin mallin pitkäkestoinen työnkulku muuttuu konkreettiseksi tekstiksi, koodiksi tai rakenteiseksi tuotokseksi.
POST /v1/batchestexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttäendpoint | Tyyppistring | VaatimusPakollinen | Arvot & rajat /v1/chat/completions | Oletus— |
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat google/gemini-3.5-flash:batch | Oletus— |
Kenttärequests | Tyyppibatch_item[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttärequests[].custom_id | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttärequests[].body.messages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäcompletion_window | Tyyppistring | VaatimusValinnainen | Arvot & rajat 24h | Oletus— |
Kenttäprovider | Tyyppiobject|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttärequests[].body.model | Tyyppistring | VaatimusValinnainen | Arvot & rajat google/gemini-3.5-flash:batch, google/gemini-3.5-flash | Oletus— |
Kenttäprovider.only | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat google-vertex/global | Oletus— |
Kenttäprovider.allow_fallbacks | Tyyppiboolean|null | VaatimusValinnainen | Arvot & rajat false, null | Oletus— |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusendpoint, model, requests |
Parametrimaterial_types | Sopimustext |
Parametrirepresentation | Sopimuspyyntöön sisältyvä requests[]; jokaisella alkiolla on custom_id ja body |
Parametrirequest_endpoint_profile | Sopimus/v1/chat/completions |
Parametrifile_material | SopimusKutsuja voi lukea todellisen UTF-8 JSONL -aineiston paikallisesti requests[]-taulukkoon. Latauksen purpose-arvoa, input_file_id-arvoa tai tiedostoviitettä ei käytetä. Puuttuva tai tyhjä asiakkaan aineisto keskeyttää valmistelun ennen POST-pyyntöä. |
Parametriserialization_order | Sopimusendpoint, model, provider (jos annettu), completion_window (jos annettu), requests viimeisenä |
Parametrioptional_controls | Sopimusprovider.only, provider.allow_fallbacks, completion_window |
Parametrischema_scope | SopimusTekstimuotoiset Chat Completions -pyyntörungot dokumentoidussa pyyntöön sisältyvässä Batch-kääreessä. |
Elinkaari: asynchronous
GET /v1/batches/{operation_id} · alkuperäisen luontivastauksen todellinen response.id; sama käyttäjä, avain ja ryhmä
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.0015 / 1K tokenia Tuloste · Tulostokenit $0.009 / 1K tokenia Syöte · Välimuistin luku $0.00015 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.0015 / 1K tokenia Tuloste · Tulostokenit $0.009 / 1K tokenia Syöte · Välimuistin luku $0.00015 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.5-flash:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n if supplied_model is not None and supplied_model not in ['google/gemini-3.5-flash:batch', 'google/gemini-3.5-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.5-flash:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nvastaukseen sisältyvä JSON kentässä results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nSäilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä koko alkuperäinen tilatiedot sisältävä JSON, jokainen tulos ja custom_id sekä täydellinen vastaus- tai virherunko. Tallenna valmistuneet results[]-tulokset JSONL-muodossa suodattamatta.
Säilytä alkuperäinen operaation ID. 503 result_pending_check sisältää otsakkeen X-Should-Retry:false; älä koskaan lähetä uudelleen alkuperäistä eräajoa, jonka tila on tuntematon.
| Kenttä | Tyyppi |
|---|---|
Kenttäresults[].custom_id | Tyyppistring |
Kenttäresults[].response.body.choices[].message.content | Tyyppistring|null |
Kenttäresults[].error | Tyyppiobject|null |
Kenttäusage | Tyyppiobject|null |
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäendpoint | Tyyppistring |
Kenttästatus | Tyyppistring |
Kenttärequest_counts | Tyyppiobject |
Kenttäresults[].id | Tyyppistring |
Kenttäresults[].response.status_code | Tyyppiinteger |
Kenttäresults[].response.request_id | Tyyppistring |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoDokumentoitu pyyntöön sisältyvä kääre on virheellinen, avaimet ovat päällekkäisiä, alkion identiteetti on virheellinen tai määritetyt mallin ominaisuudet ovat ristiriidassa. | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta lähetystä. |
Vastaus401 · authentication_error | EhtoVirheellinen API-avain. | Seuraava vaiheKäytä valtuutettua Ailoot-avainta. |
Vastaus403 · permission_error | EhtoEräajoryhmä ei ole käytettävissä. | Seuraava vaiheTarkista avaimen ja ryhmän käyttöoikeudet. |
Vastaus422 · invalid_request_error | EhtoEräajo laskutetaan saldosta; tilauspohjaisella laskutuksella tehty eräajon luontipyyntö hylätään. | Seuraava vaiheKäytä valtuutettua saldosta laskutettavaa ryhmää. |
Vastaus422 · price_unavailable | EhtoEräajon syötteelle ei voida laskea hinta-arviota. | Seuraava vaiheSäilytä vastaus; käytä dokumentoitua API-perheen syötettä. |
Vastaus402 · billing_error | EhtoEräajon varaus ei ole käytettävissä. | Seuraava vaihePoista pyynnön hyväksymisen esteet ennen uutta pyyntöä. |
Vastaus503 · price_unavailable | EhtoEräajomenetelmän hinta tai natiivit hinnat eivät ole käytettävissä. | Seuraava vaiheSäilytä vastaus; älä korvaa hintoja toisilla. |
Vastaus503 · api_error | EhtoTäsmällinen toimittajan reitti ei ole käytettävissä. | Seuraava vaiheSäilytä vastaus reitin korjaamista varten. |
Vastaus503 · result_pending_check | EhtoAlkuperäinen tulos edellyttää tarkistusta; X-Should-Retry:false. | Seuraava vaiheSäilytä alkuperäinen operation_id/id ja lue sen tila; älä koskaan toista alkuperäistä POST-pyyntöä. |
Vastaus404 · not_found | EhtoEräajon tilan operaatiota ei ole tai se kuuluu toiselle identiteetille. | Seuraava vaiheKäytä täsmälleen alkuperäistä id-arvoa sekä samaa käyttäjää, avainta ja ryhmää. |
Ailoot Ultra google/gemini-3.5-flash:batch
Käytä yllä näytettyjä menetelmäpolkuja.