GPT-4.1 Nano on OpenAI:n GPT-4.1-perheen nopein jäsen, joka on suunniteltu ohjeiden noudattamiseen ja työkalukutsuihin ilman erillistä päättelyvaihetta. Se hyväksyy tekstiä ja kuvia ja tuottaa tekstiä. Nano sopii tarkasti määritettyyn operaatioon, jossa sovellus tarvitsee tiiviin vastauksen, kenttäjoukon tai seuraavan työkalupyynnön laajan selvityksen sijaan.
Hyödyllinen esimerkki on saapuvien viestien luokittelu annettujen kategorioiden mukaan. Selitä jokainen kategoria, näytä epäselvien tai soveltamisalan ulkopuolisten viestien esitystapa ja pyydä kategoriaa yhdessä sitä tukevan lähdeilmauksen kanssa. Määritä poimintaan kenttänimet, sallitut arvot ja puuttuvan tiedon käsittely. Anna lyhyeen kirjoitustehtävään faktat ja pyydä sovelluksen seuraavan vaiheen tarvitsemaa täsmällistä katkelmaa. Esimerkkien ja rajoitteiden tulee olla riittävän pieniä pysyäkseen selkeinä myös suuressa lähdekokoelmassa.
Tuottaja ilmoittaa konteksti-ikkunaksi 1047576 tokenia, enimmäistulosteeksi 32768 tokenia ja tietojen katkaisupäiväksi 1. kesäkuuta 2024. Määritykset vastaavat GPT-4.1 Minin ikkunaa säilyttäen Nanon erillisen malli-identiteetin ja nopeaan vastaamiseen painottuvan tehtävän. Nimeä dokumentit ja keskustelun osiot, sisällytä vain operaation kannalta olennainen konteksti ja varaa tilaa täydelle vastaukselle. Hakutulokset tai annettu viiteteksti voivat tarjota mallin oppimia tietoja uudempia faktoja.
Nano tukee suoratoistoa ja Structured Outputs -toimintoa. Skeeman rajaama lopullinen vastaus palvelee eri tarkoitusta kuin funktiokutsu: toinen antaa sovellukselle valmiin tuotoksen, ja toinen pyytää sitä suorittamaan operaation. Structured Outputs tukee JSON Scheman osajoukkoa; määritä vaaditut ominaisuudet ja selkeä esitystapa tuntemattomille arvoille. Käsittele kieltäytymiset ja keskeneräiset vastaukset erikseen ja tarkista poimitut arvot syötettä vasten sen sijaan, että kelvollinen muoto rinnastettaisiin oikeaan johtopäätökseen.
Dokumentoitu työkalujoukko sisältää funktiokutsut, tiedostohaun, koodin tulkinnan, MCP-yhteydet ja erillisen kuvagenerointityökalun. Sovellus antaa työkalukuvaukset ja skeemat, suorittaa mukautetut funktiot ja palauttaa niiden todelliset tulokset. OpenAI suosittelee nimenomaisesti rinnakkaisten työkalukutsujen poistamista käytöstä 14. huhtikuuta 2025 päivätyssä Nano-malliversiossa, koska malli voi pyytää samaa työkalua useita kertoja yhdellä vuorolla. Tämä on malliversiokohtainen suorittamiseen liittyvä huomio, ei syy tulkita useita ehdotettuja kutsuja suoritetuiksi toiminnoiksi.
Kuvasyöte lisää tekstitehtävään visuaalista näyttöä, kuten näkyvän merkinnän lukemista tai kuvakaappauksen tilan kuvausta. Käytä tuettuja PNG-, JPEG- ja WebP-kuvia tai animoimattomia GIF-kuvia, pidä teksti luettavana ja selitä tärkeä havainto. Kuvaopas mainitsee vaikeuksia pienessä tai käännetyssä tekstissä, täsmällisissä sijaintisuhteissa, esinemäärissä ja osassa ei-latinalaista kirjoitusta. Anna ympäröivä konteksti, kun pelkkä rajaus tekisi merkinnästä tai kaaviosta epäselvän. Nanon oma vastaus on tekstiä; kuvagenerointityökalu palauttaa oman erillisen tuotoksensa. OpenAI:n dokumentoidussa kuvantulkintatyönkulussa pyynnön kokonaisdata on rajattu 512 MB:iin ja pyyntö voi sisältää enintään 1500 kuvaa; kuvien ja tekstin pitää myös mahtua mallin kontekstiin.
Tuottajan tiedostotyönkulussa kuvia ymmärtävä malli vastaanottaa PDF-tiedostoista sekä poimitun tekstin että sivukuvat. Muut dokumenttimuodot tuovat poimitun tekstin, ja laskentataulukoiden aineiston täydentäminen huomioi kunkin välilehden enintään 1000 ensimmäistä riviä. Tiedoston pitää olla alle 50 MB, ja pyynnön yhteisraja on 50 MB. Chat Completions tukee PDF-tiedosto-osia, ja dokumentoitu Responses-työnkulku hyväksyy myös muita tiedostotyyppejä. Muiden kuin PDF-dokumenttien upotettuja kaavioita ei välitetä kuvasisältönä, joten PDF-esitysmuoto auttaa visuaalisen näytön ollessa tärkeää.
OpenAI dokumentoi Nanolle kehotteiden välimuistin ja GPT-4.1 Nano -sarjalle Predicted Outputs -toiminnon. Kehotteiden välimuisti käyttää uudelleen siihen soveltuvaa syötteen alkuosaa tuottajan palvelussa. Predicted Outputs antaa sen sijaan pääosin tunnettua tulostekstiä muokkaukseen, kuten dokumentin tai kooditiedoston päivittämiseen sen muuttumattomat osat säilyttäen. Ennustetyönkulku käsittelee vain tekstiä ja sulkee pois muun muassa funktiokutsut sekä logprobs- ja max_completion_tokens-asetukset. Valitse työnkulku todellisen operaation mukaan ja pidä sen tulos yhteydessä alkuperäiseen lähteeseen.
Tuottaja dokumentoi myös ohjatun hienosäädön ja suoran preferenssioptimoinnin Nanon nimetylle GPT-4.1-malliversiolle. Koulutusesimerkit sekä paremmiksi valitut ja hylätyt vastaukset mukauttavat mallia toistuvaan tehtävään; ne eroavat tavallisen pyynnön saamasta kontekstista. Aloita käytännön poiminta- tai luokitteluvaihe selkeillä kategorioilla, esimerkeillä ja täsmällisellä lopputulosmuodolla ja tarkasta sitten, säilyttävätkö palautetut kentät seuraavan vaiheen käyttämät faktat.
", "aboutText": "GPT-4.1 Nano on OpenAI:n GPT-4.1-perheen nopein jäsen, joka on suunniteltu ohjeiden noudattamiseen ja työkalukutsuihin ilman erillistä päättelyvaihetta. Se hyväksyy tekstiä ja kuvia ja tuottaa tekstiä. Nano sopii tarkasti määritettyyn operaatioon, jossa sovellus tarvitsee tiiviin vastauksen, kenttäjoukon tai seuraavan työkalupyynnön laajan selvityksen sijaan.\n\nHyödyllinen esimerkki on saapuvien viestien luokittelu annettujen kategorioiden mukaan. Selitä jokainen kategoria, näytä epäselvien tai soveltamisalan ulkopuolisten viestien esitystapa ja pyydä kategoriaa yhdessä sitä tukevan lähdeilmauksen kanssa. Määritä poimintaan kenttänimet, sallitut arvot ja puuttuvan tiedon käsittely. Anna lyhyeen kirjoitustehtävään faktat ja pyydä sovelluksen seuraavan vaiheen tarvitsemaa täsmällistä katkelmaa. Esimerkkien ja rajoitteiden tulee olla riittävän pieniä pysyäkseen selkeinä myös suuressa lähdekokoelmassa.\n\nTuottaja ilmoittaa konteksti-ikkunaksi 1047576 tokenia, enimmäistulosteeksi 32768 tokenia ja tietojen katkaisupäiväksi 1. kesäkuuta 2024. Määritykset vastaavat GPT-4.1 Minin ikkunaa säilyttäen Nanon erillisen malli-identiteetin ja nopeaan vastaamiseen painottuvan tehtävän. Nimeä dokumentit ja keskustelun osiot, sisällytä vain operaation kannalta olennainen konteksti ja varaa tilaa täydelle vastaukselle. Hakutulokset tai annettu viiteteksti voivat tarjota mallin oppimia tietoja uudempia faktoja.\n\nNano tukee suoratoistoa ja Structured Outputs -toimintoa. Skeeman rajaama lopullinen vastaus palvelee eri tarkoitusta kuin funktiokutsu: toinen antaa sovellukselle valmiin tuotoksen, ja toinen pyytää sitä suorittamaan operaation. Structured Outputs tukee JSON Scheman osajoukkoa; määritä vaaditut ominaisuudet ja selkeä esitystapa tuntemattomille arvoille. Käsittele kieltäytymiset ja keskeneräiset vastaukset erikseen ja tarkista poimitut arvot syötettä vasten sen sijaan, että kelvollinen muoto rinnastettaisiin oikeaan johtopäätökseen.\n\nDokumentoitu työkalujoukko sisältää funktiokutsut, tiedostohaun, koodin tulkinnan, MCP-yhteydet ja erillisen kuvagenerointityökalun. Sovellus antaa työkalukuvaukset ja skeemat, suorittaa mukautetut funktiot ja palauttaa niiden todelliset tulokset. OpenAI suosittelee nimenomaisesti rinnakkaisten työkalukutsujen poistamista käytöstä 14. huhtikuuta 2025 päivätyssä Nano-malliversiossa, koska malli voi pyytää samaa työkalua useita kertoja yhdellä vuorolla. Tämä on malliversiokohtainen suorittamiseen liittyvä huomio, ei syy tulkita useita ehdotettuja kutsuja suoritetuiksi toiminnoiksi.\n\nKuvasyöte lisää tekstitehtävään visuaalista näyttöä, kuten näkyvän merkinnän lukemista tai kuvakaappauksen tilan kuvausta. Käytä tuettuja PNG-, JPEG- ja WebP-kuvia tai animoimattomia GIF-kuvia, pidä teksti luettavana ja selitä tärkeä havainto. Kuvaopas mainitsee vaikeuksia pienessä tai käännetyssä tekstissä, täsmällisissä sijaintisuhteissa, esinemäärissä ja osassa ei-latinalaista kirjoitusta. Anna ympäröivä konteksti, kun pelkkä rajaus tekisi merkinnästä tai kaaviosta epäselvän. Nanon oma vastaus on tekstiä; kuvagenerointityökalu palauttaa oman erillisen tuotoksensa. OpenAI:n dokumentoidussa kuvantulkintatyönkulussa pyynnön kokonaisdata on rajattu 512 MB:iin ja pyyntö voi sisältää enintään 1500 kuvaa; kuvien ja tekstin pitää myös mahtua mallin kontekstiin.\n\nTuottajan tiedostotyönkulussa kuvia ymmärtävä malli vastaanottaa PDF-tiedostoista sekä poimitun tekstin että sivukuvat. Muut dokumenttimuodot tuovat poimitun tekstin, ja laskentataulukoiden aineiston täydentäminen huomioi kunkin välilehden enintään 1000 ensimmäistä riviä. Tiedoston pitää olla alle 50 MB, ja pyynnön yhteisraja on 50 MB. Chat Completions tukee PDF-tiedosto-osia, ja dokumentoitu Responses-työnkulku hyväksyy myös muita tiedostotyyppejä. Muiden kuin PDF-dokumenttien upotettuja kaavioita ei välitetä kuvasisältönä, joten PDF-esitysmuoto auttaa visuaalisen näytön ollessa tärkeää.\n\nOpenAI dokumentoi Nanolle kehotteiden välimuistin ja GPT-4.1 Nano -sarjalle Predicted Outputs -toiminnon. Kehotteiden välimuisti käyttää uudelleen siihen soveltuvaa syötteen alkuosaa tuottajan palvelussa. Predicted Outputs antaa sen sijaan pääosin tunnettua tulostekstiä muokkaukseen, kuten dokumentin tai kooditiedoston päivittämiseen sen muuttumattomat osat säilyttäen. Ennustetyönkulku käsittelee vain tekstiä ja sulkee pois muun muassa funktiokutsut sekä logprobs- ja max_completion_tokens-asetukset. Valitse työnkulku todellisen operaation mukaan ja pidä sen tulos yhteydessä alkuperäiseen lähteeseen.\n\nTuottaja dokumentoi myös ohjatun hienosäädön ja suoran preferenssioptimoinnin Nanon nimetylle GPT-4.1-malliversiolle. Koulutusesimerkit sekä paremmiksi valitut ja hylätyt vastaukset mukauttavat mallia toistuvaan tehtävään; ne eroavat tavallisen pyynnön saamasta kontekstista. Aloita käytännön poiminta- tai luokitteluvaihe selkeillä kategorioilla, esimerkeillä ja täsmällisellä lopputulosmuodolla ja tarkasta sitten, säilyttävätkö palautetut kentät seuraavan vaiheen käyttämät faktat.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "db012cae28d97448f3f5cd94d8bb61f031ddae66c2864eb1ca75761917e776aa", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "openai/gpt-4.1-nano:batchGPT-4.1 Nano on GPT-4.1-perheen kompakti, nopeasti vastaava jäsen tarkasti määritettyihin teksti- ja kuvatehtäviin. Sen suuri konteksti, Structured Outputs ja funktiokutsut tukevat luokittelua, poimintaa ja rajattuja sovellusvaiheita.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT-4.1 Nano on OpenAI:n GPT-4.1-perheen nopein jäsen, joka on suunniteltu ohjeiden noudattamiseen ja työkalukutsuihin ilman erillistä päättelyvaihetta. Se hyväksyy tekstiä ja kuvia ja tuottaa tekstiä. Nano sopii tarkasti määritettyyn operaatioon, jossa sovellus tarvitsee tiiviin vastauksen, kenttäjoukon tai seuraavan työkalupyynnön laajan selvityksen sijaan.
Hyödyllinen esimerkki on saapuvien viestien luokittelu annettujen kategorioiden mukaan. Selitä jokainen kategoria, näytä epäselvien tai soveltamisalan ulkopuolisten viestien esitystapa ja pyydä kategoriaa yhdessä sitä tukevan lähdeilmauksen kanssa. Määritä poimintaan kenttänimet, sallitut arvot ja puuttuvan tiedon käsittely. Anna lyhyeen kirjoitustehtävään faktat ja pyydä sovelluksen seuraavan vaiheen tarvitsemaa täsmällistä katkelmaa. Esimerkkien ja rajoitteiden tulee olla riittävän pieniä pysyäkseen selkeinä myös suuressa lähdekokoelmassa.
Tuottaja ilmoittaa konteksti-ikkunaksi 1047576 tokenia, enimmäistulosteeksi 32768 tokenia ja tietojen katkaisupäiväksi 1. kesäkuuta 2024. Määritykset vastaavat GPT-4.1 Minin ikkunaa säilyttäen Nanon erillisen malli-identiteetin ja nopeaan vastaamiseen painottuvan tehtävän. Nimeä dokumentit ja keskustelun osiot, sisällytä vain operaation kannalta olennainen konteksti ja varaa tilaa täydelle vastaukselle. Hakutulokset tai annettu viiteteksti voivat tarjota mallin oppimia tietoja uudempia faktoja.
Nano tukee suoratoistoa ja Structured Outputs -toimintoa. Skeeman rajaama lopullinen vastaus palvelee eri tarkoitusta kuin funktiokutsu: toinen antaa sovellukselle valmiin tuotoksen, ja toinen pyytää sitä suorittamaan operaation. Structured Outputs tukee JSON Scheman osajoukkoa; määritä vaaditut ominaisuudet ja selkeä esitystapa tuntemattomille arvoille. Käsittele kieltäytymiset ja keskeneräiset vastaukset erikseen ja tarkista poimitut arvot syötettä vasten sen sijaan, että kelvollinen muoto rinnastettaisiin oikeaan johtopäätökseen.
Dokumentoitu työkalujoukko sisältää funktiokutsut, tiedostohaun, koodin tulkinnan, MCP-yhteydet ja erillisen kuvagenerointityökalun. Sovellus antaa työkalukuvaukset ja skeemat, suorittaa mukautetut funktiot ja palauttaa niiden todelliset tulokset. OpenAI suosittelee nimenomaisesti rinnakkaisten työkalukutsujen poistamista käytöstä 14. huhtikuuta 2025 päivätyssä Nano-malliversiossa, koska malli voi pyytää samaa työkalua useita kertoja yhdellä vuorolla. Tämä on malliversiokohtainen suorittamiseen liittyvä huomio, ei syy tulkita useita ehdotettuja kutsuja suoritetuiksi toiminnoiksi.
Kuvasyöte lisää tekstitehtävään visuaalista näyttöä, kuten näkyvän merkinnän lukemista tai kuvakaappauksen tilan kuvausta. Käytä tuettuja PNG-, JPEG- ja WebP-kuvia tai animoimattomia GIF-kuvia, pidä teksti luettavana ja selitä tärkeä havainto. Kuvaopas mainitsee vaikeuksia pienessä tai käännetyssä tekstissä, täsmällisissä sijaintisuhteissa, esinemäärissä ja osassa ei-latinalaista kirjoitusta. Anna ympäröivä konteksti, kun pelkkä rajaus tekisi merkinnästä tai kaaviosta epäselvän. Nanon oma vastaus on tekstiä; kuvagenerointityökalu palauttaa oman erillisen tuotoksensa. OpenAI:n dokumentoidussa kuvantulkintatyönkulussa pyynnön kokonaisdata on rajattu 512 MB:iin ja pyyntö voi sisältää enintään 1500 kuvaa; kuvien ja tekstin pitää myös mahtua mallin kontekstiin.
Tuottajan tiedostotyönkulussa kuvia ymmärtävä malli vastaanottaa PDF-tiedostoista sekä poimitun tekstin että sivukuvat. Muut dokumenttimuodot tuovat poimitun tekstin, ja laskentataulukoiden aineiston täydentäminen huomioi kunkin välilehden enintään 1000 ensimmäistä riviä. Tiedoston pitää olla alle 50 MB, ja pyynnön yhteisraja on 50 MB. Chat Completions tukee PDF-tiedosto-osia, ja dokumentoitu Responses-työnkulku hyväksyy myös muita tiedostotyyppejä. Muiden kuin PDF-dokumenttien upotettuja kaavioita ei välitetä kuvasisältönä, joten PDF-esitysmuoto auttaa visuaalisen näytön ollessa tärkeää.
OpenAI dokumentoi Nanolle kehotteiden välimuistin ja GPT-4.1 Nano -sarjalle Predicted Outputs -toiminnon. Kehotteiden välimuisti käyttää uudelleen siihen soveltuvaa syötteen alkuosaa tuottajan palvelussa. Predicted Outputs antaa sen sijaan pääosin tunnettua tulostekstiä muokkaukseen, kuten dokumentin tai kooditiedoston päivittämiseen sen muuttumattomat osat säilyttäen. Ennustetyönkulku käsittelee vain tekstiä ja sulkee pois muun muassa funktiokutsut sekä logprobs- ja max_completion_tokens-asetukset. Valitse työnkulku todellisen operaation mukaan ja pidä sen tulos yhteydessä alkuperäiseen lähteeseen.
Tuottaja dokumentoi myös ohjatun hienosäädön ja suoran preferenssioptimoinnin Nanon nimetylle GPT-4.1-malliversiolle. Koulutusesimerkit sekä paremmiksi valitut ja hylätyt vastaukset mukauttavat mallia toistuvaan tehtävään; ne eroavat tavallisen pyynnön saamasta kontekstista. Aloita käytännön poiminta- tai luokitteluvaihe selkeillä kategorioilla, esimerkeillä ja täsmällisellä lopputulosmuodolla ja tarkasta sitten, säilyttävätkö palautetut kentät seuraavan vaiheen käyttämät faktat.
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 openai/gpt-4.1-nano: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 openai/gpt-4.1-nano:batch, openai/gpt-4.1-nano | Oletus— |
Kenttäprovider.only | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat openai | 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.0001 / 1K tokenia Tuloste · Tulostokenit $0.0004 / 1K tokenia Syöte · Välimuistin luku $0.000025 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.0001 / 1K tokenia Tuloste · Tulostokenit $0.0004 / 1K tokenia Syöte · Välimuistin luku $0.000025 / 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":"openai/gpt-4.1-nano: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 ['openai/gpt-4.1-nano:batch', 'openai/gpt-4.1-nano']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"openai/gpt-4.1-nano: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 openai/gpt-4.1-nano:batch
Käytä yllä näytettyjä menetelmäpolkuja.