Halaman ini diterjemah oleh mesin. Lihat artikel asal dalam bahasa Inggeris.

Menyemak penggunaan dan kos API

Semak aktiviti API dalam Analitis, semak bilangan token dalam respons API dan fahami penapis projek, eksport serta kos Peringkat Skala.

Dikemas kini: 3 days ago

Gambaran keseluruhan

Anda boleh menyemak penggunaan API dengan dua cara:

  • Gunakan Analitis > Penggunaan untuk menyemak aktiviti API bagi tempoh pelaporan semasa dan terdahulu.

  • Baca maklumat penggunaan dalam respons API untuk menyemak permintaan individu.

Playground menggunakan panggilan API yang sama seperti aplikasi anda. Tokennya dikira dalam penggunaan API akaun anda dan tertakluk pada peraturan penggunaan serta harga yang sama.

Akses papan pemuka

Anda mestilah pemilik organisasi atau mempunyai kebenaran Papan Pemuka Penggunaan untuk mengakses Papan Pemuka Penggunaan.

Semak penggunaan dalam papan pemuka

Dalam Platform API, buka Analitis dan pilih Penggunaan untuk menyemak projek semasa. Untuk pelaporan seluruh organisasi, pilih Analitis organisasi. Pilih tempoh pelaporan yang ingin anda semak, dan semak semula tempoh itu selepas beralih antara analitis projek dengan analitis organisasi.

Data papan pemuka dipaparkan mengikut UTC. Ambil kira zon waktu tersebut semasa membandingkan aktiviti papan pemuka dengan log aplikasi anda.

Penggunaan terkini mungkin mengambil masa untuk muncul dalam papan pemuka. Jika aktiviti terkini belum muncul, semak semula kemudian.

Tapis penggunaan

Dalam Analitis projek, skop penggunaan terhad kepada projek yang dipilih. Dalam Analitis organisasi, gunakan Projek untuk memilih projek yang ingin anda semak. Semua projek merangkumi setiap projek dalam organisasi, tertakluk pada penapis lain yang telah anda pilih.

Gunakan Penapis untuk mengecilkan skop penggunaan mengikut Sumber API, Kunci API, Model, Pengguna atau Peringkat pemprosesan. Sumber API membolehkan anda memilih Semua sumber API, API Ejen atau API Langsung.

Alih keluar pilihan satu demi satu atau pilih Kosongkan penapis untuk menetapkan semula panel Penapis. Mengosongkan penapis tidak menukar paparan antara analitis projek dengan analitis organisasi.

Gunakan Tapis pada carta Penggunaan untuk menapis mengikut Kelompok. Pilih Tetapkan semula penapis carta untuk menetapkan semula penapis carta tersebut.

Jika sesuatu keupayaan tidak menyokong penapis yang dipilih, nilainya mungkin tidak tersedia. Nilai yang tidak tersedia tidak bermakna penggunaan sifar.

Jika penapis memaparkan ralat kebenaran, anda mungkin tidak mempunyai akses kepada pilihannya. Ini tidak bermakna tiada penggunaan direkodkan.

Semak penggunaan individu

  1. Buka Penggunaan dalam paparan Analitis projek atau organisasi yang ingin anda semak. Dalam jadual Keupayaan API, pilih Lihat untuk Respons dan pelengkapan sembang.

  2. Dalam Penapis, pilih Pengguna dan pilih pengguna berkenaan. Hasil dikemas kini serta-merta.

  3. Semak carta dan jadual untuk pengguna tersebut.

Untuk menyemak penggunaan seseorang pengguna merentas keupayaan, gunakan penapis Pengguna pada gambaran keseluruhan Penggunaan. Untuk membandingkan pengguna, kosongkan penapis tersebut dan pilih tab jadual Pengguna.

Lihat token setiap hari, jam atau minit

Jika kawalan selang tersedia dalam Penggunaan, pilih 1d atau 1h untuk melihat token mengikut hari atau jam, atau 1m untuk meneliti token seminit (TPM). Pilih Automatik untuk membolehkan papan pemuka memilih selang masa bagi tempoh pelaporan anda. Selang ini terpakai pada data penggunaan, bukan data pengebilan.

Jika 1m dinyahdayakan, pilih tempoh pelaporan yang lebih pendek atau gunakan Pilih untuk zum dan seret merentasi carta untuk mengecilkan julat. Kemudian pilih 1m. Tekan Esc untuk membatalkan pilihan zum. Pilih julat tarikh semasa dalam bar alat Analitis untuk memilih tempoh pelaporan yang berbeza.

Semak carta dan jadual penggunaan

Gunakan Metrik untuk memilih satu atau lebih siri untuk dipaparkan bersama, termasuk Token input, Token input tidak dicache, Token input dicache, Token input penulisan cache, Token audio input, Token output dan Token audio output. Metrik yang tersedia bergantung pada keupayaan. Gunakan petunjuk carta untuk mengenal pasti setiap siri.

