Gemini 3.6 Flash on Googlen multimodaalinen yleiskäyttöinen malliprofiili ohjelmointiin, tietotyöhön ja agenttien suorittamiin tehtäviin. Se pohjautuu Gemini 3.5 Flashiin ja painottaa entistä parempaa multimodaalista suorituskykyä sekä tokenitehokkuutta. Malli ottaa vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja ja palauttaa tekstiä. Hyödyllisessä tehtävässä voidaan yhdistää koodi, kuvakaappaus ja vaatimus tai verrata kaaviota tai visuaalista suunnitelmaa kirjallisiin reunaehtoihin, jotta tuloksena on tarkistettu selitys tai kohdennettu muutos.
Kehittäjäopas korostaa tarpeettomien päättelyvaiheiden, keskusteluvuorojen ja työkalukutsujen vähentämistä monivaiheisessa työssä sekä kohdennetumpia muutoksia. Anna vianmääritystä varten havaittu virhe, asiaankuuluva lähdekoodi ja kuvaus toiminnasta, jonka tulee säilyä ennallaan. Kun selvität kaavion virhettä, pyydä mallia tutkimaan, miksi kaavio esittää väärän tietosarjan, tunnistamaan siihen liittyvä datan muunnos ja ehdottamaan yhtä korjausta siten, että ympäröivä asettelu säilyy. Tulosta voidaan sitten verrata todelliseen syötedataan ja kaaviolta vaadittuun toimintaan.
Ongelman ohjelmallinen tutkiminen ennen muutosten tekemistä on 3.6:lle kuvattu ominainen toimintatapa. Valmistajan mukaan malli tutkii ongelmaa aiempaa useammin vianmääritykseen tarkoitetulla koodilla ennen muutosten tekemistä. Tästä voi olla hyötyä monimutkaisessa selvityksessä, mutta oppaan mukaan se voi lisätä selvitysvaiheita tavanomaiseen käyttöliittymäkehitykseen. Ilmoita, edellyttääkö tehtävä selvitystä, yksinkertaista muutosta vai suunnitelman vertailua. Anna tiedot, joista tämä ero käy selvästi ilmi, ja määritä liitetyn sovelluksen työkaluille sallitut toimenpiteet.
Myös spatiaalinen ja multimodaalinen päättely korostuvat: kaavioiden tulkinta, visuaalisten piirustusten muuntaminen ja useista elementeistä koostuvat verkkosivuasettelut. Anna asiaankuuluva näkymä tai sivut, yksilöi tulkittava asia ja pyydä johtopäätöstä tukevat havainnot. Sisällytä suunnittelutehtävään konkreettiset asettelu- ja tyyliohjeet. Valmistajan mukaan malli painottaa toimivaa koodia, ja arvioijat ovat toisinaan pitäneet aiempien mallien visuaalisesta tyylistä enemmän, joten selkeä visuaalinen tehtävänanto on hyödyllinen. Tarkista tulos vertaamalla sitä varsinaiseen kaavioon tai suunnitteluvaatimuksiin.
Dokumentoitu oletuspäättelytaso on medium. Googlen mallikohtaisessa päättelytaulukossa luetellaan minimal, low, medium ja high; 3.6-version siirtymisopas käyttää päättelytason valintaa koskevissa esimerkeissään medium- tai high-tasoa. Juuri tämän mallin sivulla luetellaan funktiokutsut, koodin suoritus, tiedostohaku, vastausten perustaminen hakutuloksiin, vastausten perustaminen Maps-tietoihin, URL-konteksti ja rakenteiset tulokset sekä esikatseluvaiheessa oleva Computer Use -ominaisuus. Määritä funktion syötteet ja vaadittu tulos selkeästi. Mallin valitseman funktion suorittamisesta on saatava todellinen tulos sovellukselta ennen kuin myöhempi vastaus voi perustua siihen. Määritä rakenteista analyysia varten skeema ja kuhunkin havaintoon tarvittava lähdeaineistoon perustuva näyttö.
3.6-opas muuttaa pyyntöjen valmistelua aiempiin Gemini-pyyntöihin verrattuna. Se merkitsee temperature-, top-p- ja top-k-näytteistysasetukset vanhentuneiksi, hylkää esitäytetyn viimeisen keskusteluvuoron, jonka rooli on model, ja suosittelee järjestelmäohjeita tai rakenteisia tuloksia vastauksen ohjaamiseen. Sen funktiovastauksia koskevat säännöt yhdistävät vastauksen kutsuun tunnisteen ja nimen perusteella, ja Gemini 3:n perustoiminnassa päättelyallekirjoitukset säilytetään usean keskusteluvuoron käytössä. Käytännössä jatkopyynnön tulee sisältää asiaankuuluva keskusteluhistoria ja työkalun tulos muuttamattomina sen sijaan, että siinä jäljiteltäisiin aiemman vastauksen alkua.
Mallikortissa ilmoitetaan enintään 1M tokenin syötekonteksti ja 64K tokenin tekstimuotoinen tuloste; juuri tätä mallia koskevassa API-taulukossa rajat ovat 1 048 576 syötetokenia ja 65 536 tulostokenia. Laske ohjeet, keskusteluhistoria ja media mukaan syötteen kokoon ja pyydä tehtävään sopivan mittainen tuloste. Valmistajan sivulla luetellaan myös välimuistin käyttö, eräkäsittely sekä Flex- ja Priority-käsittely. Kun käsittelet toisistaan riippumattomia tietueita, määritä tietueen tunniste ja tulosmuoto selkeästi. Tulos on tekstimuotoinen tuotos myös silloin, kun lähdeaineistoon sisältyy valokuvia, ääntä tai videota.
Mahdollisia rajoituksia ovat hallusinaatiot sekä ajoittainen hitaus tai aikakatkaisut. Sen tietojen ajallinen takaraja on maaliskuu 2026, mutta joillakin aloilla tiedot ulottuvat vain tammikuuhun 2025. Liitä siksi uudempaa aineistoa tai käytä dokumentoitua työnkulkua, jossa vastaukset perustetaan lähdeaineistoon, kun ajankohtaiset tiedot ovat olennaisia. Tarkista laskelmat, lähdeviitteet, visuaaliset tulkinnat ja ehdotetut muutokset. Tälle versiolle ominaisessa valmistelussa laaditaan kohdennettu vianmääritystehtävänanto, rajataan työkalujen käyttö selkeästi ja annetaan nimenomaiset suunnittelurajoitteet, minkä jälkeen tarkastetaan konkreettinen tulos.
", "aboutText": "Gemini 3.6 Flash on Googlen multimodaalinen yleiskäyttöinen malliprofiili ohjelmointiin, tietotyöhön ja agenttien suorittamiin tehtäviin. Se pohjautuu Gemini 3.5 Flashiin ja painottaa entistä parempaa multimodaalista suorituskykyä sekä tokenitehokkuutta. Malli ottaa vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja ja palauttaa tekstiä. Hyödyllisessä tehtävässä voidaan yhdistää koodi, kuvakaappaus ja vaatimus tai verrata kaaviota tai visuaalista suunnitelmaa kirjallisiin reunaehtoihin, jotta tuloksena on tarkistettu selitys tai kohdennettu muutos.\n\nKehittäjäopas korostaa tarpeettomien päättelyvaiheiden, keskusteluvuorojen ja työkalukutsujen vähentämistä monivaiheisessa työssä sekä kohdennetumpia muutoksia. Anna vianmääritystä varten havaittu virhe, asiaankuuluva lähdekoodi ja kuvaus toiminnasta, jonka tulee säilyä ennallaan. Kun selvität kaavion virhettä, pyydä mallia tutkimaan, miksi kaavio esittää väärän tietosarjan, tunnistamaan siihen liittyvä datan muunnos ja ehdottamaan yhtä korjausta siten, että ympäröivä asettelu säilyy. Tulosta voidaan sitten verrata todelliseen syötedataan ja kaaviolta vaadittuun toimintaan.\n\nOngelman ohjelmallinen tutkiminen ennen muutosten tekemistä on 3.6:lle kuvattu ominainen toimintatapa. Valmistajan mukaan malli tutkii ongelmaa aiempaa useammin vianmääritykseen tarkoitetulla koodilla ennen muutosten tekemistä. Tästä voi olla hyötyä monimutkaisessa selvityksessä, mutta oppaan mukaan se voi lisätä selvitysvaiheita tavanomaiseen käyttöliittymäkehitykseen. Ilmoita, edellyttääkö tehtävä selvitystä, yksinkertaista muutosta vai suunnitelman vertailua. Anna tiedot, joista tämä ero käy selvästi ilmi, ja määritä liitetyn sovelluksen työkaluille sallitut toimenpiteet.\n\nMyös spatiaalinen ja multimodaalinen päättely korostuvat: kaavioiden tulkinta, visuaalisten piirustusten muuntaminen ja useista elementeistä koostuvat verkkosivuasettelut. Anna asiaankuuluva näkymä tai sivut, yksilöi tulkittava asia ja pyydä johtopäätöstä tukevat havainnot. Sisällytä suunnittelutehtävään konkreettiset asettelu- ja tyyliohjeet. Valmistajan mukaan malli painottaa toimivaa koodia, ja arvioijat ovat toisinaan pitäneet aiempien mallien visuaalisesta tyylistä enemmän, joten selkeä visuaalinen tehtävänanto on hyödyllinen. Tarkista tulos vertaamalla sitä varsinaiseen kaavioon tai suunnitteluvaatimuksiin.\n\nDokumentoitu oletuspäättelytaso on medium. Googlen mallikohtaisessa päättelytaulukossa luetellaan minimal, low, medium ja high; 3.6-version siirtymisopas käyttää päättelytason valintaa koskevissa esimerkeissään medium- tai high-tasoa. Juuri tämän mallin sivulla luetellaan funktiokutsut, koodin suoritus, tiedostohaku, vastausten perustaminen hakutuloksiin, vastausten perustaminen Maps-tietoihin, URL-konteksti ja rakenteiset tulokset sekä esikatseluvaiheessa oleva Computer Use -ominaisuus. Määritä funktion syötteet ja vaadittu tulos selkeästi. Mallin valitseman funktion suorittamisesta on saatava todellinen tulos sovellukselta ennen kuin myöhempi vastaus voi perustua siihen. Määritä rakenteista analyysia varten skeema ja kuhunkin havaintoon tarvittava lähdeaineistoon perustuva näyttö.\n\n3.6-opas muuttaa pyyntöjen valmistelua aiempiin Gemini-pyyntöihin verrattuna. Se merkitsee temperature-, top-p- ja top-k-näytteistysasetukset vanhentuneiksi, hylkää esitäytetyn viimeisen keskusteluvuoron, jonka rooli on model, ja suosittelee järjestelmäohjeita tai rakenteisia tuloksia vastauksen ohjaamiseen. Sen funktiovastauksia koskevat säännöt yhdistävät vastauksen kutsuun tunnisteen ja nimen perusteella, ja Gemini 3:n perustoiminnassa päättelyallekirjoitukset säilytetään usean keskusteluvuoron käytössä. Käytännössä jatkopyynnön tulee sisältää asiaankuuluva keskusteluhistoria ja työkalun tulos muuttamattomina sen sijaan, että siinä jäljiteltäisiin aiemman vastauksen alkua.\n\nMallikortissa ilmoitetaan enintään 1M tokenin syötekonteksti ja 64K tokenin tekstimuotoinen tuloste; juuri tätä mallia koskevassa API-taulukossa rajat ovat 1 048 576 syötetokenia ja 65 536 tulostokenia. Laske ohjeet, keskusteluhistoria ja media mukaan syötteen kokoon ja pyydä tehtävään sopivan mittainen tuloste. Valmistajan sivulla luetellaan myös välimuistin käyttö, eräkäsittely sekä Flex- ja Priority-käsittely. Kun käsittelet toisistaan riippumattomia tietueita, määritä tietueen tunniste ja tulosmuoto selkeästi. Tulos on tekstimuotoinen tuotos myös silloin, kun lähdeaineistoon sisältyy valokuvia, ääntä tai videota.\n\nMahdollisia rajoituksia ovat hallusinaatiot sekä ajoittainen hitaus tai aikakatkaisut. Sen tietojen ajallinen takaraja on maaliskuu 2026, mutta joillakin aloilla tiedot ulottuvat vain tammikuuhun 2025. Liitä siksi uudempaa aineistoa tai käytä dokumentoitua työnkulkua, jossa vastaukset perustetaan lähdeaineistoon, kun ajankohtaiset tiedot ovat olennaisia. Tarkista laskelmat, lähdeviitteet, visuaaliset tulkinnat ja ehdotetut muutokset. Tälle versiolle ominaisessa valmistelussa laaditaan kohdennettu vianmääritystehtävänanto, rajataan työkalujen käyttö selkeästi ja annetaan nimenomaiset suunnittelurajoitteet, minkä jälkeen tarkastetaan konkreettinen tulos.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7f23dddbc9983def5af787bbc45bd5239dc8157797716e5eb1fb049734391544", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "google/gemini-3.6-flash:batchGemini 3.6 Flash on Googlen multimodaalinen tekstimalli ohjelmointiin, spatiaaliseen analyysiin ja monivaiheiseen agenttityöskentelyyn. Se painottaa diagnostista tarkastelua, kohdennettuja muutoksia ja tarpeettomien suoritussilmukoiden vähentämistä. Malli ottaa vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja. Se tukee työkaluja ja rakenteisia tuloksia, ja sen syötteen enimmäispituus on 1 048 576 tokenia.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Gemini 3.6 Flash on Googlen multimodaalinen yleiskäyttöinen malliprofiili ohjelmointiin, tietotyöhön ja agenttien suorittamiin tehtäviin. Se pohjautuu Gemini 3.5 Flashiin ja painottaa entistä parempaa multimodaalista suorituskykyä sekä tokenitehokkuutta. Malli ottaa vastaan tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja ja palauttaa tekstiä. Hyödyllisessä tehtävässä voidaan yhdistää koodi, kuvakaappaus ja vaatimus tai verrata kaaviota tai visuaalista suunnitelmaa kirjallisiin reunaehtoihin, jotta tuloksena on tarkistettu selitys tai kohdennettu muutos.
Kehittäjäopas korostaa tarpeettomien päättelyvaiheiden, keskusteluvuorojen ja työkalukutsujen vähentämistä monivaiheisessa työssä sekä kohdennetumpia muutoksia. Anna vianmääritystä varten havaittu virhe, asiaankuuluva lähdekoodi ja kuvaus toiminnasta, jonka tulee säilyä ennallaan. Kun selvität kaavion virhettä, pyydä mallia tutkimaan, miksi kaavio esittää väärän tietosarjan, tunnistamaan siihen liittyvä datan muunnos ja ehdottamaan yhtä korjausta siten, että ympäröivä asettelu säilyy. Tulosta voidaan sitten verrata todelliseen syötedataan ja kaaviolta vaadittuun toimintaan.
Ongelman ohjelmallinen tutkiminen ennen muutosten tekemistä on 3.6:lle kuvattu ominainen toimintatapa. Valmistajan mukaan malli tutkii ongelmaa aiempaa useammin vianmääritykseen tarkoitetulla koodilla ennen muutosten tekemistä. Tästä voi olla hyötyä monimutkaisessa selvityksessä, mutta oppaan mukaan se voi lisätä selvitysvaiheita tavanomaiseen käyttöliittymäkehitykseen. Ilmoita, edellyttääkö tehtävä selvitystä, yksinkertaista muutosta vai suunnitelman vertailua. Anna tiedot, joista tämä ero käy selvästi ilmi, ja määritä liitetyn sovelluksen työkaluille sallitut toimenpiteet.
Myös spatiaalinen ja multimodaalinen päättely korostuvat: kaavioiden tulkinta, visuaalisten piirustusten muuntaminen ja useista elementeistä koostuvat verkkosivuasettelut. Anna asiaankuuluva näkymä tai sivut, yksilöi tulkittava asia ja pyydä johtopäätöstä tukevat havainnot. Sisällytä suunnittelutehtävään konkreettiset asettelu- ja tyyliohjeet. Valmistajan mukaan malli painottaa toimivaa koodia, ja arvioijat ovat toisinaan pitäneet aiempien mallien visuaalisesta tyylistä enemmän, joten selkeä visuaalinen tehtävänanto on hyödyllinen. Tarkista tulos vertaamalla sitä varsinaiseen kaavioon tai suunnitteluvaatimuksiin.
Dokumentoitu oletuspäättelytaso on medium. Googlen mallikohtaisessa päättelytaulukossa luetellaan minimal, low, medium ja high; 3.6-version siirtymisopas käyttää päättelytason valintaa koskevissa esimerkeissään medium- tai high-tasoa. Juuri tämän mallin sivulla luetellaan funktiokutsut, koodin suoritus, tiedostohaku, vastausten perustaminen hakutuloksiin, vastausten perustaminen Maps-tietoihin, URL-konteksti ja rakenteiset tulokset sekä esikatseluvaiheessa oleva Computer Use -ominaisuus. Määritä funktion syötteet ja vaadittu tulos selkeästi. Mallin valitseman funktion suorittamisesta on saatava todellinen tulos sovellukselta ennen kuin myöhempi vastaus voi perustua siihen. Määritä rakenteista analyysia varten skeema ja kuhunkin havaintoon tarvittava lähdeaineistoon perustuva näyttö.
3.6-opas muuttaa pyyntöjen valmistelua aiempiin Gemini-pyyntöihin verrattuna. Se merkitsee temperature-, top-p- ja top-k-näytteistysasetukset vanhentuneiksi, hylkää esitäytetyn viimeisen keskusteluvuoron, jonka rooli on model, ja suosittelee järjestelmäohjeita tai rakenteisia tuloksia vastauksen ohjaamiseen. Sen funktiovastauksia koskevat säännöt yhdistävät vastauksen kutsuun tunnisteen ja nimen perusteella, ja Gemini 3:n perustoiminnassa päättelyallekirjoitukset säilytetään usean keskusteluvuoron käytössä. Käytännössä jatkopyynnön tulee sisältää asiaankuuluva keskusteluhistoria ja työkalun tulos muuttamattomina sen sijaan, että siinä jäljiteltäisiin aiemman vastauksen alkua.
Mallikortissa ilmoitetaan enintään 1M tokenin syötekonteksti ja 64K tokenin tekstimuotoinen tuloste; juuri tätä mallia koskevassa API-taulukossa rajat ovat 1 048 576 syötetokenia ja 65 536 tulostokenia. Laske ohjeet, keskusteluhistoria ja media mukaan syötteen kokoon ja pyydä tehtävään sopivan mittainen tuloste. Valmistajan sivulla luetellaan myös välimuistin käyttö, eräkäsittely sekä Flex- ja Priority-käsittely. Kun käsittelet toisistaan riippumattomia tietueita, määritä tietueen tunniste ja tulosmuoto selkeästi. Tulos on tekstimuotoinen tuotos myös silloin, kun lähdeaineistoon sisältyy valokuvia, ääntä tai videota.
Mahdollisia rajoituksia ovat hallusinaatiot sekä ajoittainen hitaus tai aikakatkaisut. Sen tietojen ajallinen takaraja on maaliskuu 2026, mutta joillakin aloilla tiedot ulottuvat vain tammikuuhun 2025. Liitä siksi uudempaa aineistoa tai käytä dokumentoitua työnkulkua, jossa vastaukset perustetaan lähdeaineistoon, kun ajankohtaiset tiedot ovat olennaisia. Tarkista laskelmat, lähdeviitteet, visuaaliset tulkinnat ja ehdotetut muutokset. Tälle versiolle ominaisessa valmistelussa laaditaan kohdennettu vianmääritystehtävänanto, rajataan työkalujen käyttö selkeästi ja annetaan nimenomaiset suunnittelurajoitteet, minkä jälkeen tarkastetaan konkreettinen tulos.
POST /v1/batchestexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttäendpoint | Tyyppistring | VaatimusPakollinen | Arvot & rajat /v1/chat/completions | Oletus— |
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat google/gemini-3.6-flash:batch | Oletus— |
Kenttärequests | Tyyppibatch_item[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttärequests[].custom_id | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttärequests[].body.messages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäcompletion_window | Tyyppistring | VaatimusValinnainen | Arvot & rajat 24h | Oletus— |
Kenttäprovider | Tyyppiobject|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttärequests[].body.model | Tyyppistring | VaatimusValinnainen | Arvot & rajat google/gemini-3.6-flash:batch, google/gemini-3.6-flash | Oletus— |
Kenttäprovider.only | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat google-vertex/global | Oletus— |
Kenttäprovider.allow_fallbacks | Tyyppiboolean|null | VaatimusValinnainen | Arvot & rajat false, null | Oletus— |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusendpoint, model, requests |
Parametrimaterial_types | Sopimustext |
Parametrirepresentation | Sopimuspyyntöön sisältyvä requests[]; jokaisella alkiolla on custom_id ja body |
Parametrirequest_endpoint_profile | Sopimus/v1/chat/completions |
Parametrifile_material | SopimusKutsuja voi lukea todellisen UTF-8 JSONL -aineiston paikallisesti requests[]-taulukkoon. Latauksen purpose-arvoa, input_file_id-arvoa tai tiedostoviitettä ei käytetä. Puuttuva tai tyhjä asiakkaan aineisto keskeyttää valmistelun ennen POST-pyyntöä. |
Parametriserialization_order | Sopimusendpoint, model, provider (jos annettu), completion_window (jos annettu), requests viimeisenä |
Parametrioptional_controls | Sopimusprovider.only, provider.allow_fallbacks, completion_window |
Parametrischema_scope | SopimusTekstimuotoiset Chat Completions -pyyntörungot dokumentoidussa pyyntöön sisältyvässä Batch-kääreessä. |
Elinkaari: asynchronous
GET /v1/batches/{operation_id} · alkuperäisen luontivastauksen todellinen response.id; sama käyttäjä, avain ja ryhmä
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.00075 / 1K tokenia Tuloste · Tulostokenit $0.00375 / 1K tokenia Syöte · Välimuistin luku $0.000075 / 1K tokenia Syöte · Välimuistiin kirjoitus $0.0000833333333333334 / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.00075 / 1K tokenia Tuloste · Tulostokenit $0.00375 / 1K tokenia Syöte · Välimuistin luku $0.000075 / 1K tokenia Syöte · Välimuistiin kirjoitus $0.0000833333333333334 / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.6-flash:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n if supplied_model is not None and supplied_model not in ['google/gemini-3.6-flash:batch', 'google/gemini-3.6-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.6-flash:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nvastaukseen sisältyvä JSON kentässä results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nSäilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä koko alkuperäinen tilatiedot sisältävä JSON, jokainen tulos ja custom_id sekä täydellinen vastaus- tai virherunko. Tallenna valmistuneet results[]-tulokset JSONL-muodossa suodattamatta.
Säilytä alkuperäinen operaation ID. 503 result_pending_check sisältää otsakkeen X-Should-Retry:false; älä koskaan lähetä uudelleen alkuperäistä eräajoa, jonka tila on tuntematon.
| Kenttä | Tyyppi |
|---|---|
Kenttäresults[].custom_id | Tyyppistring |
Kenttäresults[].response.body.choices[].message.content | Tyyppistring|null |
Kenttäresults[].error | Tyyppiobject|null |
Kenttäusage | Tyyppiobject|null |
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäendpoint | Tyyppistring |
Kenttästatus | Tyyppistring |
Kenttärequest_counts | Tyyppiobject |
Kenttäresults[].id | Tyyppistring |
Kenttäresults[].response.status_code | Tyyppiinteger |
Kenttäresults[].response.request_id | Tyyppistring |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoDokumentoitu pyyntöön sisältyvä kääre on virheellinen, avaimet ovat päällekkäisiä, alkion identiteetti on virheellinen tai määritetyt mallin ominaisuudet ovat ristiriidassa. | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta lähetystä. |
Vastaus401 · authentication_error | EhtoVirheellinen API-avain. | Seuraava vaiheKäytä valtuutettua Ailoot-avainta. |
Vastaus403 · permission_error | EhtoEräajoryhmä ei ole käytettävissä. | Seuraava vaiheTarkista avaimen ja ryhmän käyttöoikeudet. |
Vastaus422 · invalid_request_error | EhtoEräajo laskutetaan saldosta; tilauspohjaisella laskutuksella tehty eräajon luontipyyntö hylätään. | Seuraava vaiheKäytä valtuutettua saldosta laskutettavaa ryhmää. |
Vastaus422 · price_unavailable | EhtoEräajon syötteelle ei voida laskea hinta-arviota. | Seuraava vaiheSäilytä vastaus; käytä dokumentoitua API-perheen syötettä. |
Vastaus402 · billing_error | EhtoEräajon varaus ei ole käytettävissä. | Seuraava vaihePoista pyynnön hyväksymisen esteet ennen uutta pyyntöä. |
Vastaus503 · price_unavailable | EhtoEräajomenetelmän hinta tai natiivit hinnat eivät ole käytettävissä. | Seuraava vaiheSäilytä vastaus; älä korvaa hintoja toisilla. |
Vastaus503 · api_error | EhtoTäsmällinen toimittajan reitti ei ole käytettävissä. | Seuraava vaiheSäilytä vastaus reitin korjaamista varten. |
Vastaus503 · result_pending_check | EhtoAlkuperäinen tulos edellyttää tarkistusta; X-Should-Retry:false. | Seuraava vaiheSäilytä alkuperäinen operation_id/id ja lue sen tila; älä koskaan toista alkuperäistä POST-pyyntöä. |
Vastaus404 · not_found | EhtoEräajon tilan operaatiota ei ole tai se kuuluu toiselle identiteetille. | Seuraava vaiheKäytä täsmälleen alkuperäistä id-arvoa sekä samaa käyttäjää, avainta ja ryhmää. |
Ailoot Ultra google/gemini-3.6-flash:batch
Käytä yllä näytettyjä menetelmäpolkuja.