Genel bakış
API kullanımını iki şekilde inceleyebilirsiniz:
Mevcut ve geçmiş faturalandırma dönemlerindeki etkinliği incelemek için Kullanım Panosunu kullanın.
Tek bir isteği kontrol etmek için API yanıtındaki kullanım bilgilerini okuyun.
Playground, uygulamalarınızla aynı API çağrılarını kullanır. Burada kullanılan tokenlar hesabınızın API kullanımına dahil edilir ve aynı kullanım kuralları ile fiyatlandırmaya tabidir.
Panoya erişim
Kullanım Panosuna erişmek için kuruluş sahibi olmanız veya Kullanım Panosu iznine sahip olmanız gerekir.
Panodaki kullanımı inceleme
Kullanım Panosunu açın, incelemek istediğiniz kuruluşu seçin ve ilgili raporlama dönemini belirleyin.
Pano verileri UTC saat diliminde gösterilir. Panodaki etkinliği uygulama günlüklerinizle karşılaştırırken bu saat dilimini dikkate alın.
Projeleri seçme
Panonun kendine ait bir proje seçicisi vardır. Bu seçici, API Platformunun başka bir bölümünde seçilen projeden bağımsız çalışır.
Bir projeyi, birden fazla projeyi veya tüm projeleri incelemek için panodaki seçiciyi kullanın. Kuruluşun genel verilerini görmek için seçili projeleri temizleyin. Hiçbir proje seçili değilken pano tüm projelerin verilerini gösterir.
Belirli bir kullanıcının kullanımını inceleme
Bir kullanıcının Responses ve Chat Completions kullanımını incelemek için:
Kullanım Panosunda API özellikleri > Responses ve Chat Completions bölümüne gidin.
Filtreleme ölçütü'nü seçin.
Kullanıcılar altında kullanıcıyı, ardından Filtreleri uygula'yı seçin.
Dakika başına token sayısını görüntüleme
Kullanım ayrıntıları sayfalarında zaman aralığı seçilebilir. Dakika başına token (TPM) değerini incelemek için 1 dakikalık aralığı seçin.
Bu aralık faturalandırma verilerine değil, kullanım verilerine uygulanır.
Kullanım verilerini dışa aktarma
Dışa aktarılabilecek tarih aralığında herhangi bir sınır yoktur. Uzun bir dönemi kapsayan dışa aktarımlar birden fazla dosyaya bölünebilir.
Aylık fatura mutabakatı ve kalem bazında dışa aktarımlar için bkz. Aylık kullanım ayrıntılarını dışa aktarma.
Kredi tahsislerini görüntüleme
Kredi tahsislerinin ayrıntılarına kuruluşunuzun Faturalandırma sayfasından ulaşabilirsiniz.
Kredi tahsisleri ile API kullanımı farklı soruları yanıtlar: kredi tahsisleri kuruluşunuzla ilişkilendirilmiş kredileri, kullanım ise kuruluşunuzun API etkinliğini gösterir.
Ölçek Kademesi kullanımını ve maliyetlerini inceleme
Kuruluşunuzda Ölçek Kademesi etkinse ve gerekli erişime sahipseniz ayrıntılı kullanım bilgileri için Ölçek Kademesi kullanım sayfasını açın.
Ölçek Kademesi paketlerinin maliyetleri tek tek projelere değil, kuruluşa yansıtılır.
Kullanım sıfırdan büyük ancak proje harcaması sıfır
Model kullanımının Ölçek Kademesi tahsisatınız kapsamında olup olmadığını kontrol edin. Söz konusu modelin tüm kullanımı Ölçek Kademesi TPM tahsisatı dahilindeyse proje, ek model harcaması olmadan kullanım gösterebilir.
Ölçek Kademesi abonelik maliyeti kuruluş düzeyinde kalır. İncelemek için:
Kullanım Panosundaki proje filtresini temizleyin.
Harcama kategorileri'ni seçin.
Birden fazla kuruluşu inceleme
Kullanım Panosu, farklı kuruluşların maliyet veya kullanım verilerini birleştirmez. Alt kuruluşlar dahil olmak üzere her kuruluş ayrı ele alınır.
Bir alt kuruluşu görüntülemek için kuruluş seçiciden ilgili kuruluşu seçin.
Birleşik raporlama gerekiyorsa ayrı alt kuruluşlar yerine tek bir kuruluş içindeki projeleri kullanmayı değerlendirin veya özel analizler için Usage API'yi kullanın.
API yanıtındaki token kullanımını kontrol etme
Token kullanımı alanlarının adları uç noktaya göre değişir.
| Token sayısı | Chat Completions | Responses |
| Girdi tokenları | usage.prompt_tokens | usage.input_tokens |
| Çıktı tokenları | usage.completion_tokens | usage.output_tokens |
| Toplam token sayısı | usage.total_tokens | usage.total_tokens |
Örneğin bir Chat Completions yanıtı şunları içerebilir:
| { "usage": { "prompt_tokens": 13, "completion_tokens": 7, "total_tokens": 20 }} |
Uç noktaya ve modele bağlı olarak kullanım ayrıntıları, önbelleğe alınmış girdi ve akıl yürütme tokenlarının sayılarını da içerebilir. Bu bilgiler, yanıtın görünen uzunluğunun toplam token kullanımını neden yansıtmadığını açıklar.
Farklı token kategorileri hakkında açıklama için bkz. Tokenları anlama ve sayma.
Akış hâlindeki Chat Completions'dan kullanım verilerini alma
Akışlı bir Chat Completions isteğine şunları ekleyin:
| { "stream": true, "stream_options": { "include_usage": true }} |
include_usage etkinleştirildiğinde data: [DONE] öğesinden önceki ek bir parça, isteğin tamamına ait kullanım bilgilerini içerir. Bu parçanın choices dizisi boştur. Diğer parçalardaki usage değeri null'dır.
Akış kesintiye uğrarsa bu son kullanım parçasını alamayabilirsiniz. Son parçanın gelmemesi, istekte hiç token kullanılmadığını göstermez.
Bu yapılandırma yalnızca Chat Completions'a özgüdür. Ayrıntılar için Chat Completions API referansına bakın.