Gunakan Kumpulkan mengikut untuk menyusun penggunaan mengikut kategori seperti Projek, Pengguna atau Model, jika tersedia. Penapis menentukan penggunaan yang disertakan; pengumpulan menentukan cara penggunaan dipaparkan. Beralih antara carta garis dengan carta bar untuk meneliti trend atau membandingkan kategori.

Gunakan tab jadual Penggunaan untuk menyemak pecahan yang tersedia. Jadual menunjukkan ukuran yang berkaitan bagi setiap baris, seperti permintaan, token input dan output, atau unit khusus keupayaan.

Dalam Keupayaan API, pilih Lihat untuk sesuatu keupayaan bagi membuka carta dan pecahan terperincinya. Respons dan pelengkapan sembang merangkumi carta Token dan Permintaan yang berasingan serta metrik Permintaan model. Tab pecahannya menggunakan dimensi yang sama seperti gambaran keseluruhan, tanpa tab Keupayaan API. Gunakan pautan Penggunaan dalam jejak navigasi untuk kembali ke gambaran keseluruhan.

Selepas anda memilih pilihan Kumpulkan mengikut, carta mungkin menggabungkan kategori tambahan ke dalam Lain-lain. Jika Lain-lain muncul dalam petunjuk carta, pilih labelnya untuk melihat kategori yang disertakan dan nilai penggunaannya.

Pilih Bandingkan papan pemuka untuk melihat Penggunaan bersebelahan papan pemuka lain bagi tempoh pelaporan yang sama. Gunakan Papan pemuka kiri dan Papan pemuka kanan untuk memilih paparan. Jika selang masa yang dipilih tidak tersedia untuk pasangan papan pemuka tersebut, paparan akan beralih kepada Automatik. Pilih Keluar daripada perbandingan untuk kembali ke papan pemuka.

Siasat penggunaan yang tidak anda kenali

Jika Penggunaan menunjukkan aktiviti yang tidak dapat anda padankan dengan permintaan dalam log aplikasi anda, lakukan semakan berikut:

  1. Sahkan organisasi, skop projek dan tempoh pelaporan. Gunakan UTC semasa membandingkan cap masa papan pemuka dengan log aplikasi anda.

  2. Gunakan paparan projek untuk projek yang terjejas, atau pilih projek itu di bawah Projek dalam Analitis organisasi. Kemudian gunakan Penapis untuk mengecilkan skop penggunaan mengikut kunci API dan model, serta pilih tempoh pelaporan yang lebih pendek.

  3. Bandingkan aktiviti tersebut dengan log bagi tempoh, projek dan kunci API yang sama. Semak sama ada log anda meliputi semua aplikasi atau integrasi yang menggunakan kunci tersebut.

  4. Jika beberapa aplikasi atau integrasi berkongsi projek atau kunci API yang sama, jumlah keseluruhan sahaja mungkin tidak dapat menunjukkan aplikasi atau integrasi yang menghantar sesuatu permintaan. Bandingkan papan pemuka dengan rekod daripada setiap aplikasi bagi tempoh UTC yang sama.

  5. Jika anda masih tidak dapat mengenal pasti punca penggunaan tersebut, hubungi Sokongan OpenAI dan sertakan tempoh UTC yang terjejas, ID organisasi dan projek, pengecam kunci API serta tangkapan skrin atau log yang berkaitan. Sertakan ID permintaan jika tersedia. Jangan sertakan kunci API rahsia.

Eksport data penggunaan

Untuk mengeksport penggunaan, pilih ikon Eksport CSV dalam bar alat Analitis, kemudian pilih Data aktiviti.

  1. Pilih Keupayaan API dan satu atau lebih dimensi Kumpulkan mengikut.

  2. Semak Sumber API, Projek, Pengguna, Kunci API dan Model. Projek dan Sumber API telah dipilih berdasarkan pilihan dalam Analitis; pilih penapis eksport lain dalam dialog.

  3. Pilih Format fail, Masa mula, Masa tamat dan Selang masa, kemudian pilih Muat turun. Tarikh merangkumi hari penuh mengikut UTC.

Data aktiviti dan kos tersedia untuk dilihat dan dieksport dari 00:00 UTC pada tarikh satu tahun kalendar yang lalu hingga hari ini. Untuk data yang lebih lama, hubungi Sokongan OpenAI. Data harian dieksport dalam fail yang masing-masing meliputi tempoh 31 hari.

Untuk penyelarasan invois bulanan dan eksport item baris, lihat: Mengeksport butiran penggunaan bulanan.

Jika eksport Aktiviti mengandungi baris bernilai negatif, bandingkan baris yang mempunyai unit, pengumpulan dan tarikh yang sama. Gunakan Data kos untuk melihat amaun yang dibilkan. Baris aktiviti bernilai negatif sahaja tidak membuktikan bahawa kredit telah diberikan pada invois anda.

Semak perbelanjaan

Buka Analitis dan pilih Perbelanjaan untuk menyemak kos bagi projek semasa. Untuk kos seluruh organisasi, pilih Analitis organisasi dan kemudian Perbelanjaan.

