Miten Batch API toimii?
Batch API -endpoint, kuten tässä on dokumentoitu, antaa käyttäjien lähettää pyyntöjä asynkroniseen eräkäsittelyyn. Käsittelemme nämä pyynnöt 24 tunnin kuluessa. Kunkin pyynnön tiedot luetaan etukäteen ladatusta tiedostosta, ja vastaukset kirjoitetaan tulostiedostoon. Voit kysellä eräobjektista tilapäivityksiä ja tuloksia.
Mikä on Batch API:n hinnoittelu?
Kukin malli tarjotaan 50 %:n kustannusalennuksella verrattuna synkronisiin API-rajapintoihin. Tässä on lisää tietoa API-hinnoittelustamme.
Mitä malleja voin käyttää erissä?
Batch API on laajasti saatavilla useimmissa malleissamme, mutta ei kaikissa. Katso mallien viitedokumentaatiosta, että käyttämäsi malli tukee Batch API:a.
Mitä tapahtuu, jos API ei suorita pyyntöäni luvatun ajan kuluessa?
Tavoitteenamme on käsitellä kaikki pyynnöt 24 tunnin kuluessa. Jos erä vanhenee (eli sitä ei voitu suorittaa SLA-aikaikkunan kuluessa), jäljellä oleva työ peruutetaan ja kaikki jo valmistunut työ palautetaan. Kehittäjiä veloitetaan kaikesta valmistuneesta työstä.
Mikä on raja sille, kuinka monta pyyntöä voin käsitellä eränä?
Embeddings API -rajapinnoissa on 1 miljoonan kerralla jonossa olevan pyynnön raja.
Kaikissa muissa API-rajapinnoissa eränä käsiteltävien pyyntöjen määrää ei ole rajoitettu; kullakin käyttötasolla on kuitenkin siihen liittyvä erien pyyntöraja. Erien pyyntöraja sisältää syötetokenien enimmäismäärän, joka sinulla on jonossa kerralla. Löydät pyyntörajasi tästä.
Voinko muuttaa aikaa, jonka kuluessa saan vastauksen Batch API:lta?
Nykyinen määritetty aikaikkunamme on 24 tuntia. Emme tällä hetkellä voi muuttaa tätä ajanjaksoa.
Tukeeko Batch API suoratoistoa?
Ei, Batch API ei tue suoratoistoa. Eräpyynnöt palauttavat tulokset tulostiedostojen kautta suoratoistettujen vastausten sijaan.
Tukeeko Batch API kuvia?
Kyllä, Batch API tukee kuvia.
Sain virheilmoituksen ”The URL provided for this request does not prefix-match the batch endpoint”. Mitä minun pitäisi tehdä?
Jos saat tämän virheen, URL-osoitteesi on muotoiltu virheellisesti Batch API -endpointia varten. Katso dokumentaatiostamme tästä ja varmista, että kutsut endpointia oikein.
Lasketaanko Batch API:n käyttö muihin pyyntörajoihini?
Batch API:n pyyntörajat ovat täysin erillisiä nykyisistä rajoista.
Mitä tapahtuu, jos erä peruutetaan?
Jos erä peruutetaan manuaalisesti, jo valmistuneet tulokset palautetaan. Kehittäjiä veloitetaan kaikesta valmistuneesta työstä.
Mitä tapahtuu, jos erä vanhenee?
Jos erä vanhenee (eli sitä ei voitu suorittaa SLA-aikaikkunan kuluessa), jäljellä oleva työ peruutetaan ja kaikki jo valmistunut työ palautetaan. Kehittäjiä veloitetaan kaikesta valmistuneesta työstä.
Mitä tiloja erätöissä voi olla?
Erätyöllä voi olla jokin seuraavista tiloista: Validating, Failed, In Progress, Finalizing, Completed, Expired, Cancelling ja Cancelled. Jos tarkistat API:n tila-arvoja ohjelmallisesti, käytä pienillä kirjaimilla kirjoitettuja literaaleja: validating, failed, in_progress, finalizing, completed, expired, cancelling ja cancelled.
Validating: Ladatun tiedoston vahvistus on käynnissä ennen kuin erä voi alkaa.
Failed: Tiedoston vahvistusprosessi epäonnistui.
In Progress: Tiedosto vahvistettiin onnistuneesti, ja eräprosessi on käynnissä.
Finalizing: Erätyö on valmistunut, ja tuloksia valmistellaan.
Completed: Erätyö on valmis, ja tulokset ovat valmiina.
Expired: Erää ei voitu suorittaa SLA-aikaikkunan kuluessa.
Cancelling: Erätyön peruutus on aloitettu.
Cancelled: Erätyö peruutettiin.
Miten voin tarkistaa, mitä erätöitä olen jo luonut?
Voit hakea luettelon kaikista erätöistäsi käyttämällä tässä määritettyä API-kutsua.
Tuetaanko tietojen määräaikaista säilyttämistä tässä endpointissa?
Jos organisaatiossasi on käytössä tietojen määräaikainen säilyttäminen, huomaa, että tietojen määräaikainen säilyttäminen ei koske Batch API:a. ZDR-organisaatiot voivat luoda erätöitä, mutta erien syötetiedostot, tulosteet, virheet ja väliaikaiset artefaktit säilytetään määritettyjen Batch-, File Service- ja Sediment-säilytyskäytäntöjen mukaisesti.