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": { "practical_html": "Tekninen esimerkki englanniksi
Diagnose an unsaved form value\n\nReview this form flow: the input displays draft.name; typing updates draft.name; Save sends original.name; after reload the old name reappears. Explain the mismatch and propose a minimal correction in framework-neutral pseudocode. Include a regression scenario that types a new name, saves, reloads, and checks the stored value. Do not claim any browser action occurred.A cause explanation, corrected Save pseudocode and an end-to-end regression scenario.The submitted value comes from the edited draft, and the reload check verifies persistence rather than just the visible input.gemini-3.8-flashGemini 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/messagestext, imagetext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gemini-3.8-flash | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— |
Kenttämessages[].content | Tyyppistring|content_block[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäsystem | Tyyppistring|content_block[] | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat Vähimmäismäärä: 1 Rajoitus koskee: valitun mallin/kortin täsmällinen yläraja | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttätemperature | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätop_p | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttästop_sequences | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools | Tyyppitool[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools[].name | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: työkalu annettu | Oletus— |
Kenttätools[].description | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätools[].input_schema | TyyppiJSON_schema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätool_choice | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäthinking.type | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäthinking.budget_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäoutput_config.effort | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttämetadata | Tyyppiobject | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäcache_control | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Teksti · UTF8-teksti
messages[].content tai type=text-lohko
Teksti + kuva
{type:image,source:{type:base64,media_type,data}} tai lähde, jossa type=url
| Parametri | Sopimus |
|---|---|
Parametrimaterial_types | Sopimustext, image |
Parametrirequired | Sopimusmodel, messages, max_tokens |
Parametrioptional_controls | Sopimusnull |
Parametricontent_type | Sopimusapplication/json |
Parametritext_file_material | Sopimusvarsinainen UTF-8-sisältö lisätään tekstinä; tiedostojen ID- tai URLs-arvot tarvitsevat erillisen täsmällisen tuen |
Elinkaari: exact retained published method
Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.
POST /v1/messagesAiloot 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 →
Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetOpenAI Chat · Tokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetAnthropic Messages · Tokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 source-material file}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3.8-flash", "max_tokens": 1024, "messages": []}')\nf=Path(os.environ["AILOOT_TEXT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")\ntext=f.read_text(encoding="utf-8")\nif not text.strip():raise SystemExit("Source material must contain text")\np["messages"]=[{"role":"user","content":"Summarize this material and quote supporting source passages.\\n\\n"+text}]\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/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\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_FILE:?Set your actual PNG JPEG or WebP image}"\nexport AILOOT_IMAGE_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3.8-flash", "max_tokens": 1024, "messages": [{"role": "user", "content": [{"type": "text", "text": "Read labels and numbers in this image; flag unreadable text."}]}]}')\nimport base64\nf=Path(os.environ["AILOOT_IMAGE_FILE"])\nif not f.is_file():raise SystemExit("Choose an actual PNG JPEG or WebP image")\nraw=f.read_bytes()\nmime="image/png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "image/jpeg" if raw.startswith(b"\\xff\\xd8") else "image/webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else None\nif not mime:raise SystemExit("Use PNG JPEG or WebP")\nb64=base64.b64encode(raw).decode()\np["messages"][0]["content"].append({"type":"image","source":{"type":"base64","media_type":mime,"data":b64}})\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/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\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\nimport anthropic\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient = anthropic.Anthropic(base_url="https://api.ailoot.ai", api_key=os.environ["AILOOT_API_KEY"], max_retries=0)\nmsg = client.messages.create(\n model="gemini-3.8-flash",\n max_tokens=1024,\n messages=[{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}],\n)\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(msg.to_dict(mode="json"))\nimport Anthropic from "@anthropic-ai/sdk";\n\nif (!process.env.AILOOT_API_KEY?.trim()) throw new Error("Set AILOOT_API_KEY before making a request");\nconst client = new Anthropic({ baseURL: "https://api.ailoot.ai", apiKey: process.env.AILOOT_API_KEY, maxRetries: 0 });\nconst msg = await client.messages.create({\n model: "gemini-3.8-flash",\n max_tokens: 1024,\n messages: [{ role: "user", content: "Explain the difference between an observation and a hypothesis in three sentences." }],\n});\nimport { writeFileSync } from "node:fs";\n\nfunction saveResult(data, stem = "result") {\n writeFileSync(stem + ".json", JSON.stringify(data, null, 2));\n console.log(JSON.stringify(data, null, 2));\n const saveBlob = (encoded, suffix, label) => {\n const raw = Buffer.from(encoded, "base64");\n const ext = raw.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])) ? "png" : raw[0]===255 && raw[1]===216 ? "jpg" : raw.subarray(0,4).toString()==="RIFF" && raw.subarray(8,12).toString()==="WEBP" ? "webp" : suffix;\n const file = `${stem}-${label}.${ext}`;\n writeFileSync(file, raw); console.log("Saved", file);\n };\n for (const [i, block] of (data.content || []).entries()) console.log("Content", i, JSON.stringify(block));\n for (const choice of data.choices || []) console.log("Choice", choice.index, JSON.stringify(choice.message || choice.delta || {}));\n for (const [i, item] of (data.output || []).entries()) {\n console.log("Output", i, JSON.stringify(item));\n if (item.type === "image_generation_call" && item.result) saveBlob(item.result, item.output_format || "bin", `output-${i}`);\n }\n for (const [ci, candidate] of (data.candidates || []).entries()) {\n for (const [pi, part] of (candidate.content?.parts || []).entries()) {\n console.log("Candidate/part", ci, pi, JSON.stringify(part));\n const blob = part.inlineData || part.inline_data;\n if (blob?.data) {\n const mime = blob.mimeType || blob.mime_type;\n const suffix = ({"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"})[mime] || "bin";\n saveBlob(blob.data, suffix, `candidate-${ci}-part-${pi}`);\n }\n }\n }\n}\n\nsaveResult(msg);\nimport anthropic,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=anthropic.Anthropic(base_url="https://api.ailoot.ai",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.messages.stream(model='gemini-3.8-flash',max_tokens=1024,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_message()\n save_result(final.to_dict(mode="json"),"stream-result")\njson tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä kaikki sisältölohkot, päättelyallekirjoitukset ja todelliset työkalukäytön ID:t. Kokoa kaikki SSE-lohkomuutokset; ensimmäinen tekstilohko ei ole koko tulos.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäcontent[] | Tyyppitext|thinking|tool_use|other content block |
Kenttästop_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
gemini-3.8-flashGemini 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 /v1beta/models/{model}:generateContenttext, imagetext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttäpath.model | Tyyppistring | VaatimusPakollinen | Arvot & rajat gemini-3.8-flash | Oletus— |
Kenttäcontents | Tyyppicontent[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttäcontents[].role | Tyyppistring | VaatimusValinnainen | Arvot & rajat user, model | Oletus— |
Kenttäcontents[].parts | Tyyppipart[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
KenttäsystemInstruction | Tyyppicontent | VaatimusValinnainen | Arvot & rajat | Oletus— |
KenttägenerationConfig.maxOutputTokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Model-specific | Oletus— |
KenttägenerationConfig.temperature | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttägenerationConfig.topP | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttägenerationConfig.topK | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttägenerationConfig.stopSequences | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttägenerationConfig.thinkingConfig.includeThoughts | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttägenerationConfig.thinkingConfig.thinkingBudget | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools[].functionDeclarations | Tyyppifunction_declaration[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttätoolConfig.functionCallingConfig.mode | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttäsafetySettings | Tyyppiobject[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
KenttäsessionId | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Teksti · UTF8-teksti
contents[].parts[].text
Teksti + kuva
parts[].inlineData={mimeType,data}
| Parametri | Sopimus |
|---|---|
Parametrimaterial_types | Sopimustext, image |
Parametrirequired | Sopimuscontents |
Parametrioptional_controls | Sopimusnull |
Parametricontent_type | Sopimusapplication/json |
Parametritext_file_material | Sopimusvarsinainen UTF-8-sisältö lisätään tekstinä; tiedostojen ID- tai URLs-arvot tarvitsevat erillisen täsmällisen tuen |
Elinkaari: exact retained published method
Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.
POST /v1beta/models/{model}:generateContentAiloot 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 →
Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetOpenAI Chat · Tokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetAnthropic Messages · Tokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 source-material file}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"contents": []}')\nf=Path(os.environ["AILOOT_TEXT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")\ntext=f.read_text(encoding="utf-8")\nif not text.strip():raise SystemExit("Source material must contain text")\np["contents"]=[{"role":"user","parts":[{"text":"Summarize this material and quote supporting source passages.\\n\\n"+text}]}]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1beta/models/gemini-3.8-flash:generateContent \\\n -H "x-goog-api-key: $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\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(json.loads(Path("result.json").read_text(encoding="utf-8")))\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_FILE:?Set your actual PNG JPEG or WebP image}"\nexport AILOOT_IMAGE_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"contents": [{"role": "user", "parts": [{"text": "Read labels and numbers in this image; flag unreadable text."}]}]}')\nimport base64\nf=Path(os.environ["AILOOT_IMAGE_FILE"])\nif not f.is_file():raise SystemExit("Choose an actual PNG JPEG or WebP image")\nraw=f.read_bytes()\nmime="image/png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "image/jpeg" if raw.startswith(b"\\xff\\xd8") else "image/webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else None\nif not mime:raise SystemExit("Use PNG JPEG or WebP")\nb64=base64.b64encode(raw).decode()\np["contents"][0]["parts"].append({"inlineData":{"mimeType":mime,"data":b64}})\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1beta/models/gemini-3.8-flash:generateContent \\\n -H "x-goog-api-key: $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\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(json.loads(Path("result.json").read_text(encoding="utf-8")))\nPY_RESULT\nfrom google import genai\nfrom google.genai import types\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient = genai.Client(\n api_key=os.environ["AILOOT_API_KEY"],\n http_options=types.HttpOptions(base_url="https://api.ailoot.ai"),\n)\nresp = client.models.generate_content(model="gemini-3.8-flash", contents="Explain the difference between an observation and a hypothesis 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(resp.to_json_dict())\nimport { GoogleGenAI } from "@google/genai";\n\nif (!process.env.AILOOT_API_KEY?.trim()) throw new Error("Set AILOOT_API_KEY before making a request");\nconst ai = new GoogleGenAI({ apiKey: process.env.AILOOT_API_KEY, httpOptions: { baseUrl: "https://api.ailoot.ai" } });\nconst resp = await ai.models.generateContent({ model: "gemini-3.8-flash", contents: "Explain the difference between an observation and a hypothesis in three sentences." });\nimport { writeFileSync } from "node:fs";\n\nfunction saveResult(data, stem = "result") {\n writeFileSync(stem + ".json", JSON.stringify(data, null, 2));\n console.log(JSON.stringify(data, null, 2));\n const saveBlob = (encoded, suffix, label) => {\n const raw = Buffer.from(encoded, "base64");\n const ext = raw.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])) ? "png" : raw[0]===255 && raw[1]===216 ? "jpg" : raw.subarray(0,4).toString()==="RIFF" && raw.subarray(8,12).toString()==="WEBP" ? "webp" : suffix;\n const file = `${stem}-${label}.${ext}`;\n writeFileSync(file, raw); console.log("Saved", file);\n };\n for (const [i, block] of (data.content || []).entries()) console.log("Content", i, JSON.stringify(block));\n for (const choice of data.choices || []) console.log("Choice", choice.index, JSON.stringify(choice.message || choice.delta || {}));\n for (const [i, item] of (data.output || []).entries()) {\n console.log("Output", i, JSON.stringify(item));\n if (item.type === "image_generation_call" && item.result) saveBlob(item.result, item.output_format || "bin", `output-${i}`);\n }\n for (const [ci, candidate] of (data.candidates || []).entries()) {\n for (const [pi, part] of (candidate.content?.parts || []).entries()) {\n console.log("Candidate/part", ci, pi, JSON.stringify(part));\n const blob = part.inlineData || part.inline_data;\n if (blob?.data) {\n const mime = blob.mimeType || blob.mime_type;\n const suffix = ({"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"})[mime] || "bin";\n saveBlob(blob.data, suffix, `candidate-${ci}-part-${pi}`);\n }\n }\n }\n}\n\nsaveResult(resp);\nfrom google import genai\nfrom google.genai import types\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=genai.Client(api_key=os.environ["AILOOT_API_KEY"],http_options=types.HttpOptions(base_url="https://api.ailoot.ai"))\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\ncount=0\nwith Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for chunk in client.models.generate_content_stream(model='gemini-3.8-flash',contents="Explain observations and hypotheses in three sentences."):\n payload=chunk.to_json_dict()\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n save_result(payload,"stream-chunk-"+str(count))\n count+=1\njson tai tuettu virtakäsittely
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä kaikki ehdokkaat ja osat, mukaan lukien funktiokutsut, päättelyallekirjoitukset ja käyttötiedot; kokoa virran lohkot järjestyksessä.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
KenttäresponseId | Tyyppistring |
KenttämodelVersion | Tyyppistring |
Kenttäcandidates[].content.parts[] | Tyyppitext|inlineData|functionCall|other part |
Kenttäcandidates[].finishReason | Tyyppistring |
KenttäusageMetadata | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
gemini-3.8-flashGemini 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/chat/completionstexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gemini-3.8-flash | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat Model-specific | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Tekstikeskustelu | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Teksti · UTF8-teksti
messages[].content
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages |
Parametrimaterial_types | Sopimustext |
Parametrimessages | Sopimusviestitaulukko role/content-rakenteella |
Parametrifile_material | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä |
Parametrioptional_controls | Sopimusstream |
Parametricontrol_scope | SopimusTekstikeskustelu; stream on totuusarvo, jonka oletus on false. |
Parametrioutput_modalities | Sopimustext |
Parametrihosted_operations | Sopimusfalse |
Parametrimultimodal_input_binding | Sopimusnull |
Menetelmien aliakset: /chat/completions
Elinkaari: synchronous_or_streamed
Lähetä mallin täsmällinen ID yhdessä messages-kentän kanssa.
Kontekstin pituus ei ole tuloksen yläraja.
Tekstitiedosto voi antaa tekstiä sellaisenaan; kuva-, ääni- ja tiedosto-objektisyötteet tarvitsevat täsmällisen sidonnan.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 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,os\nfrom pathlib import Path\np=json.loads('{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"hello"}],"stream":false}')\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="gemini-3.8-flash", messages=[{"role":"user","content":"hello"}], stream=False)\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"))\njson tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä jokainen vastausvaihtoehto sisältöineen, työkalukutsuineen ja päättelyineen. Kokoa SSE:ssä muutokset vastausvaihtoehdon ja työkalun indeksin mukaan ja säilytä lopullinen päättymissyy sekä käyttötiedot.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttächoices[].index | Tyyppiinteger |
Kenttächoices[].message.content | Tyyppistring|null |
Kenttächoices[].message.tool_calls | Tyyppitool_call[] |
Kenttächoices[].message.reasoning_content | Tyyppistring |
Kenttächoices[].message.reasoning_details | Tyyppiobject|array |
Kenttächoices[].finish_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
gemini-3.8-flashGemini 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/messagestextjson, sse| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gemini-3.8-flash | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Teksti · UTF-8-teksti
messages[].content-merkkijono
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages, max_tokens |
Parametrioptional_controls | Sopimusstream |
Parametrimaterial_types | Sopimustext |
Parametritext_file_material | SopimusLue varsinainen UTF-8-asiakirja ja sijoita sen teksti ilmoitettuun syöte- tai viestisisällön merkkijonoon. |
Elinkaari: synchronous_or_streamed
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 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 →
{\n "model": "gemini-3.8-flash",\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': 'gemini-3.8-flash', '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': 'gemini-3.8-flash', '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 tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä kaikki sisältölohkot, päättelyallekirjoitukset ja todelliset työkalukäytön ID:t. Kokoa kaikki SSE-lohkomuutokset; ensimmäinen tekstilohko ei ole koko tulos.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäcontent[] | Tyyppitext|thinking|tool_use|other content block |
Kenttästop_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
google/gemini-3.8-flashGemini 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/chat/completionstexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat google/gemini-3.8-flash | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat Esimerkit: system, user, assistant, tool, function Ehdot: Nämä roolit esitetään nimenomaisesti lähdekoodin yhteensopivuustyypeissä; mallin täsmällinen roolijoukko pysyy mallikohtaisena. Model-specific | Oletus— |
Kenttämessages[].content | Tyyppistring|content_part[]|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_calls | Tyyppitool_call[] | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_call_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: role=tool; käytä todella palautettua ID:tä | Oletus— |
Kenttämessages[].name | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].reasoning_content | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Palauta todella saatu päättely takaisin mallille, kun kyseinen malli käyttää sitä | Oletus— |
Kenttämessages[].reasoning_details | Tyyppiobject|array | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Model-specific | Oletus— |
Kenttämax_completion_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Model-specific | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttästream_options.include_usage | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätemperature | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätop_p | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttästop | Tyyppistring|string[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools | Tyyppifunction_tool[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools[].type | Tyyppistring | VaatimusValinnainen | Arvot & rajat function Model-specific | Oletus— |
Kenttätools[].function.name | Tyyppistring | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: funktiotyökalu annettu | Oletus— |
Kenttätools[].function.description | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätools[].function.parameters | TyyppiJSON_schema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätool_choice | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäparallel_tool_calls | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäresponse_format | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäreasoning_effort | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäreasoning | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäservice_tier | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäinstructions | Tyyppistring | VaatimusValinnainen | Arvot & rajat Yhteensopivuuskenttä | Oletus— |
Kenttäfunctions | Tyyppifunction[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäfunction_call | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäprompt_cache_options | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttämodalities | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat text | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options hylätään tällä Ultran tekstireitillä | Oletus— |
Kenttäcache_control.ttl | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: 1h hylätään varsinaisissa kehotevälimuistin kohdissa | Oletus— |
Teksti · UTF8-teksti
messages[].content
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages |
Parametrimaterial_types | Sopimustext |
Parametrimessages | Sopimusviestitaulukko role/content-rakenteella |
Parametrifile_material | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä |
Parametrioptional_controls | Sopimusstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametricontrol_scope | Sopimusmallikohtainen; käyttäjän funktiotyökalut eroavat palvelun isännöimistä työkaluista |
Parametrioutput_modalities | Sopimustext |
Parametrihosted_operations | Sopimusfalse |
Parametrimultimodal_input_binding | Sopimusnull |
Elinkaari: synchronous_or_streamed
Lähetä mallin täsmällinen ID yhdessä messages-kentän kanssa.
Kontekstin pituus ei ole tuloksen yläraja.
Tekstitiedosto voi antaa tekstiä sellaisenaan; kuva-, ääni- ja tiedosto-objektisyötteet tarvitsevat täsmällisen sidonnan.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 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,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-3.8-flash", "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.8-flash',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.8-flash',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 tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä jokainen vastausvaihtoehto sisältöineen, työkalukutsuineen ja päättelyineen. Kokoa SSE:ssä muutokset vastausvaihtoehdon ja työkalun indeksin mukaan ja säilytä lopullinen päättymissyy sekä käyttötiedot.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttächoices[].index | Tyyppiinteger |
Kenttächoices[].message.content | Tyyppistring|null |
Kenttächoices[].message.tool_calls | Tyyppitool_call[] |
Kenttächoices[].message.reasoning_content | Tyyppistring |
Kenttächoices[].message.reasoning_details | Tyyppiobject|array |
Kenttächoices[].finish_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
google/gemini-3.8-flashGemini 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/messagestextjson, sse| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat google/gemini-3.8-flash | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Teksti · UTF-8-teksti
messages[].content-merkkijono
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages, max_tokens |
Parametrioptional_controls | Sopimusstream |
Parametrimaterial_types | Sopimustext |
Parametritext_file_material | SopimusLue varsinainen UTF-8-asiakirja ja sijoita sen teksti ilmoitettuun syöte- tai viestisisällön merkkijonoon. |
Elinkaari: synchronous_or_streamed
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 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 →
{\n "model": "google/gemini-3.8-flash",\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.8-flash', '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.8-flash', '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 tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä kaikki sisältölohkot, päättelyallekirjoitukset ja todelliset työkalukäytön ID:t. Kokoa kaikki SSE-lohkomuutokset; ensimmäinen tekstilohko ei ole koko tulos.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäcontent[] | Tyyppitext|thinking|tool_use|other content block |
Kenttästop_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
~google/gemini-flash-latestGemini 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/chat/completionstexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat ~google/gemini-flash-latest | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat Esimerkit: system, user, assistant, tool, function Ehdot: These roles are explicitly represented by Source compatibility types; the exact model role set remains model-specific. Model-specific | Oletus— |
Kenttämessages[].content | Tyyppistring|content_part[]|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_calls | Tyyppitool_call[] | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_call_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: role=tool; use actual returned ID | Oletus— |
Kenttämessages[].name | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].reasoning_content | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Round-trip actual returned reasoning where this model uses it | Oletus— |
Kenttämessages[].reasoning_details | Tyyppiobject|array | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Model-specific | Oletus— |
Kenttämax_completion_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Model-specific | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttästream_options.include_usage | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätemperature | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätop_p | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttästop | Tyyppistring|string[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools | Tyyppifunction_tool[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttätools[].type | Tyyppistring | VaatimusValinnainen | Arvot & rajat function Model-specific | Oletus— |
Kenttätools[].function.name | Tyyppistring | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: function tool supplied | Oletus— |
Kenttätools[].function.description | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätools[].function.parameters | TyyppiJSON_schema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätool_choice | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäparallel_tool_calls | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäresponse_format | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäreasoning_effort | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäreasoning | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäservice_tier | Tyyppistring | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäinstructions | Tyyppistring | VaatimusValinnainen | Arvot & rajat Yhteensopivuuskenttä | Oletus— |
Kenttäfunctions | Tyyppifunction[] | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäfunction_call | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttäprompt_cache_options | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Model-specific | Oletus— |
Kenttämodalities | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat text | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options is rejected on this Ultra text route | Oletus— |
Kenttäcache_control.ttl | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: 1h is rejected in actual prompt-cache locations | Oletus— |
Teksti · UTF8 text
messages[].content
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages |
Parametrimaterial_types | Sopimustext |
Parametrimessages | Sopimusmessage array with role/content shape |
Parametrifile_material | Sopimusactual UTF-8 document inserted as literal text; no file ID inferred |
Parametrioptional_controls | Sopimusstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametricontrol_scope | Sopimusmodel-specific; user function tools differ from hosted tools |
Parametrioutput_modalities | Sopimustext |
Parametrihosted_operations | Sopimusfalse |
Parametrimultimodal_input_binding | Sopimusnull |
Elinkaari: synchronous_or_streamed
Send exact model ID with messages.
Context length is not an output cap.
A text file may supply literal text; image/audio/file-object inputs need exact binding.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 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,os\nfrom pathlib import Path\np=json.loads('{"model": "~google/gemini-flash-latest", "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-flash-latest',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-flash-latest',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 or SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Keep every choice and its content/tool calls/reasoning. In SSE assemble deltas by choice/tool index, retain the final finish reason and usage.
Keep request/response IDs and headers. No generic text job retrieval URL is supplied.
| Kenttä | Tyyppi |
|---|---|
Kenttächoices[].index | Tyyppiinteger |
Kenttächoices[].message.content | Tyyppistring|null |
Kenttächoices[].message.tool_calls | Tyyppitool_call[] |
Kenttächoices[].message.reasoning_content | Tyyppistring |
Kenttächoices[].message.reasoning_details | Tyyppiobject|array |
Kenttächoices[].finish_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoInvalid required fields, material representation or parameter value | Seuraava vaiheCorrect the indicated fields before a new creation request. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
~google/gemini-flash-latestGemini 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/messagestextjson, sse| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat ~google/gemini-flash-latest | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Teksti · UTF-8 text
messages[].content string
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages, max_tokens |
Parametrioptional_controls | Sopimusstream |
Parametrimaterial_types | Sopimustext |
Parametritext_file_material | SopimusRead the actual UTF-8 document and put its text in the indicated input or message content string. |
Elinkaari: synchronous_or_streamed
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.003 / 1K tokenia Tuloste · Tulostokenit $0.015 / 1K tokenia Syöte · Välimuistin luku $0.0003 / 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 →
{\n "model": "~google/gemini-flash-latest",\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-flash-latest', '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-flash-latest', '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 or SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Keep all content blocks, thinking signatures and actual tool-use IDs. Assemble all SSE block deltas; a first text block is not the complete output.
Keep request/response IDs and headers. No generic text job retrieval URL is supplied.
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäcontent[] | Tyyppitext|thinking|tool_use|other content block |
Kenttästop_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoInvalid required fields, material representation or parameter value | Seuraava vaiheCorrect the indicated fields before a new creation request. |
Ailoot gemini-3.8-flash
Ailoot Ultra gemini-3.8-flash, google/gemini-3.8-flash, ~google/gemini-flash-latest
/chat/completions
google/gemini-3.8-flash, ~google/gemini-flash-latest, gemini-3.8-flash, gemini-3.8-flash
Tekninen esimerkki englanniksi
Diagnose an unsaved form value\n\nReview this form flow: the input displays draft.name; typing updates draft.name; Save sends original.name; after reload the old name reappears. Explain the mismatch and propose a minimal correction in framework-neutral pseudocode. Include a regression scenario that types a new name, saves, reloads, and checks the stored value. Do not claim any browser action occurred.A cause explanation, corrected Save pseudocode and an end-to-end regression scenario.The submitted value comes from the edited draft, and the reload check verifies persistence rather than just the visible input.