Genel bakış
API kullanımını iki şekilde inceleyebilirsiniz:
Mevcut ve geçmiş raporlama dönemlerindeki API etkinliğini incelemek için Analizler > Kullanım bölümünü 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. Playground’da kullanılan token’lar 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.
Panoda kullanımı inceleyin
Mevcut projeyi incelemek için API Platformu’nda Analizler bölümünü açın ve Kullanım seçeneğini seçin. Kuruluş genelinde raporlama için Kuruluş analizleri seçeneğini seçin. İncelemek istediğiniz raporlama dönemini seçin ve proje ile kuruluş analizleri arasında geçiş yaptıktan sonra dönemi tekrar kontrol edin.
Pano verileri UTC’ye göre görüntülenir. Panodaki etkinliği uygulama günlüklerinizle karşılaştırırken bu saat dilimini dikkate alın.
Son kullanımın panoda görünmesi zaman alabilir. Son etkinlik görünmüyorsa daha sonra tekrar kontrol edin.
Kullanımı filtreleyin
Projenin Analizler bölümünde kullanım, seçili projeyle sınırlıdır. Kuruluş analizleri bölümünde incelemek istediğiniz projeleri seçmek için Proje seçeneğini kullanın. Tüm projeler, seçtiğiniz diğer filtreler de uygulanarak kuruluştaki tüm projeleri kapsar.
Filtreler ile kullanımı API kaynakları, API anahtarları, Modeller, Kullanıcılar veya İşleme kademesi bazında daraltın. API kaynakları altında Tüm API kaynakları, Agents API veya Doğrudan API seçeneğini seçebilirsiniz.
Seçimleri tek tek kaldırın veya Filtreler panelini sıfırlamak için Filtreleri temizle seçeneğini kullanın. Filtreleri temizlemek, proje ve kuruluş analizleri arasında geçiş yapmaz.
Toplu iş bazında filtrelemek için Kullanım grafiğindeki Filtrele seçeneğini kullanın. Bu grafiğin filtrelerini sıfırlamak için Grafik filtrelerini sıfırla seçeneğini kullanın.
Bir özellik seçilen filtreleri desteklemiyorsa bu özelliğe ait değerler görüntülenemeyebilir. Değerlerin görüntülenememesi, kullanımın sıfır olduğu anlamına gelmez.
Bir filtre izin hatası gösteriyorsa seçeneklerine erişiminiz olmayabilir. Bu, hiçbir kullanım kaydedilmediği anlamına gelmez.
Tek bir kullanıcının kullanımını inceleyin
İncelemek istediğiniz projenin veya kuruluşun Analizler görünümünde Kullanım bölümünü açın. API özellikleri tablosunda Yanıtlar ve sohbet tamamlamaları için Görüntüle seçeneğini kullanın.
Filtreler bölümünde Kullanıcılar seçeneğini, ardından kullanıcıyı seçin. Sonuçlar hemen güncellenir.
Bu kullanıcıya ait grafiği ve tabloyu inceleyin.
Bir kullanıcının farklı özelliklerdeki kullanımını incelemek için Kullanım genel bakışında Kullanıcılar filtresini uygulayın. Kullanıcıları karşılaştırmak için bu filtreyi temizleyin ve tablodaki Kullanıcılar sekmesini seçin.
Günlük, saatlik veya dakikalık token sayılarını görüntüleyin
Kullanım bölümünde zaman aralığı kontrolleri varsa token sayılarını günlük veya saatlik görüntülemek için 1g ya da 1sa, dakika başına token sayısını (TPM) incelemek için 1dk seçeneğini seçin. Panonun raporlama döneminize uygun zaman aralığını seçmesi için Otomatik seçeneğini kullanın. Bu aralıklar faturalandırma verilerine değil, kullanım verilerine uygulanır.
1dk devre dışıysa daha kısa bir raporlama dönemi seçin veya Yakınlaştırmak için seç seçeneğini kullanıp grafik üzerinde sürükleyerek aralığı daraltın. Ardından 1dk seçeneğini seçin. Yakınlaştırma seçimini iptal etmek için Esc tuşuna basın. Farklı bir raporlama dönemi belirlemek için Analizler araç çubuğundaki mevcut tarih aralığını seçin.
Kullanım grafiklerini ve tablolarını inceleyin
Metrikler seçeneğini kullanarak birlikte görüntülenecek bir veya daha fazla seri seçin: Girdi token’ları, Önbelleğe alınmamış girdi token’ları, Önbelleğe alınmış girdi token’ları, Önbelleğe yazılan girdi token’ları, Ses girdisi token’ları, Çıktı token’ları ve Ses çıktısı token’ları. Kullanılabilir metrikler özelliğe göre değişir. Her seriyi ayırt etmek için grafik açıklamasını kullanın.
Kullanımı, mevcut seçeneklere bağlı olarak Proje, Kullanıcı veya Model gibi kategorilere göre düzenlemek için Gruplandırma ölçütü seçeneğini kullanın. Filtreler hangi kullanımın dahil edileceğini, gruplandırma ise nasıl görüntüleneceğini belirler. Eğilimleri incelemek veya kategorileri karşılaştırmak için çizgi ve çubuk grafikleri arasında geçiş yapın.
Mevcut kırılımları incelemek için Kullanım tablosunun sekmelerini kullanın. Tablolar her satır için istekler, girdi ve çıktı token’ları veya özelliğe özgü birimler gibi ilgili ölçümleri gösterir.
API özellikleri bölümünde, bir özelliğin ayrıntılı grafiklerini ve kırılımlarını açmak için o özelliğe ait Görüntüle seçeneğini kullanın. Yanıtlar ve sohbet tamamlamaları bölümünde ayrı Token’lar ve İstekler grafikleri ile Model istekleri metriği bulunur. Bu bölümün kırılım sekmeleri, genel bakışla aynı boyutları kullanır ancak API özellikleri sekmesini içermez. Genel bakışa dönmek için gezinme yolundaki Kullanım bağlantısını kullanın.
Bir Gruplandırma ölçütü seçtikten sonra grafik, ek kategorileri Diğer altında birleştirebilir. Grafik açıklamasında Diğer görünüyorsa içerdiği kategorileri ve bunların kullanım değerlerini görmek için bu etiketi seçin.
Kullanım panosunu aynı raporlama dönemine ait başka bir panoyla yan yana görüntülemek için Panoları karşılaştır seçeneğini kullanın. Görünümleri seçmek için Sol pano ve Sağ pano seçeneklerini kullanın. Seçilen zaman aralığı bu pano çifti için kullanılamıyorsa görünüm Otomatik seçeneğine geçer. Panoya dönmek için Karşılaştırmadan çık seçeneğini kullanın.
Kaynağını belirleyemediğiniz kullanımı araştırın
Kullanım bölümünde uygulama günlüklerinizdeki isteklerle eşleştiremediğiniz etkinlikler görünüyorsa şu kontrolleri yapın:
Kuruluşu, proje kapsamını ve raporlama dönemini doğrulayın. Panodaki zaman damgalarını uygulama günlüklerinizle karşılaştırırken UTC kullanın.
İlgili projenin proje görünümünü kullanın veya Kuruluş analizleri bölümündeki Proje seçeneğinden bu projeyi seçin. Ardından Filtreler ile kullanımı API anahtarına ve modele göre daraltın ve daha kısa bir raporlama dönemi seçin.
Etkinliği aynı döneme, projeye ve API anahtarına ait günlüklerle karşılaştırın. Günlüklerinizin bu anahtarı kullanan tüm uygulama veya entegrasyonları kapsayıp kapsamadığını kontrol edin.
Birden fazla uygulama veya entegrasyon aynı projeyi ya da API anahtarını paylaşıyorsa yalnızca toplam değere bakarak isteği hangisinin gönderdiğini belirleyemeyebilirsiniz. Panoyu, aynı UTC dönemine ait her bir uygulamanın kayıtlarıyla karşılaştırın.
Kullanımın kaynağını hâlâ belirleyemiyorsanız ilgili UTC dönemini, kuruluş ve proje kimliklerini, API anahtarı tanımlayıcısını ve ilgili ekran görüntülerini veya günlükleri ileterek OpenAI Destek ile iletişime geçin. Varsa istek kimliklerini de ekleyin. Gizli API anahtarlarını paylaşmayın.
Kullanım verilerini dışa aktarın
Kullanımı dışa aktarmak için Analizler araç çubuğundaki CSV olarak dışa aktar simgesini, ardından Etkinlik verileri seçeneğini seçin.
API özelliği seçeneğini ve bir veya daha fazla Gruplandırma ölçütü boyutunu seçin.
API kaynağı, Projeler, Kullanıcılar, API anahtarları ve Modeller seçeneklerini gözden geçirin. Projeler ve API kaynağı, Analizler bölümündeki seçimlerinize göre önceden seçilir; diğer dışa aktarma filtrelerini iletişim kutusunda seçin.
Dosya biçimi, Başlangıç zamanı, Bitiş zamanı ve Zaman aralığı seçeneklerini belirleyin, ardından İndir seçeneğini kullanın. Tarihler, UTC’ye göre tam günleri kapsar.
Bir takvim yılı öncesinin UTC 00:00 saatinden bugüne kadar olan etkinlik ve maliyet verileri görüntülenebilir ve dışa aktarılabilir. Daha eski veriler için OpenAI Destek ile iletişime geçin. Günlük veriler, 31 günlük dönemleri kapsayan dosyalar halinde dışa aktarılır.
Aylık fatura mutabakatı ve kalem bazında dışa aktarma için bkz. Aylık kullanım ayrıntılarını dışa aktarma.
Dışa aktarılan etkinlik verilerinde negatif değerli satırlar varsa birimi, gruplandırması ve tarihleri aynı olan satırları karşılaştırın. Faturalandırılan tutarlar için Maliyet verileri seçeneğini kullanın. Negatif değerli bir etkinlik satırı, tek başına faturanıza alacak yansıtıldığını göstermez.
Harcamayı inceleyin
Mevcut projenin maliyetlerini incelemek için Analizler bölümünü açın ve Harcama seçeneğini seçin. Kuruluş genelindeki maliyetler için Kuruluş analizleri, ardından Harcama seçeneğini seçin.
Maliyetleri kullanımla karşılaştırmadan önce mevcut tarih aralığını ve filtreleri kontrol edin. Kullanım ve Harcama farklı filtreler sunar; bir panoda bulunan filtre diğerinde uygulanamayabilir.
Harcamayı daraltmak için API kaynakları, API anahtarları, Modeller ve Kalemler filtrelerini kullanın. Kuruluş analizlerinde, incelemek istediğiniz projeleri dahil etmek için Proje seçeneğini kullanın. Mevcut kırılımlar için tablodaki Kalemler, API anahtarları, Kullanıcılar, Projeler ve Modeller sekmelerini kullanın.
Harcama limiti değerinin görüntülenememesi, limitinizin sıfır olduğu veya yeni bir limit uygulandığı anlamına gelmez. Erişim izinleri, limitin belirlenmemiş olması veya başarısız bir istek, panoda bir değer gösterilmesini engelleyebilir.
Hizmet durumunu inceleyin
Kuruluşunuzun Hizmet durumu panosuna erişimi varsa API performansını incelemek için Analizler bölümünde bu panoyu açın. Erişim koşulları ve metrik tanımları için bkz. API hatalarını ve gecikme sorunlarını giderme.
Tanımlanan kredileri görüntüleyin
Tanımlanan kredilerin ayrıntılarını kuruluşunuzun Faturalandırma sayfasında bulabilirsiniz.
Tanımlanan krediler ve API kullanımı farklı bilgiler sunar: İlki kuruluşunuzla ilişkili kredileri, ikincisi 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 kapsamında size ayrılan kapasiteye dahil olup olmadığını kontrol edin. Bu modelin tüm kullanımı, Ölçek Kademesi kapsamında ayrılan TPM kapasitesi içindeyse projede ek model harcaması olmadan kullanım görünebilir.
Ölçek Kademesi abonelik maliyeti kuruluş düzeyinde kalır. Tek bir projenin harcamasını temel almak yerine kuruluş genelindeki harcamayı inceleyin.
Birden fazla kuruluşu inceleyin
Kullanım Panosu, farklı kuruluşların maliyet veya kullanım verilerini birleştirmez. Alt kuruluşlar dahil her kuruluş ayrı değerlendirilir.
Bir alt kuruluşu görüntülemek için kuruluş seçiciden o kuruluşu seçin.
Birleştirilmiş raporlamaya ihtiyacınız varsa ayrı alt kuruluşlar yerine tek bir kuruluş içinde projeler kullanmayı değerlendirin veya özel analizler için Usage API kullanın.
Bir API yanıtındaki token kullanımını kontrol edin
Token kullanımı alanlarının adları uç noktaya göre değişir.
| Token sayısı | Chat Completions | Responses |
|---|---|---|
| Girdi token’ları | usage.prompt_tokens | usage.input_tokens |
| Çıktı token’ları | usage.completion_tokens | usage.output_tokens |
| Toplam token sayısı | usage.total_tokens | usage.total_tokens |
Chat Completions yanıtları token kullanım bilgilerini içerebilir. Örnekler:
{
"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 token sayılarını da içerebilir. Bu bilgiler, bir yanıtın görünür uzunluğunun neden toplam token kullanımını yansıtmadığını açıklamaya yardımcı olur.
Farklı token kategorilerinin açıklaması için bkz. Token'ları anlama ve sayma.
Token kullanımını bildiren bir transkripsiyon yanıtında ses ve metin girdisi token'ları zaten input_tokens değerine dahildir. Bu bileşenleri girdi toplamına tekrar eklemeyin. output_tokens değerini ayrı olarak karşılaştırın.
Akış hâlindeki Chat Completions yanıtlarından kullanım bilgilerini alın
Akış kullanan bir Chat Completions isteğine şunları ekleyin:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}include_usage etkinleştirildiğinde, data: [DONE] öncesinde gelen 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çaların usage değeri null olur.
Akış kesilirse kullanım bilgilerini içeren bu son parçayı alamayabilirsiniz. Son parçanın gelmemesi, isteğin hiç token kullanmadığı anlamına gelmez.
Bu yapılandırma Chat Completions'a özgüdür. Ayrıntılar için Chat Completions API referansına bakın.