Această pagină a fost tradusă automat. Vezi articolul original în limba engleză.

Consultarea utilizării și a costurilor API

Consultă activitatea API în Analize, verifică numărul de tokeni din răspunsurile API și înțelege filtrele de proiect, exporturile și costurile pentru Nivel de scalare.

Actualizat: 4 days ago

Prezentare generală

Poți verifica utilizarea API în două moduri:

  • Folosește Analize > Utilizare pentru a analiza activitatea API din perioadele de raportare curente și anterioare.

  • Citește informațiile de utilizare dintr-un răspuns API pentru a verifica o anumită cerere.

Playground folosește aceleași apeluri API ca aplicațiile tale. Tokenii folosiți în Playground sunt incluși în utilizarea API a contului tău și li se aplică aceleași reguli de utilizare și tarife.

Accesul la panou

Pentru a accesa Panoul de utilizare, trebuie să fiți proprietarul organizației sau să aveți permisiunea Panou de utilizare.

Consultă datele de utilizare în tabloul de bord

În Platforma API, deschide Analize și selectează Utilizare pentru a analiza proiectul curent. Pentru raportarea la nivelul întregii organizații, selectează Analizele organizației. Selectează perioada de raportare pe care vrei să o analizezi și verific-o din nou după ce comuți între analizele proiectului și cele ale organizației.

Datele din tabloul de bord sunt afișate în UTC. Ține cont de acest fus orar când compari activitatea din tabloul de bord cu jurnalele aplicației tale.

Poate dura ceva timp până când utilizarea recentă apare în tabloul de bord. Dacă activitatea recentă lipsește, verifică din nou mai târziu.

Filtrează datele de utilizare

În secțiunea Analize a proiectului, datele de utilizare se limitează la proiectul selectat. În Analizele organizației, folosește Proiect pentru a selecta proiectele pe care vrei să le analizezi. Toate proiectele include fiecare proiect din organizație, ținând cont de celelalte filtre selectate.

Folosește Filtre pentru a restrânge datele de utilizare după Surse API, Chei API, Modele, Utilizatori sau Nivel de procesare. Surse API îți permite să selectezi Toate sursele API, API pentru agenți sau API direct.

Elimină selecții individuale sau selectează Șterge filtrele pentru a reseta panoul Filtre. Ștergerea filtrelor nu comută între analizele proiectului și cele ale organizației.

Folosește Filtrează din graficul Utilizare pentru a filtra după Lot. Selectează Resetează filtrele graficului pentru a reseta filtrele acelui grafic.

Dacă o funcționalitate nu acceptă filtrele selectate, valorile sale pot fi indisponibile. Valorile indisponibile nu înseamnă utilizare zero.

Dacă un filtru afișează o eroare de permisiune, este posibil să nu ai acces la opțiunile sale. Acest lucru nu înseamnă că nu s-a înregistrat nicio utilizare.

Analizează utilizarea unui anumit utilizator

  1. Deschide Utilizare în vizualizarea Analize a proiectului sau a organizației pe care vrei să o consulți. În tabelul Funcționalități API, selectează Vezi pentru Răspunsuri și completarea discuțiilor.

  2. În Filtre, selectează Utilizatori și selectează utilizatorul. Rezultatele se actualizează imediat.

  3. Consultă graficul și tabelul pentru utilizatorul respectiv.

Pentru a analiza utilizarea unui utilizator pentru toate funcționalitățile, aplică filtrul Utilizatori în prezentarea generală Utilizare. Pentru a compara utilizatorii, șterge filtrul respectiv și selectează fila Utilizatori a tabelului.

Vezi numărul de tokeni pe zi, oră sau minut

Acolo unde sunt disponibile opțiunile de interval în Utilizare, selectează 1z sau 1h pentru a vedea tokenii pe zi sau pe oră ori 1m pentru a analiza tokenii pe minut (TPM). Selectează Automat pentru a lăsa tabloul de bord să aleagă intervalul de timp pentru perioada ta de raportare. Aceste intervale se aplică datelor de utilizare, nu datelor de facturare.

Dacă 1m este dezactivat, selectează o perioadă de raportare mai scurtă sau folosește Selectează pentru a mări și trage pe grafic pentru a restrânge intervalul. Apoi selectează 1m. Apasă Esc pentru a anula o selecție de mărire. Selectează intervalul curent de date din bara de instrumente Analize pentru a alege o altă perioadă de raportare.

Consultă graficele și tabelele de utilizare

Folosește Indicatori pentru a selecta una sau mai multe serii de afișat împreună, inclusiv Tokeni de intrare, Tokeni de intrare necitiți din cache, Tokeni de intrare citiți din cache, Tokeni de intrare scriși în cache, Tokeni audio de intrare, Tokeni de ieșire și Tokeni audio de ieșire. Indicatorii disponibili depind de funcționalitate. Folosește legenda pentru a identifica fiecare serie.

