Com funciona l’API Batch?
El punt final de l’API Batch, documentat aquí, permet als usuaris enviar peticions per al processament per lots asíncron. Processarem aquestes peticions en un termini de 24 hores. Els detalls de cada petició es llegiran d’un fitxer carregat prèviament, i les respostes s’escriuran en un fitxer de sortida. Pots consultar l’objecte de lot per obtenir actualitzacions d’estat i resultats.
Quin és el preu de l’API Batch?
Cada model s’oferirà amb un descompte del 50% sobre el cost respecte de les API síncrones. Aquí tens més informació sobre els preus de la nostra API.
Quins models puc processar per lots?
L’API Batch està àmpliament disponible en la majoria dels nostres models, però no en tots. Consulta la documentació de referència de models per assegurar-te que el model que fas servir admet l’API Batch.
Què passa si l’API no completa la meva petició dins del temps promès?
El nostre objectiu és completar totes les peticions en un termini de 24 hores. Si un lot caduca (és a dir, no s’ha pogut completar dins de la finestra de temps de l’SLA), es cancel·la la feina restant i es retorna qualsevol feina ja completada. Es cobrarà als desenvolupadors qualsevol feina completada.
Quin és el límit de peticions que puc processar per lots?
Les API d’embeddings tenen un límit d’1 milió de peticions en cua alhora.
Per a totes les altres API, no hi ha límit en el nombre de peticions que pots processar per lots; tanmateix, cada nivell d’ús té un límit de peticions per lots associat. El teu límit de peticions per lots inclou el nombre màxim de segments d’entrada que tens en cua alhora. Pots trobar els teus límits de peticions aquí.
Puc canviar el temps que triga l’API Batch a respondre?
La nostra finestra de temps especificada actual és de 24 hores. Actualment no podem canviar aquest període de temps.
S’admet el streaming a l’API Batch?
No, el streaming no s’admet a l’API Batch. Les peticions per lots retornen els resultats mitjançant fitxers de sortida en lloc de respostes en streaming.
S’admeten imatges a l’API Batch?
Sí, s’admeten imatges a l’API Batch.
He rebut un missatge d’error: «L’URL proporcionat per a aquesta petició no coincideix amb el prefix del punt final de lots». Què he de fer?
Si reps aquest error, vol dir que l’URL té un format incorrecte per al punt final de l’API Batch. Consulta la nostra documentació aquí per assegurar-te que crides el punt final correctament.
L’ús de l’API Batch compta per als meus altres límits de peticions?
Els límits de peticions de l’API Batch són completament independents dels límits existents.
Què passa si es cancel·la un lot?
Si un lot es cancel·la manualment, es retornen tots els resultats que ja s’hagin completat. Es cobrarà als desenvolupadors qualsevol feina completada.
Què passa si un lot caduca?
Si un lot caduca (és a dir, no s’ha pogut completar dins de la finestra de temps de l’SLA), es cancel·la la feina restant i es retorna qualsevol feina ja completada. Es cobrarà als desenvolupadors qualsevol feina completada.
Quins estats puc esperar en les tasques per lots?
La tasca per lots pot tenir qualsevol dels estats següents: Validant, Error, En curs, Finalitzant, Completat, Caducat, Cancel·lant i Cancel·lat. Si comproves els valors d’estat de l’API programàticament, utilitza els literals en minúscules: validating, failed, in_progress, finalizing, completed, expired, cancelling i cancelled.
Validant: La validació del fitxer carregat està en curs abans que el lot pugui començar.
Error: El fitxer no ha superat el procés de validació.
En curs: El fitxer s’ha validat correctament i el procés per lots està en marxa.
Finalitzant: La tasca per lots s’ha completat i s’estan preparant els resultats.
Completat: La tasca per lots s’ha completat i els resultats estan a punt.
Caducat: El lot no s’ha pogut completar dins de la finestra de temps de l’SLA.
Cancel·lant: S’ha iniciat la cancel·lació de la tasca per lots.
Cancel·lat: La tasca per lots s’ha cancel·lat.
Com puc comprovar quines tasques per lots ja he creat?
Pots obtenir una llista de totes les teves tasques per lots mitjançant la crida a l’API especificada aquí.
S’admet la retenció de dades nul·la en aquest punt final?
Si tens la retenció de dades nul·la activada per a la teva organització, tingues en compte que la retenció de dades nul·la no s’aplica a l’API Batch. Les organitzacions ZDR poden crear tasques per lots, però els fitxers d’entrada per lots, les sortides, els errors i els artefactes intermedis es conserven d’acord amb les polítiques de retenció configurades de Batch, File Service i Sediment.