Gemini 3.8 Flash on Googlen tekstiä tuottava malli pitkäjänteiseen ohjelmistokehitykseen, monivaiheisiin agentteihin ja monimutkaisiin tietotyön prosesseihin. Se pohjautuu Gemini 3.7 Flashiin ja sisältää parannuksia ohjelmistokehitykseen ja agenttipohjaiseen tietotyöhön. Se ottaa syötteenä vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja, joten tehtävässä voidaan yhdistää kirjallinen tavoite sen ratkaisemiseen tarvittavaan varsinaiseen aineistoon. Käyttökelpoinen lopputulos voi olla koodimuutos, analyysi selityksineen, kirjallinen vastaus tai rakenteinen tietue.
Anna ohjelmointitehtävää varten vaatimus, olennaiset tiedostot, kuvaus havaitusta toiminnasta ja reunaehdot, joiden on säilyttävä voimassa. Kuvakaappaus voi havainnollistaa tavoiteltua käyttöliittymää, kun taas lokit tai virheen toistava esimerkki osoittavat vian. Pyydä virheenjäljitystehtävässä mallia jäljittämään lomakkeen näkyvän tilan ja sen tallennetun arvon välinen ristiriita, tunnistamaan siitä vastaava koodipolku ja ehdottamaan kohdennettua korjausta. Pidä tavoiteltu lopputuotos selkeästi määriteltynä, jotta pitkälläkin selvitystyön ja työkalujen käytön sarjalla on täsmällinen valmistumiskriteeri.
Jaa päättely pienempiin vaiheisiin, tee työkalukutsuja iteratiivisesti ja tarkista välitulokset, kun työ jatkuu pidempään. Päättelyn tasot low, medium ja high säätelevät päättelyn määrää; medium on dokumentoitu oletustaso. Taso low sopii nopeaan luonnosteluun tai rajattuun analyysiin, kun taas high on tarkoitettu vaikeaan matematiikkaan, ohjelmointiin tai monivaiheisiin tehtäviin. Gemini 3.8 Flash ei tue päättelytasoa minimal. Pitkäkestoiseen virheenjäljitykseen ja suoraviivaiseen kenttien poimintaan on siis valittava erilaiset päättelyasetukset sen sijaan, että kaikissa pyynnöissä käytettäisiin samaa asetusta.
Dokumentoituihin työkaluihin kuuluvat funktiokutsut, koodin suorittaminen, tiedostohaku, hakulähteisiin ankkurointi, Google Mapsin tietoihin ankkurointi ja URL-konteksti. Computer Use on merkitty esikatseluvaiheen ominaisuudeksi. Rakenteiset tulosteet määrittävät tulokselle koneluettavan muodon. Funktioille tulee määritellä selkeä tarkoitus ja parametrit: malli voi pyytää funktion kutsumista, kun taas siihen liitetty sovellus suorittaa toiminnon ja palauttaa tuloksen. Säilytä funktioiden tunnisteet ja niiden tosiasiassa palauttama aineisto keskusteluvuorosta toiseen. Hyödyllinen loppuvastaus kertoo, mihin näyttöön ehdotettu korjaus tai poimittu arvo perustuu.
Version 3.8 siirtymäoppaassa käytetään päättelytason asetuksia aiempien päättelybudjetin asetusten sijaan ja kehotetaan poistamaan vanhentuneet otantaparametrit sekä esitäytetyt mallin vastausvuorot. Opas edellyttää myös, että kyseisessä tilattomassa työnkulussa säilytetään päättelyn allekirjoitukset (thought signatures) ja että funktioiden vastaukset kohdistetaan kutsuihinsa tunnisteen ja nimen perusteella. Nämä seikat ovat tärkeitä monivaiheista tehtävää jatkettaessa: seuraava vuoro tarvitsee todellisen aiemman kontekstin, ei uudelleen kirjoitettua selostusta, josta työkalun tulos tai allekirjoitus puuttuu. Ilmaise uudessa käyttäjäviestissä selkeästi sekä kysymys että haluttu tuloste.
Määritä monimodaalisessa tietotyössä olennaiset asiakirjan sivut, kaavio, äänitallenteen aikaväli tai videon tapahtuma ja kerro, miten niitä tulee käyttää vastauksessa. Asiakirjoja vertailtaessa voi pyytää eroja kuvaavan taulukon lähdekatkelmineen; kaaviota koskevassa kysymyksessä voi pyytää näkyvät arvot ja niiden tukeman johtopäätöksen. Videoanalyysissä voi pyytää kuvaamaan tapahtumat, joihin havainto perustuu. Malli tuottaa näiden syötteiden perusteella tekstiä. Kuvien ja puheen generointi sekä Live-äänivuorovaikutus kuuluvat erillisiin malliprofiileihin.
Mallin Gemini API -rajat ovat 1 048 576 syötetokenia ja 65 536 tulostetokenia. Nämä vastaavat natiivin mallin enintään 1M:n kokoista kontekstia ja 64K:n mittaista tekstitulostetta. Ohjeet, keskusteluhistoria ja syötteenä annettu media kuluttavat syötekontekstia, ja päättelyn tai pitkän lopputuotoksen on mahduttava dokumentoituun tulosterajaan. Googlen tarjoamassa malliprofiilissa mainitaan myös välimuistin käyttö, eräkäsittely sekä Flex- ja Priority-käsittely. Säilytä erillisille kohteille pysyvä kohdetunniste ja määritä tulosmuoto yksiselitteisesti, jotta jokainen tulos pysyy yhdistettävissä lähteeseensä.
Mahdollisia rajoituksia ovat hallusinaatiot, ajoittainen hitaus tai aikakatkaisut sekä suurempi tokenien kulutus, kun päättelyyn käytetään enemmän resursseja. Mallin tietojen ajallinen takaraja on maaliskuu 2026, mutta joillakin aloilla tiedot ulottuvat edelleen vain tammikuuhun 2025. Anna ajantasaista lähdeaineistoa tai käytä dokumentoituja lähteisiin ankkuroinnin työkaluja, kun tehtävä riippuu tätä myöhemmistä tiedoista. Tarkista lähdeviitteet, laskelmat ja ehdotettu koodi vertaamalla niitä varsinaisiin syötteisiin ja suoritustuloksiin. Käyttökelpoisessa lopputuotoksessa tulee erottaa näytön tukema havainto ratkaisemattomasta kysymyksestä. Sujuvaa vastausta ei pidä sellaisenaan pitää osoituksena siitä, että pyydetty lopputulos on saavutettu.
", "aboutText": "Gemini 3.8 Flash on Googlen tekstiä tuottava malli pitkäjänteiseen ohjelmistokehitykseen, monivaiheisiin agentteihin ja monimutkaisiin tietotyön prosesseihin. Se pohjautuu Gemini 3.7 Flashiin ja sisältää parannuksia ohjelmistokehitykseen ja agenttipohjaiseen tietotyöhön. Se ottaa syötteenä vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja, joten tehtävässä voidaan yhdistää kirjallinen tavoite sen ratkaisemiseen tarvittavaan varsinaiseen aineistoon. Käyttökelpoinen lopputulos voi olla koodimuutos, analyysi selityksineen, kirjallinen vastaus tai rakenteinen tietue.\n\nAnna ohjelmointitehtävää varten vaatimus, olennaiset tiedostot, kuvaus havaitusta toiminnasta ja reunaehdot, joiden on säilyttävä voimassa. Kuvakaappaus voi havainnollistaa tavoiteltua käyttöliittymää, kun taas lokit tai virheen toistava esimerkki osoittavat vian. Pyydä virheenjäljitystehtävässä mallia jäljittämään lomakkeen näkyvän tilan ja sen tallennetun arvon välinen ristiriita, tunnistamaan siitä vastaava koodipolku ja ehdottamaan kohdennettua korjausta. Pidä tavoiteltu lopputuotos selkeästi määriteltynä, jotta pitkälläkin selvitystyön ja työkalujen käytön sarjalla on täsmällinen valmistumiskriteeri.\n\nJaa päättely pienempiin vaiheisiin, tee työkalukutsuja iteratiivisesti ja tarkista välitulokset, kun työ jatkuu pidempään. Päättelyn tasot low, medium ja high säätelevät päättelyn määrää; medium on dokumentoitu oletustaso. Taso low sopii nopeaan luonnosteluun tai rajattuun analyysiin, kun taas high on tarkoitettu vaikeaan matematiikkaan, ohjelmointiin tai monivaiheisiin tehtäviin. Gemini 3.8 Flash ei tue päättelytasoa minimal. Pitkäkestoiseen virheenjäljitykseen ja suoraviivaiseen kenttien poimintaan on siis valittava erilaiset päättelyasetukset sen sijaan, että kaikissa pyynnöissä käytettäisiin samaa asetusta.\n\nDokumentoituihin työkaluihin kuuluvat funktiokutsut, koodin suorittaminen, tiedostohaku, hakulähteisiin ankkurointi, Google Mapsin tietoihin ankkurointi ja URL-konteksti. Computer Use on merkitty esikatseluvaiheen ominaisuudeksi. Rakenteiset tulosteet määrittävät tulokselle koneluettavan muodon. Funktioille tulee määritellä selkeä tarkoitus ja parametrit: malli voi pyytää funktion kutsumista, kun taas siihen liitetty sovellus suorittaa toiminnon ja palauttaa tuloksen. Säilytä funktioiden tunnisteet ja niiden tosiasiassa palauttama aineisto keskusteluvuorosta toiseen. Hyödyllinen loppuvastaus kertoo, mihin näyttöön ehdotettu korjaus tai poimittu arvo perustuu.\n\nVersion 3.8 siirtymäoppaassa käytetään päättelytason asetuksia aiempien päättelybudjetin asetusten sijaan ja kehotetaan poistamaan vanhentuneet otantaparametrit sekä esitäytetyt mallin vastausvuorot. Opas edellyttää myös, että kyseisessä tilattomassa työnkulussa säilytetään päättelyn allekirjoitukset (thought signatures) ja että funktioiden vastaukset kohdistetaan kutsuihinsa tunnisteen ja nimen perusteella. Nämä seikat ovat tärkeitä monivaiheista tehtävää jatkettaessa: seuraava vuoro tarvitsee todellisen aiemman kontekstin, ei uudelleen kirjoitettua selostusta, josta työkalun tulos tai allekirjoitus puuttuu. Ilmaise uudessa käyttäjäviestissä selkeästi sekä kysymys että haluttu tuloste.\n\nMääritä monimodaalisessa tietotyössä olennaiset asiakirjan sivut, kaavio, äänitallenteen aikaväli tai videon tapahtuma ja kerro, miten niitä tulee käyttää vastauksessa. Asiakirjoja vertailtaessa voi pyytää eroja kuvaavan taulukon lähdekatkelmineen; kaaviota koskevassa kysymyksessä voi pyytää näkyvät arvot ja niiden tukeman johtopäätöksen. Videoanalyysissä voi pyytää kuvaamaan tapahtumat, joihin havainto perustuu. Malli tuottaa näiden syötteiden perusteella tekstiä. Kuvien ja puheen generointi sekä Live-äänivuorovaikutus kuuluvat erillisiin malliprofiileihin.\n\nMallin Gemini API -rajat ovat 1 048 576 syötetokenia ja 65 536 tulostetokenia. Nämä vastaavat natiivin mallin enintään 1M:n kokoista kontekstia ja 64K:n mittaista tekstitulostetta. Ohjeet, keskusteluhistoria ja syötteenä annettu media kuluttavat syötekontekstia, ja päättelyn tai pitkän lopputuotoksen on mahduttava dokumentoituun tulosterajaan. Googlen tarjoamassa malliprofiilissa mainitaan myös välimuistin käyttö, eräkäsittely sekä Flex- ja Priority-käsittely. Säilytä erillisille kohteille pysyvä kohdetunniste ja määritä tulosmuoto yksiselitteisesti, jotta jokainen tulos pysyy yhdistettävissä lähteeseensä.\n\nMahdollisia rajoituksia ovat hallusinaatiot, ajoittainen hitaus tai aikakatkaisut sekä suurempi tokenien kulutus, kun päättelyyn käytetään enemmän resursseja. Mallin tietojen ajallinen takaraja on maaliskuu 2026, mutta joillakin aloilla tiedot ulottuvat edelleen vain tammikuuhun 2025. Anna ajantasaista lähdeaineistoa tai käytä dokumentoituja lähteisiin ankkuroinnin työkaluja, kun tehtävä riippuu tätä myöhemmistä tiedoista. Tarkista lähdeviitteet, laskelmat ja ehdotettu koodi vertaamalla niitä varsinaisiin syötteisiin ja suoritustuloksiin. Käyttökelpoisessa lopputuotoksessa tulee erottaa näytön tukema havainto ratkaisemattomasta kysymyksestä. Sujuvaa vastausta ei pidä sellaisenaan pitää osoituksena siitä, että pyydetty lopputulos on saavutettu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "aa511db68ba0e203b80287b778c50954c685070e7b9f7f089d49a4940ca484e1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "google/gemini-3.8-flash:batchGemini 3.8 Flash on Googlen monimodaalinen työjuhta pitkäjänteiseen ohjelmistokehitykseen, agentteihin ja monimutkaisiin tietotyötehtäviin. Se ottaa syötteenä vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja, tuottaa tekstiä sekä tarjoaa päättelytasot low, medium ja high yhdessä työkalujen ja rakenteisen tulostuksen kanssa. Dokumentoidut syötteen ja tulosteen enimmäispituudet ovat 1 048 576 ja 65 536 tokenia.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Gemini 3.8 Flash on Googlen tekstiä tuottava malli pitkäjänteiseen ohjelmistokehitykseen, monivaiheisiin agentteihin ja monimutkaisiin tietotyön prosesseihin. Se pohjautuu Gemini 3.7 Flashiin ja sisältää parannuksia ohjelmistokehitykseen ja agenttipohjaiseen tietotyöhön. Se ottaa syötteenä vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja, joten tehtävässä voidaan yhdistää kirjallinen tavoite sen ratkaisemiseen tarvittavaan varsinaiseen aineistoon. Käyttökelpoinen lopputulos voi olla koodimuutos, analyysi selityksineen, kirjallinen vastaus tai rakenteinen tietue.
Anna ohjelmointitehtävää varten vaatimus, olennaiset tiedostot, kuvaus havaitusta toiminnasta ja reunaehdot, joiden on säilyttävä voimassa. Kuvakaappaus voi havainnollistaa tavoiteltua käyttöliittymää, kun taas lokit tai virheen toistava esimerkki osoittavat vian. Pyydä virheenjäljitystehtävässä mallia jäljittämään lomakkeen näkyvän tilan ja sen tallennetun arvon välinen ristiriita, tunnistamaan siitä vastaava koodipolku ja ehdottamaan kohdennettua korjausta. Pidä tavoiteltu lopputuotos selkeästi määriteltynä, jotta pitkälläkin selvitystyön ja työkalujen käytön sarjalla on täsmällinen valmistumiskriteeri.
Jaa päättely pienempiin vaiheisiin, tee työkalukutsuja iteratiivisesti ja tarkista välitulokset, kun työ jatkuu pidempään. Päättelyn tasot low, medium ja high säätelevät päättelyn määrää; medium on dokumentoitu oletustaso. Taso low sopii nopeaan luonnosteluun tai rajattuun analyysiin, kun taas high on tarkoitettu vaikeaan matematiikkaan, ohjelmointiin tai monivaiheisiin tehtäviin. Gemini 3.8 Flash ei tue päättelytasoa minimal. Pitkäkestoiseen virheenjäljitykseen ja suoraviivaiseen kenttien poimintaan on siis valittava erilaiset päättelyasetukset sen sijaan, että kaikissa pyynnöissä käytettäisiin samaa asetusta.
Dokumentoituihin työkaluihin kuuluvat funktiokutsut, koodin suorittaminen, tiedostohaku, hakulähteisiin ankkurointi, Google Mapsin tietoihin ankkurointi ja URL-konteksti. Computer Use on merkitty esikatseluvaiheen ominaisuudeksi. Rakenteiset tulosteet määrittävät tulokselle koneluettavan muodon. Funktioille tulee määritellä selkeä tarkoitus ja parametrit: malli voi pyytää funktion kutsumista, kun taas siihen liitetty sovellus suorittaa toiminnon ja palauttaa tuloksen. Säilytä funktioiden tunnisteet ja niiden tosiasiassa palauttama aineisto keskusteluvuorosta toiseen. Hyödyllinen loppuvastaus kertoo, mihin näyttöön ehdotettu korjaus tai poimittu arvo perustuu.
Version 3.8 siirtymäoppaassa käytetään päättelytason asetuksia aiempien päättelybudjetin asetusten sijaan ja kehotetaan poistamaan vanhentuneet otantaparametrit sekä esitäytetyt mallin vastausvuorot. Opas edellyttää myös, että kyseisessä tilattomassa työnkulussa säilytetään päättelyn allekirjoitukset (thought signatures) ja että funktioiden vastaukset kohdistetaan kutsuihinsa tunnisteen ja nimen perusteella. Nämä seikat ovat tärkeitä monivaiheista tehtävää jatkettaessa: seuraava vuoro tarvitsee todellisen aiemman kontekstin, ei uudelleen kirjoitettua selostusta, josta työkalun tulos tai allekirjoitus puuttuu. Ilmaise uudessa käyttäjäviestissä selkeästi sekä kysymys että haluttu tuloste.
Määritä monimodaalisessa tietotyössä olennaiset asiakirjan sivut, kaavio, äänitallenteen aikaväli tai videon tapahtuma ja kerro, miten niitä tulee käyttää vastauksessa. Asiakirjoja vertailtaessa voi pyytää eroja kuvaavan taulukon lähdekatkelmineen; kaaviota koskevassa kysymyksessä voi pyytää näkyvät arvot ja niiden tukeman johtopäätöksen. Videoanalyysissä voi pyytää kuvaamaan tapahtumat, joihin havainto perustuu. Malli tuottaa näiden syötteiden perusteella tekstiä. Kuvien ja puheen generointi sekä Live-äänivuorovaikutus kuuluvat erillisiin malliprofiileihin.
Mallin Gemini API -rajat ovat 1 048 576 syötetokenia ja 65 536 tulostetokenia. Nämä vastaavat natiivin mallin enintään 1M:n kokoista kontekstia ja 64K:n mittaista tekstitulostetta. Ohjeet, keskusteluhistoria ja syötteenä annettu media kuluttavat syötekontekstia, ja päättelyn tai pitkän lopputuotoksen on mahduttava dokumentoituun tulosterajaan. Googlen tarjoamassa malliprofiilissa mainitaan myös välimuistin käyttö, eräkäsittely sekä Flex- ja Priority-käsittely. Säilytä erillisille kohteille pysyvä kohdetunniste ja määritä tulosmuoto yksiselitteisesti, jotta jokainen tulos pysyy yhdistettävissä lähteeseensä.
Mahdollisia rajoituksia ovat hallusinaatiot, ajoittainen hitaus tai aikakatkaisut sekä suurempi tokenien kulutus, kun päättelyyn käytetään enemmän resursseja. Mallin tietojen ajallinen takaraja on maaliskuu 2026, mutta joillakin aloilla tiedot ulottuvat edelleen vain tammikuuhun 2025. Anna ajantasaista lähdeaineistoa tai käytä dokumentoituja lähteisiin ankkuroinnin työkaluja, kun tehtävä riippuu tätä myöhemmistä tiedoista. Tarkista lähdeviitteet, laskelmat ja ehdotettu koodi vertaamalla niitä varsinaisiin syötteisiin ja suoritustuloksiin. Käyttökelpoisessa lopputuotoksessa tulee erottaa näytön tukema havainto ratkaisemattomasta kysymyksestä. Sujuvaa vastausta ei pidä sellaisenaan pitää osoituksena siitä, että pyydetty lopputulos on saavutettu.
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.8-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.8-flash:batch, google/gemini-3.8-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.00075 / 1K tokenia Tuloste · Tulostokenit $0.00375 / 1K tokenia Syöte · Välimuistin luku $0.000075 / 1K tokenia Syöte · Välimuistiin kirjoitus $0.0000833333333333334 / 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.00075 / 1K tokenia Tuloste · Tulostokenit $0.00375 / 1K tokenia Syöte · Välimuistin luku $0.000075 / 1K tokenia Syöte · Välimuistiin kirjoitus $0.0000833333333333334 / 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.8-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.8-flash:batch', 'google/gemini-3.8-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.8-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.8-flash:batch
Käytä yllä näytettyjä menetelmäpolkuja.