Folosește Grupează după pentru a organiza datele de utilizare pe categorii precum Proiect, Utilizator sau Model, acolo unde sunt disponibile. Filtrele stabilesc ce date de utilizare sunt incluse; gruparea stabilește cum sunt afișate. Comută între graficele cu linii și cele cu bare pentru a analiza tendințele sau a compara categoriile.

Folosește filele tabelului Utilizare pentru a consulta defalcările disponibile. Tabelele afișează valorile relevante pentru fiecare rând, cum ar fi cererile, tokenii de intrare și de ieșire sau unitățile specifice funcționalității.

În Funcționalități API, selectează Vezi pentru o funcționalitate ca să deschizi graficele și defalcările detaliate ale acesteia. Răspunsuri și completarea discuțiilor include grafice separate pentru Tokeni și Cereri, precum și indicatorul Cereri către modele. Filele cu defalcări folosesc aceleași dimensiuni ca prezentarea generală, fără fila Funcționalități API. Folosește Utilizare din calea de navigare pentru a reveni la prezentarea generală.

După ce selectezi o opțiune din Grupează după, graficul poate reuni categoriile suplimentare în Altele. Dacă Altele apare în legenda graficului, selectează eticheta pentru a vedea categoriile incluse și valorile lor de utilizare.

Selectează Compară tablourile de bord pentru a vedea Utilizare alături de un alt tablou de bord pentru aceeași perioadă de raportare. Folosește Tabloul de bord din stânga și Tabloul de bord din dreapta pentru a selecta vizualizările. Dacă intervalul de timp selectat nu este disponibil pentru perechea de tablouri de bord, vizualizarea trece la Automat. Selectează Ieși din comparație pentru a reveni la tabloul de bord.

Investighează utilizarea pe care nu o recunoști

Dacă Utilizare afișează activitate pe care nu o poți asocia cu cererile din jurnalele aplicației tale, efectuează următoarele verificări:

  1. Confirmă organizația, proiectele incluse și perioada de raportare. Folosește UTC când compari marcajele temporale din tabloul de bord cu jurnalele aplicației tale.

  2. Folosește vizualizarea proiectului în cauză sau selectează-l în Proiect din Analizele organizației. Apoi folosește Filtre pentru a restrânge datele de utilizare după cheia API și model și selectează o perioadă de raportare mai scurtă.

  3. Compară activitatea cu jurnalele pentru aceeași perioadă, același proiect și aceeași cheie API. Verifică dacă jurnalele tale acoperă toate aplicațiile sau integrările care folosesc cheia respectivă.

  4. Dacă mai multe aplicații sau integrări folosesc același proiect sau aceeași cheie API, este posibil ca totalul în sine să nu indice care dintre ele a trimis o cerere. Compară tabloul de bord cu înregistrările din fiecare aplicație pentru aceeași perioadă UTC.

  5. Dacă tot nu poți explica utilizarea, contactează Asistența OpenAI și furnizează perioada UTC în cauză, ID-urile organizației și proiectului, identificatorul cheii API și capturi de ecran sau jurnale relevante. Include ID-urile cererilor, dacă sunt disponibile. Nu include chei API secrete.

Exportă datele de utilizare

Pentru a exporta datele de utilizare, selectează pictograma Exportă CSV din bara de instrumente Analize, apoi selectează Date de activitate.

  1. Selectează Funcționalitate API și una sau mai multe dimensiuni din Grupează după.

  2. Verifică Sursă API, Proiecte, Utilizatori, Chei API și Modele. Selecțiile pentru Proiecte și Sursă API sunt preluate din Analize; selectează celelalte filtre de export în caseta de dialog.

  3. Selectează Format fișier, Ora de început, Ora de sfârșit și Interval de timp, apoi selectează Descarcă. Datele calendaristice includ zile UTC complete.

Datele de activitate și de cost pot fi vizualizate și exportate pentru perioada cuprinsă între ora 00:00 UTC a datei de acum un an calendaristic și ziua de azi. Pentru date mai vechi, contactează Asistența OpenAI. Datele zilnice sunt exportate în fișiere care acoperă intervale de 31 de zile.

Pentru reconcilierea facturilor lunare și exporturile pe poziții de factură, consultă: Exportarea detaliilor de utilizare lunară.

Dacă un export de activitate include rânduri cu valori negative, compară rândurile cu aceeași unitate, aceeași grupare și aceleași date calendaristice. Folosește Date de cost pentru sumele facturate. Un rând de activitate cu valoare negativă nu dovedește, în sine, că s-a aplicat o creditare facturii tale.

Analizează cheltuielile

Deschide Analize și selectează Cheltuieli pentru a analiza costurile proiectului curent. Pentru costurile întregii organizații, selectează Analizele organizației, apoi Cheltuieli.

