Gemini 3.1 Pro Preview on Googlen päättelyyn painottuva tekstimalli monimutkaisiin tehtäviin, jotka vaativat ohjelmistokehitystä, algoritmien kehittämistä tai multimodaalisen lähdeaineiston yhdistämistä. Se perustuu Gemini 3 Pro -malliin ja painottaa täsmällistä työkalujen käyttöä, tehokkaampaa päättelyä ja luotettavaa monivaiheista suorittamista. Tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja voidaan hyödyntää kirjallisen vastauksen, koodituotoksen tai rakenteisen tuloksen laatimisessa.
Anna vaativaan ohjelmointitehtävään tavoite, olennainen koodivaraston aineisto, kuvaus havaitusta toiminnasta ja säilytettävät reunaehdot. Kokonaiset koodivarastot voivat toimia tehtävän kontekstina. Pyydä koodin sopimusten katselmoinnissa mallia vertaamaan, miten kaksi moduulia käsittelee yhteistä tietosopimusta, tunnistamaan ristiriita ja ehdottamaan kohdennettua korjausta sitä tukevine koodiviitteineen. Hyödyllisessä tuloksessa analyysi, muutosehdotus ja niitä tukeva näyttö erotetaan mahdollisesta liitetyn sovelluksen suorittamasta validoinnista.
Julkaisuaineistossa esitellään koodipohjaisia visuaalisia selityksiä ja vuorovaikutteisia projekteja, muun muassa tekstimuotoisen tehtävänannon pohjalta tuotettua animoitua SVG:tä. Kyse on koodituotoksista, ei rasterikuvien generoinnista. Selkeässä tehtävänannossa voidaan määrittää, mitä tulee selittää, miten visuaalisen esityksen tulee toimia ja mitä tietoja sen tulee esittää. Tarkista tuotettu koodi ja sen renderöity esitys näitä vaatimuksia vasten. Anna tietojen yhdistämistehtävään todelliset lähteet ja pyydä yhtä näkymää, joka säilyttää niissä esitetyt suhteet ja varaukset.
Dokumentoidut päättelytasot ovat low, medium ja high. 3.1 Pro Preview -mallin oletustaso on high. Päättelyä ei voi poistaa kokonaan käytöstä tässä Pro-profiilissa. Valitse rajattua vastausta varten matalampi päättelytaso ja vaikeaan monivaiheiseen työhön enemmän päättelyä. Varaa samalla riittävä tulostebudjetti lopulliselle tuotokselle. Pieni tulosteen pituusraja voi keskeyttää päättelyn ennen kuin käyttökelpoinen lopullinen vastaus syntyy. Päättelyopas erottaa päättelyn yhteenvedon koko sisäisestä prosessista ja selittää, miksi keskustelun päättelyallekirjoituksiin liittyvä konteksti on tärkeä.
Juuri tämän Preview-version taulukossa luetellaan funktiokutsut, koodin suorittaminen, hakutuloksiin perustuva lähteistys, Maps-tietoihin perustuva lähteistys, URL-konteksti ja rakenteiset tulosteet. Taulukossa File Search rajataan AI Studioon. Kuvaa funktioiden tarkoitukset ja määrittele niiden parametrit. Jatka todellisen palautetun tuloksen pohjalta. Erillinen Custom Tools Preview -profiili on optimoitu antamaan etusija omille työkaluille ja bashille. Se on mallin tarjoajan erillinen, nimetty päätepiste, joten tätä erikoistumista ei pidä automaattisesti pitää kaikkien 3.1 Pro -pyyntöjen ominaisuutena. Valitse rakenteisen tulosteen skeema, kun tehtävä edellyttää määriteltyjä tietueita vapaamuotoisen tekstin sijaan.
Yksilöi multimodaalisessa analyysissä olennainen sivu, visuaalinen kohde, tallenteen aikaväli tai videolla näkyvä tapahtuma. Vertaa dokumenttianalyysissä kaaviota sen kirjalliseen määrittelyyn ja palauta jokainen ristiriita sitä tukevan tekstikohdan kanssa. Puhutusta lähteestä voidaan tuottaa litterointi tai tekstimuotoinen tulkinta. Säilytä tarkistamista vaativien johtopäätösten lähdeviitteet ja erota suoraan näkyvä tai ilmaistu tieto päätelmistä. Tämä profiili tuottaa tekstiä, myös koodia. Kuvien tai puheen natiivi tuottaminen ei kuulu juuri tämän profiilin ominaisuustaulukossa lueteltuihin ominaisuuksiin.
Valmistajan 3.1 Pro -mallikortissa ilmoitetaan kontekstin enimmäiskooksi 1M tokenia ja tekstitulosteen enimmäispituudeksi 64K tokenia. Juuri tämän Preview-version API-taulukossa ilmoitetaan 1 048 576 syötetokenia ja 65 536 tulostetokenia. Sisällytä ohjeet, keskusteluhistoria ja media syötebudjettiin. Välimuistin käyttö ja eräkäsittely on dokumentoitu, ja mallin tarjoajan profiilin yhteydessä luetellaan myös Flex- ja Priority-vaihtoehdot. Kun käsittelet useita toisistaan riippumattomia kohteita, määritä tarvittava tulos ja säilytä kunkin lähteen tunniste sen sijaan, että yhdistäisit toisiinsa liittymättömän näytön yhdeksi vastaukseksi, jonka lähteitä ei voi jäljittää.
Nimetty Preview-versio pysyy erillään Pro-mallin Custom Tools -profiilista sekä myöhemmistä Flash- tai Pro-julkaisuista. Sen vahvuuksia ovat monimutkainen päättely, ohjelmointi ja lähdeaineiston yhdistäminen. Lopullinen tuotos on silti tarkistettava lähdettä ja todellisia työkalutuloksia vasten. Jätä epäselvyys avoimeksi, jos annetut tiedot eivät tue varmaa johtopäätöstä. Hyödyllinen lopputulos on tehtävässä pyydetty, lähteisiin perustuva vastaus, koodi tai tietue, johon sisältyy riittävästi näyttöä sen käytännön rajoitteiden arvioimiseen.
", "aboutText": "Gemini 3.1 Pro Preview on Googlen päättelyyn painottuva tekstimalli monimutkaisiin tehtäviin, jotka vaativat ohjelmistokehitystä, algoritmien kehittämistä tai multimodaalisen lähdeaineiston yhdistämistä. Se perustuu Gemini 3 Pro -malliin ja painottaa täsmällistä työkalujen käyttöä, tehokkaampaa päättelyä ja luotettavaa monivaiheista suorittamista. Tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja voidaan hyödyntää kirjallisen vastauksen, koodituotoksen tai rakenteisen tuloksen laatimisessa.\n\nAnna vaativaan ohjelmointitehtävään tavoite, olennainen koodivaraston aineisto, kuvaus havaitusta toiminnasta ja säilytettävät reunaehdot. Kokonaiset koodivarastot voivat toimia tehtävän kontekstina. Pyydä koodin sopimusten katselmoinnissa mallia vertaamaan, miten kaksi moduulia käsittelee yhteistä tietosopimusta, tunnistamaan ristiriita ja ehdottamaan kohdennettua korjausta sitä tukevine koodiviitteineen. Hyödyllisessä tuloksessa analyysi, muutosehdotus ja niitä tukeva näyttö erotetaan mahdollisesta liitetyn sovelluksen suorittamasta validoinnista.\n\nJulkaisuaineistossa esitellään koodipohjaisia visuaalisia selityksiä ja vuorovaikutteisia projekteja, muun muassa tekstimuotoisen tehtävänannon pohjalta tuotettua animoitua SVG:tä. Kyse on koodituotoksista, ei rasterikuvien generoinnista. Selkeässä tehtävänannossa voidaan määrittää, mitä tulee selittää, miten visuaalisen esityksen tulee toimia ja mitä tietoja sen tulee esittää. Tarkista tuotettu koodi ja sen renderöity esitys näitä vaatimuksia vasten. Anna tietojen yhdistämistehtävään todelliset lähteet ja pyydä yhtä näkymää, joka säilyttää niissä esitetyt suhteet ja varaukset.\n\nDokumentoidut päättelytasot ovat low, medium ja high. 3.1 Pro Preview -mallin oletustaso on high. Päättelyä ei voi poistaa kokonaan käytöstä tässä Pro-profiilissa. Valitse rajattua vastausta varten matalampi päättelytaso ja vaikeaan monivaiheiseen työhön enemmän päättelyä. Varaa samalla riittävä tulostebudjetti lopulliselle tuotokselle. Pieni tulosteen pituusraja voi keskeyttää päättelyn ennen kuin käyttökelpoinen lopullinen vastaus syntyy. Päättelyopas erottaa päättelyn yhteenvedon koko sisäisestä prosessista ja selittää, miksi keskustelun päättelyallekirjoituksiin liittyvä konteksti on tärkeä.\n\nJuuri tämän Preview-version taulukossa luetellaan funktiokutsut, koodin suorittaminen, hakutuloksiin perustuva lähteistys, Maps-tietoihin perustuva lähteistys, URL-konteksti ja rakenteiset tulosteet. Taulukossa File Search rajataan AI Studioon. Kuvaa funktioiden tarkoitukset ja määrittele niiden parametrit. Jatka todellisen palautetun tuloksen pohjalta. Erillinen Custom Tools Preview -profiili on optimoitu antamaan etusija omille työkaluille ja bashille. Se on mallin tarjoajan erillinen, nimetty päätepiste, joten tätä erikoistumista ei pidä automaattisesti pitää kaikkien 3.1 Pro -pyyntöjen ominaisuutena. Valitse rakenteisen tulosteen skeema, kun tehtävä edellyttää määriteltyjä tietueita vapaamuotoisen tekstin sijaan.\n\nYksilöi multimodaalisessa analyysissä olennainen sivu, visuaalinen kohde, tallenteen aikaväli tai videolla näkyvä tapahtuma. Vertaa dokumenttianalyysissä kaaviota sen kirjalliseen määrittelyyn ja palauta jokainen ristiriita sitä tukevan tekstikohdan kanssa. Puhutusta lähteestä voidaan tuottaa litterointi tai tekstimuotoinen tulkinta. Säilytä tarkistamista vaativien johtopäätösten lähdeviitteet ja erota suoraan näkyvä tai ilmaistu tieto päätelmistä. Tämä profiili tuottaa tekstiä, myös koodia. Kuvien tai puheen natiivi tuottaminen ei kuulu juuri tämän profiilin ominaisuustaulukossa lueteltuihin ominaisuuksiin.\n\nValmistajan 3.1 Pro -mallikortissa ilmoitetaan kontekstin enimmäiskooksi 1M tokenia ja tekstitulosteen enimmäispituudeksi 64K tokenia. Juuri tämän Preview-version API-taulukossa ilmoitetaan 1 048 576 syötetokenia ja 65 536 tulostetokenia. Sisällytä ohjeet, keskusteluhistoria ja media syötebudjettiin. Välimuistin käyttö ja eräkäsittely on dokumentoitu, ja mallin tarjoajan profiilin yhteydessä luetellaan myös Flex- ja Priority-vaihtoehdot. Kun käsittelet useita toisistaan riippumattomia kohteita, määritä tarvittava tulos ja säilytä kunkin lähteen tunniste sen sijaan, että yhdistäisit toisiinsa liittymättömän näytön yhdeksi vastaukseksi, jonka lähteitä ei voi jäljittää.\n\nNimetty Preview-versio pysyy erillään Pro-mallin Custom Tools -profiilista sekä myöhemmistä Flash- tai Pro-julkaisuista. Sen vahvuuksia ovat monimutkainen päättely, ohjelmointi ja lähdeaineiston yhdistäminen. Lopullinen tuotos on silti tarkistettava lähdettä ja todellisia työkalutuloksia vasten. Jätä epäselvyys avoimeksi, jos annetut tiedot eivät tue varmaa johtopäätöstä. Hyödyllinen lopputulos on tehtävässä pyydetty, lähteisiin perustuva vastaus, koodi tai tietue, johon sisältyy riittävästi näyttöä sen käytännön rajoitteiden arvioimiseen.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "22597bd8d6d4c0f73437318d7f3fc00209ed90d9103c7cac3a5dbc0fd498e3eb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "google/gemini-3.1-pro-preview:batchGemini 3.1 Pro Preview on Googlen multimodaalinen päättelymalli monimutkaisiin ohjelmisto-, algoritmi- ja tietotehtäviin. Se vastaanottaa tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja ja palauttaa tekstiä tai koodia. Se tukee työkaluja ja rakenteista tulostetta. Päättelytasot low, medium ja high ohjaavat työmäärää; dokumentoitu oletus on high.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Gemini 3.1 Pro Preview on Googlen päättelyyn painottuva tekstimalli monimutkaisiin tehtäviin, jotka vaativat ohjelmistokehitystä, algoritmien kehittämistä tai multimodaalisen lähdeaineiston yhdistämistä. Se perustuu Gemini 3 Pro -malliin ja painottaa täsmällistä työkalujen käyttöä, tehokkaampaa päättelyä ja luotettavaa monivaiheista suorittamista. Tekstiä, kuvia, ääntä, videota ja PDF-tiedostoja voidaan hyödyntää kirjallisen vastauksen, koodituotoksen tai rakenteisen tuloksen laatimisessa.
Anna vaativaan ohjelmointitehtävään tavoite, olennainen koodivaraston aineisto, kuvaus havaitusta toiminnasta ja säilytettävät reunaehdot. Kokonaiset koodivarastot voivat toimia tehtävän kontekstina. Pyydä koodin sopimusten katselmoinnissa mallia vertaamaan, miten kaksi moduulia käsittelee yhteistä tietosopimusta, tunnistamaan ristiriita ja ehdottamaan kohdennettua korjausta sitä tukevine koodiviitteineen. Hyödyllisessä tuloksessa analyysi, muutosehdotus ja niitä tukeva näyttö erotetaan mahdollisesta liitetyn sovelluksen suorittamasta validoinnista.
Julkaisuaineistossa esitellään koodipohjaisia visuaalisia selityksiä ja vuorovaikutteisia projekteja, muun muassa tekstimuotoisen tehtävänannon pohjalta tuotettua animoitua SVG:tä. Kyse on koodituotoksista, ei rasterikuvien generoinnista. Selkeässä tehtävänannossa voidaan määrittää, mitä tulee selittää, miten visuaalisen esityksen tulee toimia ja mitä tietoja sen tulee esittää. Tarkista tuotettu koodi ja sen renderöity esitys näitä vaatimuksia vasten. Anna tietojen yhdistämistehtävään todelliset lähteet ja pyydä yhtä näkymää, joka säilyttää niissä esitetyt suhteet ja varaukset.
Dokumentoidut päättelytasot ovat low, medium ja high. 3.1 Pro Preview -mallin oletustaso on high. Päättelyä ei voi poistaa kokonaan käytöstä tässä Pro-profiilissa. Valitse rajattua vastausta varten matalampi päättelytaso ja vaikeaan monivaiheiseen työhön enemmän päättelyä. Varaa samalla riittävä tulostebudjetti lopulliselle tuotokselle. Pieni tulosteen pituusraja voi keskeyttää päättelyn ennen kuin käyttökelpoinen lopullinen vastaus syntyy. Päättelyopas erottaa päättelyn yhteenvedon koko sisäisestä prosessista ja selittää, miksi keskustelun päättelyallekirjoituksiin liittyvä konteksti on tärkeä.
Juuri tämän Preview-version taulukossa luetellaan funktiokutsut, koodin suorittaminen, hakutuloksiin perustuva lähteistys, Maps-tietoihin perustuva lähteistys, URL-konteksti ja rakenteiset tulosteet. Taulukossa File Search rajataan AI Studioon. Kuvaa funktioiden tarkoitukset ja määrittele niiden parametrit. Jatka todellisen palautetun tuloksen pohjalta. Erillinen Custom Tools Preview -profiili on optimoitu antamaan etusija omille työkaluille ja bashille. Se on mallin tarjoajan erillinen, nimetty päätepiste, joten tätä erikoistumista ei pidä automaattisesti pitää kaikkien 3.1 Pro -pyyntöjen ominaisuutena. Valitse rakenteisen tulosteen skeema, kun tehtävä edellyttää määriteltyjä tietueita vapaamuotoisen tekstin sijaan.
Yksilöi multimodaalisessa analyysissä olennainen sivu, visuaalinen kohde, tallenteen aikaväli tai videolla näkyvä tapahtuma. Vertaa dokumenttianalyysissä kaaviota sen kirjalliseen määrittelyyn ja palauta jokainen ristiriita sitä tukevan tekstikohdan kanssa. Puhutusta lähteestä voidaan tuottaa litterointi tai tekstimuotoinen tulkinta. Säilytä tarkistamista vaativien johtopäätösten lähdeviitteet ja erota suoraan näkyvä tai ilmaistu tieto päätelmistä. Tämä profiili tuottaa tekstiä, myös koodia. Kuvien tai puheen natiivi tuottaminen ei kuulu juuri tämän profiilin ominaisuustaulukossa lueteltuihin ominaisuuksiin.
Valmistajan 3.1 Pro -mallikortissa ilmoitetaan kontekstin enimmäiskooksi 1M tokenia ja tekstitulosteen enimmäispituudeksi 64K tokenia. Juuri tämän Preview-version API-taulukossa ilmoitetaan 1 048 576 syötetokenia ja 65 536 tulostetokenia. Sisällytä ohjeet, keskusteluhistoria ja media syötebudjettiin. Välimuistin käyttö ja eräkäsittely on dokumentoitu, ja mallin tarjoajan profiilin yhteydessä luetellaan myös Flex- ja Priority-vaihtoehdot. Kun käsittelet useita toisistaan riippumattomia kohteita, määritä tarvittava tulos ja säilytä kunkin lähteen tunniste sen sijaan, että yhdistäisit toisiinsa liittymättömän näytön yhdeksi vastaukseksi, jonka lähteitä ei voi jäljittää.
Nimetty Preview-versio pysyy erillään Pro-mallin Custom Tools -profiilista sekä myöhemmistä Flash- tai Pro-julkaisuista. Sen vahvuuksia ovat monimutkainen päättely, ohjelmointi ja lähdeaineiston yhdistäminen. Lopullinen tuotos on silti tarkistettava lähdettä ja todellisia työkalutuloksia vasten. Jätä epäselvyys avoimeksi, jos annetut tiedot eivät tue varmaa johtopäätöstä. Hyödyllinen lopputulos on tehtävässä pyydetty, lähteisiin perustuva vastaus, koodi tai tietue, johon sisältyy riittävästi näyttöä sen käytännön rajoitteiden arvioimiseen.
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.1-pro-preview:batch | Oletus— |
Kenttärequests | Tyyppibatch_item[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttärequests[].custom_id | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttärequests[].body.messages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäcompletion_window | Tyyppistring | VaatimusValinnainen | Arvot & rajat 24h | Oletus— |
Kenttäprovider | Tyyppiobject|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttärequests[].body.model | Tyyppistring | VaatimusValinnainen | Arvot & rajat google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview | Oletus— |
Kenttäprovider.only | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat google-vertex/global | Oletus— |
Kenttäprovider.allow_fallbacks | Tyyppiboolean|null | VaatimusValinnainen | Arvot & rajat false, null | Oletus— |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusendpoint, model, requests |
Parametrimaterial_types | Sopimustext |
Parametrirepresentation | Sopimuspyyntöön sisältyvä requests[]; jokaisella alkiolla on custom_id ja body |
Parametrirequest_endpoint_profile | Sopimus/v1/chat/completions |
Parametrifile_material | SopimusKutsuja voi lukea todellisen UTF-8 JSONL -aineiston paikallisesti requests[]-taulukkoon. Latauksen purpose-arvoa, input_file_id-arvoa tai tiedostoviitettä ei käytetä. Puuttuva tai tyhjä asiakkaan aineisto keskeyttää valmistelun ennen POST-pyyntöä. |
Parametriserialization_order | Sopimusendpoint, model, provider (jos annettu), completion_window (jos annettu), requests viimeisenä |
Parametrioptional_controls | Sopimusprovider.only, provider.allow_fallbacks, completion_window |
Parametrischema_scope | SopimusTekstimuotoiset Chat Completions -pyyntörungot dokumentoidussa pyyntöön sisältyvässä Batch-kääreessä. |
Elinkaari: asynchronous
GET /v1/batches/{operation_id} · alkuperäisen luontivastauksen todellinen response.id; sama käyttäjä, avain ja ryhmä
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.002 / 1K tokenia Tuloste · Tulostokenit $0.012 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukien200 000 | Veloitus Syöte · Syötetokenit $0.002 / 1K tokenia Tuloste · Tulostokenit $0.012 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 2 | Hinnasto— | Kontekstin tokenit, enemmän kuin200 000 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.004 / 1K tokenia Tuloste · Tulostokenit $0.018 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.1-pro-preview:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n if supplied_model is not None and supplied_model not in ['google/gemini-3.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-preview:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nvastaukseen sisältyvä JSON kentässä results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nSäilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä koko alkuperäinen tilatiedot sisältävä JSON, jokainen tulos ja custom_id sekä täydellinen vastaus- tai virherunko. Tallenna valmistuneet results[]-tulokset JSONL-muodossa suodattamatta.
Säilytä alkuperäinen operaation ID. 503 result_pending_check sisältää otsakkeen X-Should-Retry:false; älä koskaan lähetä uudelleen alkuperäistä eräajoa, jonka tila on tuntematon.
| Kenttä | Tyyppi |
|---|---|
Kenttäresults[].custom_id | Tyyppistring |
Kenttäresults[].response.body.choices[].message.content | Tyyppistring|null |
Kenttäresults[].error | Tyyppiobject|null |
Kenttäusage | Tyyppiobject|null |
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäendpoint | Tyyppistring |
Kenttästatus | Tyyppistring |
Kenttärequest_counts | Tyyppiobject |
Kenttäresults[].id | Tyyppistring |
Kenttäresults[].response.status_code | Tyyppiinteger |
Kenttäresults[].response.request_id | Tyyppistring |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoDokumentoitu pyyntöön sisältyvä kääre on virheellinen, avaimet ovat päällekkäisiä, alkion identiteetti on virheellinen tai määritetyt mallin ominaisuudet ovat ristiriidassa. | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta lähetystä. |
Vastaus401 · authentication_error | EhtoVirheellinen API-avain. | Seuraava vaiheKäytä valtuutettua Ailoot-avainta. |
Vastaus403 · permission_error | EhtoEräajoryhmä ei ole käytettävissä. | Seuraava vaiheTarkista avaimen ja ryhmän käyttöoikeudet. |
Vastaus422 · invalid_request_error | EhtoEräajo laskutetaan saldosta; tilauspohjaisella laskutuksella tehty eräajon luontipyyntö hylätään. | Seuraava vaiheKäytä valtuutettua saldosta laskutettavaa ryhmää. |
Vastaus422 · price_unavailable | EhtoEräajon syötteelle ei voida laskea hinta-arviota. | Seuraava vaiheSäilytä vastaus; käytä dokumentoitua API-perheen syötettä. |
Vastaus402 · billing_error | EhtoEräajon varaus ei ole käytettävissä. | Seuraava vaihePoista pyynnön hyväksymisen esteet ennen uutta pyyntöä. |
Vastaus503 · price_unavailable | EhtoEräajomenetelmän hinta tai natiivit hinnat eivät ole käytettävissä. | Seuraava vaiheSäilytä vastaus; älä korvaa hintoja toisilla. |
Vastaus503 · api_error | EhtoTäsmällinen toimittajan reitti ei ole käytettävissä. | Seuraava vaiheSäilytä vastaus reitin korjaamista varten. |
Vastaus503 · result_pending_check | EhtoAlkuperäinen tulos edellyttää tarkistusta; X-Should-Retry:false. | Seuraava vaiheSäilytä alkuperäinen operation_id/id ja lue sen tila; älä koskaan toista alkuperäistä POST-pyyntöä. |
Vastaus404 · not_found | EhtoEräajon tilan operaatiota ei ole tai se kuuluu toiselle identiteetille. | Seuraava vaiheKäytä täsmälleen alkuperäistä id-arvoa sekä samaa käyttäjää, avainta ja ryhmää. |
Ailoot Ultra google/gemini-3.1-pro-preview:batch
Käytä yllä näytettyjä menetelmäpolkuja.