Semak julat tarikh semasa dan penapis sebelum membandingkan kos dengan penggunaan. Penggunaan dan Perbelanjaan menawarkan penapis yang berbeza; penapis yang tersedia dalam satu papan pemuka mungkin tidak terpakai pada papan pemuka yang satu lagi.

Gunakan Sumber API, Kunci API, Model dan Item baris untuk mengecilkan skop perbelanjaan. Dalam analitis organisasi, gunakan Projek untuk menyertakan projek yang ingin anda semak. Gunakan tab jadual Item baris, Kunci API, Pengguna, Projek dan Model untuk melihat pecahan yang tersedia.

Nilai had perbelanjaan yang tidak tersedia tidak bermakna had anda ialah sifar atau had baharu telah digunakan. Kebenaran akses, had yang belum ditetapkan atau permintaan yang gagal boleh menghalang papan pemuka daripada memaparkan nilai.

Semak kesihatan perkhidmatan

Jika organisasi anda mempunyai akses kepada Kesihatan perkhidmatan, buka papan pemuka tersebut dalam Analitis untuk menyemak prestasi API. Untuk kelayakan dan takrif metrik, lihat: Menyelesaikan masalah ralat dan kependaman API.

Lihat pemberian kredit

Butiran pemberian kredit tersedia pada halaman Pengebilan organisasi anda.

Pemberian kredit dan penggunaan API memberikan maklumat yang berbeza: pemberian kredit menunjukkan kredit yang dikaitkan dengan organisasi anda, manakala penggunaan menunjukkan aktiviti APInya.

Semak penggunaan dan kos Peringkat Skala

Jika Peringkat Skala didayakan untuk organisasi anda dan anda mempunyai akses yang diperlukan, buka halaman penggunaan Peringkat Skala untuk melihat butiran penggunaan.

Kos pakej Peringkat Skala diperuntukkan kepada organisasi, bukan kepada setiap projek.

Penggunaan melebihi sifar, tetapi perbelanjaan projek ialah sifar

Semak sama ada penggunaan model diliputi oleh peruntukan Peringkat Skala anda. Jika semua penggunaan model tersebut masih dalam peruntukan TPM Peringkat Skala, projek boleh menunjukkan penggunaan tanpa perbelanjaan model tambahan.

Kos langganan Peringkat Skala kekal pada peringkat organisasi. Semak perbelanjaan seluruh organisasi dan bukannya bergantung pada perbelanjaan satu projek sahaja.

Semak berbilang organisasi

Papan Pemuka Penggunaan tidak menggabungkan data kos atau penggunaan merentas organisasi. Setiap organisasi, termasuk suborganisasi, dikendalikan secara berasingan.

Untuk melihat suborganisasi, pilih suborganisasi tersebut dalam pemilih organisasi.

Jika anda memerlukan pelaporan gabungan, pertimbangkan untuk menggunakan projek dalam satu organisasi dan bukannya suborganisasi yang berasingan, atau gunakan API Penggunaan untuk analisis tersuai.

Semak penggunaan token dalam respons API

Nama medan penggunaan token bergantung pada titik akhir.

Bilangan tokenPelengkapan sembangRespons
Token inputusage.prompt_tokensusage.input_tokens
Token outputusage.completion_tokensusage.output_tokens
Jumlah tokenusage.total_tokensusage.total_tokens

Respons Pelengkapan sembang boleh mengandungi maklumat penggunaan token. Antara contohnya:

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

Bergantung pada titik akhir dan model, butiran penggunaan juga boleh merangkumi kiraan token input yang dicache dan token penaakulan. Kiraan ini membantu menjelaskan sebab panjang respons yang kelihatan tidak menggambarkan keseluruhan penggunaan tokennya.

Untuk penjelasan tentang pelbagai kategori token, lihat: Memahami dan mengira token.

Bagi respons transkripsi yang melaporkan penggunaan token, token input audio dan teks sudah termasuk dalam input_tokens. Jangan tambahkan komponen tersebut sekali lagi pada jumlah input. Bandingkan output_tokens secara berasingan.

Dapatkan maklumat penggunaan daripada Pelengkapan Sembang yang distrim

Untuk permintaan Pelengkapan Sembang secara penstriman, sertakan:

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

Apabila include_usage diaktifkan, satu cebisan tambahan sebelum data: [DONE] mengandungi maklumat penggunaan untuk keseluruhan permintaan. Tatasusunan choices dalam cebisan itu kosong. Cebisan lain mempunyai nilai usage yang ditetapkan kepada null.

Jika strim terganggu, anda mungkin tidak menerima cebisan terakhir yang mengandungi maklumat penggunaan itu. Ketiadaan cebisan terakhir tidak membuktikan bahawa permintaan itu tidak menggunakan sebarang token.

Konfigurasi ini khusus untuk Pelengkapan Sembang. Untuk butiran lanjut, lihat: Rujukan API pelengkapan sembang.

Adakah artikel ini membantu?