Verifică intervalul curent de date și filtrele înainte de a compara costurile cu utilizarea. Utilizare și Cheltuieli oferă filtre diferite; un filtru disponibil într-un tablou de bord poate să nu se aplice în celălalt.

Folosește Surse API, Chei API, Modele și Poziții de factură pentru a restrânge datele despre cheltuieli. În analizele organizației, folosește Proiect pentru a include proiectele pe care vrei să le analizezi. Folosește filele Poziții de factură, Chei API, Utilizatori, Proiecte și Modele ale tabelului pentru defalcările disponibile.

O valoare indisponibilă pentru limita de cheltuieli nu înseamnă că limita ta este zero sau că a fost aplicată o limită nouă. Permisiunile de acces, o limită nesetată sau o cerere eșuată pot împiedica afișarea unei valori în tabloul de bord.

Verifică starea serviciului

Dacă organizația ta are acces la Starea serviciului, deschide acel tablou de bord în Analize pentru a analiza performanța API. Pentru eligibilitate și definițiile indicatorilor, consultă: Depanarea erorilor API și a problemelor de latență.

Vezi creditele acordate

Detaliile despre creditele acordate sunt disponibile pe pagina de facturare a organizației tale.

Creditele acordate și utilizarea API oferă informații diferite: creditele acordate arată creditele asociate organizației tale, iar utilizarea arată activitatea API a acesteia.

Consultați utilizarea și costurile Nivelului de scalare

Dacă organizația dvs. are activat Nivelul de scalare și aveți accesul necesar, deschideți pagina de utilizare a Nivelului de scalare pentru informații detaliate.

Costurile pachetelor Nivelului de scalare sunt atribuite organizației, nu proiectelor individuale.

Utilizarea este mai mare decât zero, dar cheltuielile proiectului sunt zero

Verifică dacă utilizarea modelului este acoperită de alocarea ta pentru Nivel de scalare. Dacă întreaga utilizare a modelului respectiv se încadrează în alocarea TPM pentru Nivel de scalare, proiectul poate afișa utilizare fără cheltuieli suplimentare pentru model.

Costul abonamentului Nivel de scalare rămâne la nivelul organizației. Analizează cheltuielile întregii organizații, în loc să te bazezi pe cheltuielile unui singur proiect.

Analizează mai multe organizații

Tabloul de bord Utilizare nu cumulează datele de cost sau de utilizare din mai multe organizații. Fiecare organizație, inclusiv o suborganizație, este tratată separat.

Pentru a vedea o suborganizație, selecteaz-o în selectorul de organizații.

Dacă ai nevoie de raportare cumulată, ia în considerare folosirea proiectelor dintr-o singură organizație în locul suborganizațiilor separate sau folosește API-ul de utilizare pentru o analiză personalizată.

Verifică utilizarea tokenilor într-un răspuns API

Numele câmpurilor pentru utilizarea tokenilor depind de punctul final.

Număr de tokeniCompletarea discuțiilorRăspunsuri
Tokeni de intrareusage.prompt_tokensusage.input_tokens
Tokeni de ieșireusage.completion_tokensusage.output_tokens
Total tokeniusage.total_tokensusage.total_tokens

Răspunsurile pentru completarea discuțiilor pot include informații despre utilizarea tokenilor. Iată câteva exemple:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

În funcție de punctul final și de model, detaliile de utilizare pot include și numărul de tokenuri de intrare din cache și de tokenuri de raţionament. Aceste date ajută la explicarea motivului pentru care lungimea vizibilă a unui răspuns nu reflectă consumul total de tokenuri.

Pentru explicații despre diferitele categorii de tokenuri, consultă: Înțelegerea și numărarea tokenurilor.

Într-un răspuns de transcriere care raportează consumul de tokenuri, tokenurile de intrare audio și text sunt deja incluse în input_tokens. Nu adăuga din nou aceste componente la totalul tokenurilor de intrare. Compară separat output_tokens.

Obține date despre consum din răspunsurile Chat Completions transmise în flux

Pentru o cerere Chat Completions cu răspuns transmis în flux, include:

{
"stream": true,
"stream_options": {
"include_usage": true
}
}

Când include_usage este activat, un fragment suplimentar transmis înainte de data: [DONE] conține datele despre consum pentru întreaga cerere. Tabloul choices din acest fragment este gol. În celelalte fragmente, usage are valoarea null.

Dacă fluxul este întrerupt, este posibil să nu primești acel fragment final cu datele despre consum. Absența fragmentului final nu dovedește că cererea nu a consumat niciun token.

Această configurație este specifică pentru Chat Completions. Pentru detalii, consultă: Documentația de referință pentru API pentru completarea discuțiilor.

A fost util acest articol?