Gemini 3 Flash Preview on Googlen päättelymalli multimodaaliseen ymmärtämiseen, ohjelmointiin ja agenttitehtäviin. Se vastaanottaa tekstiä, kuvia, videota, ääntä ja PDF-aineistoa ja palauttaa tekstiä. Pyyntöön voi siten yhdistää kirjalliset ohjeet, lähdetiedostot, visuaaliset havainnot ja keskusteluhistorian yhden ongelman ympärille. Tuloksena voi olla näihin aineistoihin perustuva selitys, koodiehdotus, poimittu tieto tai suunnitelma luodun kuvan tai puhutun vastauksen sijaan.
Tämän mallin mallikortti ilmoittaa syötteen rajaksi 1 048 576 tokenia ja tulosteen rajaksi 65 536 tokenia. Suunnittele lähdeaineisto ja tulos erikseen: pitkä ote koodivarastosta, asiakirjakokoelma tai tallenne mahtuu mukaan vain, jos sen käsitelty esitysmuoto ja ohjeet mahtuvat syötebudjettiin, ja vastaukselle tarvitaan silti oma pituusvarauksensa. Merkitse toisiinsa liittyvät lähteet tunnisteilla ja määritä, mikä aineisto on määräävä. Pitkissä kehotteissa kehittäjäopas suosittelee sijoittamaan täsmällisen kysymyksen aineiston jälkeen ja sitomaan sen nimenomaisesti edellä annettuihin tietoihin.
Ajattelu on dynaamista, ja tämän mallin dokumentoitu oletustaso on high. Tuetut tasot ovat minimal, low, medium ja high. Ne ovat suhteellisia päättelyvarauksia, eivät taattuja tokenimääriä. Minimal-tasollakin vaikean ohjelmointiongelman käsittely voi sisältää jonkin verran päättelyä. Valitse taso tehtävän mukaan: lyhyt muunnos ja useita ehtoja sisältävä virheenjäljitysongelma tarvitsevat erilaisen käsittelyn. Käytä suoria, selkeitä ohjeita sen sijaan, että pakottaisit kehotteeseen monimutkaisia päättelyrituaaleja; pyydä lopullinen tuotos ja tarkistukset, jotka tekevät siitä käyttökelpoisen.
Valmistajan mallikortti luettelee rakenteiset tulosteet, funktiokutsut, koodin suorittamisen, tietokoneen käytön, tiedostohaun, hakutuloksiin ankkuroinnin, Google Maps -tietoihin ankkuroinnin, URL-kontekstin ja välimuistin. Sisäänrakennettuja työkaluja voi yhdistää mukautettuihin funktiokutsuihin dokumentoidussa Gemini 3 -kulussa. Sovellus määrittelee funktiot, tarkistaa niiden argumentit, suorittaa hyväksytyt toiminnot ja palauttaa tulokset. Koodiavustajalle tiedostonlukutyökalu tai hallittu testien suorittaja voi tuottaa konkreettista näyttöä seuraavaa vaihetta varten. Ehdotettu toiminto ja havaittu työkalutulos tulee pitää erillään loppuraportissa.
Anna ohjelmointitehtävään olennaiset tiedostot, kieli, odotettu toiminta ja ongelman havainnollistava syöte. Rajaa muutos ja nimeä rajapinta tai toiminta, joka on säilytettävä. Pyydä korjattu toteutus ja tarkistettavat tapaukset. Määritä asiakirjojen analysointitehtävään kysymys, vaaditut kentät ja lähdeviitteet. Jos käytät rakenteista tulostetta, anna skeema, jossa kenttien merkitykset ja puuttuvien arvojen käsittelysäännöt ovat selkeät. Tarkista sekä syntaksi että se, seuraako kukin arvo alkuperäisestä aineistosta.
Määritä multimodaalisessa analyysissä, mikä kussakin lähteessä on olennaista. Kuvakaappaus voi tukea käyttöliittymän selitystä, PDF voi sisältää taulukon tai kaavion, ja tallenne voi tarjota puhuttuja tai näkyviä tapahtumia. Kehittäjäopas käsittelee median tarkkuusasetuksia, koska yksityiskohtaisuus muuttaa käsiteltyä esitysmuotoa ja tokenien käyttöä. Valmistajan koodinsuoritustyönkulku voi rajata tai suurentaa annettuja kuvia, tehdä laskelmia visuaalisesta aineistosta ja lisätä merkintöjä ennen kuin malli laatii vastauksensa. Pienen tekstin lukeminen voi vaatia eri asetuksen kuin yleinen näkymän kuvaus. Pidä olennainen sivu, kuva tai leike saatavilla havaintojen tarkistamista varten sen sijaan, että pitäisit sujuvaa yhteenvetoa näyttönä siitä, että jokainen yksityiskohta luettiin oikein.
Keskustelun ja työkalujen tila on säilytettävä valitussa rajapinnassa. Gemini 3 käyttää ajatteluallekirjoituksia päättelykontekstin siirtämiseen kutsujen välillä; kehittäjäopas erottaa hallitun tilallisen historian käsin hallittavasta tilattomasta historiasta. Säilytä tarvittava konteksti, kun jatkat työkalutehtävää tai korjaat tulosta. Google suosittelee myös säilyttämään lämpötilan oletusarvossa 1,0 sen sijaan, että käyttäisit muualta tuotua matalan lämpötilan ohjetta, joka voi aiheuttaa silmukoita tai heikentää toimintaa monimutkaisissa tehtävissä. Nämä ovat valmistajan integraatiokäytäntöjä, eivät uusia väitteitä minkään tietyn sovelluksen tiedonsiirtotavasta.
Tekstimallin ominaisuuksiksi ei ilmoiteta kuvan tai äänen luontia eikä Live API -rajapintaa. Opas erottaa myös visuaalisen ymmärtämisen pikselitason kuvasegmentoinnista, joka ei kuulu Gemini 3 Flashin tukemiin ominaisuuksiin. Valitse varsinaiseen tehtävään sopiva lopputulos: lähteisiin viittaavat havainnot, rakenteinen tietue, koodimuutos tai päätös, jonka oletukset on ilmaistu. Tarkista laskutoimitukset, varmista koodi tarkoitetussa ympäristössä ja käy läpi palautetut työkalutiedot. Kun ajankohtaisilla tiedoilla on merkitystä, käytä määritettyjä ankkurointilähteitä tai annettua ajantasaista aineistoa sen sijaan, että olettaisit mallin tietämyksen olevan reaaliaikainen tietokanta.
", "aboutText": "Gemini 3 Flash Preview on Googlen päättelymalli multimodaaliseen ymmärtämiseen, ohjelmointiin ja agenttitehtäviin. Se vastaanottaa tekstiä, kuvia, videota, ääntä ja PDF-aineistoa ja palauttaa tekstiä. Pyyntöön voi siten yhdistää kirjalliset ohjeet, lähdetiedostot, visuaaliset havainnot ja keskusteluhistorian yhden ongelman ympärille. Tuloksena voi olla näihin aineistoihin perustuva selitys, koodiehdotus, poimittu tieto tai suunnitelma luodun kuvan tai puhutun vastauksen sijaan.\n\nTämän mallin mallikortti ilmoittaa syötteen rajaksi 1 048 576 tokenia ja tulosteen rajaksi 65 536 tokenia. Suunnittele lähdeaineisto ja tulos erikseen: pitkä ote koodivarastosta, asiakirjakokoelma tai tallenne mahtuu mukaan vain, jos sen käsitelty esitysmuoto ja ohjeet mahtuvat syötebudjettiin, ja vastaukselle tarvitaan silti oma pituusvarauksensa. Merkitse toisiinsa liittyvät lähteet tunnisteilla ja määritä, mikä aineisto on määräävä. Pitkissä kehotteissa kehittäjäopas suosittelee sijoittamaan täsmällisen kysymyksen aineiston jälkeen ja sitomaan sen nimenomaisesti edellä annettuihin tietoihin.\n\nAjattelu on dynaamista, ja tämän mallin dokumentoitu oletustaso on high. Tuetut tasot ovat minimal, low, medium ja high. Ne ovat suhteellisia päättelyvarauksia, eivät taattuja tokenimääriä. Minimal-tasollakin vaikean ohjelmointiongelman käsittely voi sisältää jonkin verran päättelyä. Valitse taso tehtävän mukaan: lyhyt muunnos ja useita ehtoja sisältävä virheenjäljitysongelma tarvitsevat erilaisen käsittelyn. Käytä suoria, selkeitä ohjeita sen sijaan, että pakottaisit kehotteeseen monimutkaisia päättelyrituaaleja; pyydä lopullinen tuotos ja tarkistukset, jotka tekevät siitä käyttökelpoisen.\n\nValmistajan mallikortti luettelee rakenteiset tulosteet, funktiokutsut, koodin suorittamisen, tietokoneen käytön, tiedostohaun, hakutuloksiin ankkuroinnin, Google Maps -tietoihin ankkuroinnin, URL-kontekstin ja välimuistin. Sisäänrakennettuja työkaluja voi yhdistää mukautettuihin funktiokutsuihin dokumentoidussa Gemini 3 -kulussa. Sovellus määrittelee funktiot, tarkistaa niiden argumentit, suorittaa hyväksytyt toiminnot ja palauttaa tulokset. Koodiavustajalle tiedostonlukutyökalu tai hallittu testien suorittaja voi tuottaa konkreettista näyttöä seuraavaa vaihetta varten. Ehdotettu toiminto ja havaittu työkalutulos tulee pitää erillään loppuraportissa.\n\nAnna ohjelmointitehtävään olennaiset tiedostot, kieli, odotettu toiminta ja ongelman havainnollistava syöte. Rajaa muutos ja nimeä rajapinta tai toiminta, joka on säilytettävä. Pyydä korjattu toteutus ja tarkistettavat tapaukset. Määritä asiakirjojen analysointitehtävään kysymys, vaaditut kentät ja lähdeviitteet. Jos käytät rakenteista tulostetta, anna skeema, jossa kenttien merkitykset ja puuttuvien arvojen käsittelysäännöt ovat selkeät. Tarkista sekä syntaksi että se, seuraako kukin arvo alkuperäisestä aineistosta.\n\nMääritä multimodaalisessa analyysissä, mikä kussakin lähteessä on olennaista. Kuvakaappaus voi tukea käyttöliittymän selitystä, PDF voi sisältää taulukon tai kaavion, ja tallenne voi tarjota puhuttuja tai näkyviä tapahtumia. Kehittäjäopas käsittelee median tarkkuusasetuksia, koska yksityiskohtaisuus muuttaa käsiteltyä esitysmuotoa ja tokenien käyttöä. Valmistajan koodinsuoritustyönkulku voi rajata tai suurentaa annettuja kuvia, tehdä laskelmia visuaalisesta aineistosta ja lisätä merkintöjä ennen kuin malli laatii vastauksensa. Pienen tekstin lukeminen voi vaatia eri asetuksen kuin yleinen näkymän kuvaus. Pidä olennainen sivu, kuva tai leike saatavilla havaintojen tarkistamista varten sen sijaan, että pitäisit sujuvaa yhteenvetoa näyttönä siitä, että jokainen yksityiskohta luettiin oikein.\n\nKeskustelun ja työkalujen tila on säilytettävä valitussa rajapinnassa. Gemini 3 käyttää ajatteluallekirjoituksia päättelykontekstin siirtämiseen kutsujen välillä; kehittäjäopas erottaa hallitun tilallisen historian käsin hallittavasta tilattomasta historiasta. Säilytä tarvittava konteksti, kun jatkat työkalutehtävää tai korjaat tulosta. Google suosittelee myös säilyttämään lämpötilan oletusarvossa 1,0 sen sijaan, että käyttäisit muualta tuotua matalan lämpötilan ohjetta, joka voi aiheuttaa silmukoita tai heikentää toimintaa monimutkaisissa tehtävissä. Nämä ovat valmistajan integraatiokäytäntöjä, eivät uusia väitteitä minkään tietyn sovelluksen tiedonsiirtotavasta.\n\nTekstimallin ominaisuuksiksi ei ilmoiteta kuvan tai äänen luontia eikä Live API -rajapintaa. Opas erottaa myös visuaalisen ymmärtämisen pikselitason kuvasegmentoinnista, joka ei kuulu Gemini 3 Flashin tukemiin ominaisuuksiin. Valitse varsinaiseen tehtävään sopiva lopputulos: lähteisiin viittaavat havainnot, rakenteinen tietue, koodimuutos tai päätös, jonka oletukset on ilmaistu. Tarkista laskutoimitukset, varmista koodi tarkoitetussa ympäristössä ja käy läpi palautetut työkalutiedot. Kun ajankohtaisilla tiedoilla on merkitystä, käytä määritettyjä ankkurointilähteitä tai annettua ajantasaista aineistoa sen sijaan, että olettaisit mallin tietämyksen olevan reaaliaikainen tietokanta.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8f1d9a9d40808ef4b49f070905a83be6726ee728b04faf24402fae404ea5ba56", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "google/gemini-3-flash-preview:batchGemini 3 Flash Preview yhdistää multimodaalisen ymmärtämisen ja päättelyn tekstimuotoiseen tulosteeseen. Se tukee koodin, asiakirjojen ja visuaalisen aineiston analysointia, rakenteisia tuloksia ja työkaluihin perustuvia työnkulkuja. Analyysin syvyyden valintaan on neljä dokumentoitua ajattelutasoa.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Gemini 3 Flash Preview on Googlen päättelymalli multimodaaliseen ymmärtämiseen, ohjelmointiin ja agenttitehtäviin. Se vastaanottaa tekstiä, kuvia, videota, ääntä ja PDF-aineistoa ja palauttaa tekstiä. Pyyntöön voi siten yhdistää kirjalliset ohjeet, lähdetiedostot, visuaaliset havainnot ja keskusteluhistorian yhden ongelman ympärille. Tuloksena voi olla näihin aineistoihin perustuva selitys, koodiehdotus, poimittu tieto tai suunnitelma luodun kuvan tai puhutun vastauksen sijaan.
Tämän mallin mallikortti ilmoittaa syötteen rajaksi 1 048 576 tokenia ja tulosteen rajaksi 65 536 tokenia. Suunnittele lähdeaineisto ja tulos erikseen: pitkä ote koodivarastosta, asiakirjakokoelma tai tallenne mahtuu mukaan vain, jos sen käsitelty esitysmuoto ja ohjeet mahtuvat syötebudjettiin, ja vastaukselle tarvitaan silti oma pituusvarauksensa. Merkitse toisiinsa liittyvät lähteet tunnisteilla ja määritä, mikä aineisto on määräävä. Pitkissä kehotteissa kehittäjäopas suosittelee sijoittamaan täsmällisen kysymyksen aineiston jälkeen ja sitomaan sen nimenomaisesti edellä annettuihin tietoihin.
Ajattelu on dynaamista, ja tämän mallin dokumentoitu oletustaso on high. Tuetut tasot ovat minimal, low, medium ja high. Ne ovat suhteellisia päättelyvarauksia, eivät taattuja tokenimääriä. Minimal-tasollakin vaikean ohjelmointiongelman käsittely voi sisältää jonkin verran päättelyä. Valitse taso tehtävän mukaan: lyhyt muunnos ja useita ehtoja sisältävä virheenjäljitysongelma tarvitsevat erilaisen käsittelyn. Käytä suoria, selkeitä ohjeita sen sijaan, että pakottaisit kehotteeseen monimutkaisia päättelyrituaaleja; pyydä lopullinen tuotos ja tarkistukset, jotka tekevät siitä käyttökelpoisen.
Valmistajan mallikortti luettelee rakenteiset tulosteet, funktiokutsut, koodin suorittamisen, tietokoneen käytön, tiedostohaun, hakutuloksiin ankkuroinnin, Google Maps -tietoihin ankkuroinnin, URL-kontekstin ja välimuistin. Sisäänrakennettuja työkaluja voi yhdistää mukautettuihin funktiokutsuihin dokumentoidussa Gemini 3 -kulussa. Sovellus määrittelee funktiot, tarkistaa niiden argumentit, suorittaa hyväksytyt toiminnot ja palauttaa tulokset. Koodiavustajalle tiedostonlukutyökalu tai hallittu testien suorittaja voi tuottaa konkreettista näyttöä seuraavaa vaihetta varten. Ehdotettu toiminto ja havaittu työkalutulos tulee pitää erillään loppuraportissa.
Anna ohjelmointitehtävään olennaiset tiedostot, kieli, odotettu toiminta ja ongelman havainnollistava syöte. Rajaa muutos ja nimeä rajapinta tai toiminta, joka on säilytettävä. Pyydä korjattu toteutus ja tarkistettavat tapaukset. Määritä asiakirjojen analysointitehtävään kysymys, vaaditut kentät ja lähdeviitteet. Jos käytät rakenteista tulostetta, anna skeema, jossa kenttien merkitykset ja puuttuvien arvojen käsittelysäännöt ovat selkeät. Tarkista sekä syntaksi että se, seuraako kukin arvo alkuperäisestä aineistosta.
Määritä multimodaalisessa analyysissä, mikä kussakin lähteessä on olennaista. Kuvakaappaus voi tukea käyttöliittymän selitystä, PDF voi sisältää taulukon tai kaavion, ja tallenne voi tarjota puhuttuja tai näkyviä tapahtumia. Kehittäjäopas käsittelee median tarkkuusasetuksia, koska yksityiskohtaisuus muuttaa käsiteltyä esitysmuotoa ja tokenien käyttöä. Valmistajan koodinsuoritustyönkulku voi rajata tai suurentaa annettuja kuvia, tehdä laskelmia visuaalisesta aineistosta ja lisätä merkintöjä ennen kuin malli laatii vastauksensa. Pienen tekstin lukeminen voi vaatia eri asetuksen kuin yleinen näkymän kuvaus. Pidä olennainen sivu, kuva tai leike saatavilla havaintojen tarkistamista varten sen sijaan, että pitäisit sujuvaa yhteenvetoa näyttönä siitä, että jokainen yksityiskohta luettiin oikein.
Keskustelun ja työkalujen tila on säilytettävä valitussa rajapinnassa. Gemini 3 käyttää ajatteluallekirjoituksia päättelykontekstin siirtämiseen kutsujen välillä; kehittäjäopas erottaa hallitun tilallisen historian käsin hallittavasta tilattomasta historiasta. Säilytä tarvittava konteksti, kun jatkat työkalutehtävää tai korjaat tulosta. Google suosittelee myös säilyttämään lämpötilan oletusarvossa 1,0 sen sijaan, että käyttäisit muualta tuotua matalan lämpötilan ohjetta, joka voi aiheuttaa silmukoita tai heikentää toimintaa monimutkaisissa tehtävissä. Nämä ovat valmistajan integraatiokäytäntöjä, eivät uusia väitteitä minkään tietyn sovelluksen tiedonsiirtotavasta.
Tekstimallin ominaisuuksiksi ei ilmoiteta kuvan tai äänen luontia eikä Live API -rajapintaa. Opas erottaa myös visuaalisen ymmärtämisen pikselitason kuvasegmentoinnista, joka ei kuulu Gemini 3 Flashin tukemiin ominaisuuksiin. Valitse varsinaiseen tehtävään sopiva lopputulos: lähteisiin viittaavat havainnot, rakenteinen tietue, koodimuutos tai päätös, jonka oletukset on ilmaistu. Tarkista laskutoimitukset, varmista koodi tarkoitetussa ympäristössä ja käy läpi palautetut työkalutiedot. Kun ajankohtaisilla tiedoilla on merkitystä, käytä määritettyjä ankkurointilähteitä tai annettua ajantasaista aineistoa sen sijaan, että olettaisit mallin tietämyksen olevan reaaliaikainen tietokanta.
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-flash-preview: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-flash-preview:batch, google/gemini-3-flash-preview | 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.0005 / 1K tokenia Tuloste · Tulostokenit $0.003 / 1K tokenia Syöte · Välimuistin luku — / 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.0005 / 1K tokenia Tuloste · Tulostokenit $0.003 / 1K tokenia Syöte · Välimuistin luku — / 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-flash-preview: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-flash-preview:batch', 'google/gemini-3-flash-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3-flash-preview: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-flash-preview:batch
Käytä yllä näytettyjä menetelmäpolkuja.