İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

API Kullanımını Dışa Aktarma

Maliyet analizi, izleme ve fatura mutabakatı için ayrıntılı API anahtarı kullanım verilerini CSV formatına aktarın.

API kullanımı dışa aktarımları, çalışma alanı yöneticilerinin kullanımına açıktır ve seçtiğiniz dönem boyunca her bir API anahtarı için ayrıntılı maliyet dökümleri sağlar. Dışa aktarmalar, çalışma alanını ve kişisel API anahtarlarını kapsar ve kişisel API anahtarı kullanımı, faturanızdaki API satır öğesi yerine Extra Usage olarak faturalandırılır.

  • Open API Settings — API anahtarlarınız için analizleri görüntüleyin ve kullanım verilerini dışa aktarın.

API Kullanım Dışa Aktarımına Erişim

API anahtarlarınıza ilişkin analizleri görüntülemek ve ayrıntılı kullanım verilerini dışa aktarmak için API ayarları sayfanıza gidin.

API Ayarlarını Aç

Çalışma alanı ayarlarınızda Ayarlar > API'ye gidin

Analitikleri Görüntüle

Sayfada görüntülenen API anahtarı analizlerini inceleyin

Zaman Dilimi Seçin

Zaman dilimi seçiciden istediğiniz zaman dilimini seçin (varsayılan: son 30 gün)

CSV'ye aktar

Ayrıntılı API kullanım verilerini içeren bir CSV dosyası indirmek için Dışa Aktar düğmesini tıklayın

Zaman Aralığı Seçimi

Dışa aktarma, seçilen zaman dilimi içinde yapılan tüm API çağrılarını içerir:

  • Varsayılan dönem: Son 30 gün
  • Özel aralıklar: Zaman aralığı seçiciyi kullanarak herhangi bir zaman aralığını seçin
  • Veriler, her API çağrısının tarihine/zaman damgasına göre filtrelenir

Aynı zaman dilimi seçimi hem analiz görselleştirmesi hem de CSV dışa aktarımı için geçerlidir.

Toplu API Anahtarı Kullanımını Dışa Aktarma

API ayarları sayfasından yapılan dışa aktarma, arama başına ayrıntılı bir CSV dışa aktarımıdır. Bireysel API isteklerini uzlaştırmanız, model fiyatlarını incelemeniz veya gecikmeyi analiz etmeniz gerektiğinde bunu kullanın.

Bunun yerine özetlenmiş bir rapora ihtiyacınız varsa, çalışma alanı analitiğini dışa aktarma iletişim kutusundan API anahtarlarını dışa aktarın veya Kullanım Dışa Aktarma API'sindeki API key usage export öğesini kullanın. Seçilen dönem için API anahtarı başına bir satır döndürür ve ayrıca modele göre alt gruplandırılabilir.

Veri Yapısını Dışa Aktarma

CSV dışa aktarımı, ayrıntılı maliyet ve performans bilgilerini içeren API çağrısı başına bir satır içerir.

Sütun Tanımları

SütunAçıklama
TarihAPI çağrısının tarihi ve zaman damgası (UTC)
API Anahtar KimliğiKullanılan API anahtarının benzersiz tanımlayıcısı
API Anahtar AdıAPI anahtarının insanlar tarafından okunabilen adı
Sağlayıcıİstek için kullanılan yapay zeka sağlayıcısı
ModeliÖzel model adı
Giriş Jetonlarıİstek istemindeki jeton sayısı
Çıkış JetonlarıModelin yanıtındaki belirteç sayısı
Tamamlanma Süresi (ms)İsteğin milisaniye cinsinden tamamlanması için geçen süre
Girdi Token Fiyatı (USD/1 milyon token)1 milyon giriş jetonu başına maliyet
Çıktı Token Fiyatı (USD/1 milyon token)1 milyon çıkış jetonu başına maliyet
Brüt Maliyet (USD)API çağrısının müşteriye yönelik ABD Doları cinsinden maliyeti
Fatura Tutarı (EUR)API çağrısı için EUR cinsinden faturalandırılan tutar

Dışa aktarma, API çağrılarının tamamlanmasını ve yerleştirilmesini içerir. Çağrıları katıştırmak için Çıkış Belirteçleri sütunu boş olacaktır.

Maliyetleri Hesaplamak

Belirteç nedir? Belirteç, modelin işlediği bir metin parçasıdır (kabaca bir kelime veya kelime parçası). Ortalama olarak 1 jeton yaklaşık 4 karaktere eşittir. API çağrısı fiyatlandırması, işlenen jeton sayısına göre belirlenir.

Bireysel bir API çağrısının maliyetini hesaplamak için aşağıdaki formülü kullanın:

Total Cost = (input_tokens × input_token_price_per_1m / 1,000,000) +
             (output_tokens × output_token_price_per_1m / 1,000,000)

Örnek Hesaplama

Aşağıdakileri içeren bir API çağrısı için:

  • 500 giriş jetonu
  • 1.200 çıkış jetonu
  • Giriş fiyatı: 1 milyon token başına \$2,50
  • Çıkış fiyatı: 1 milyon token başına \$10,00
Input Cost  = 500 × $2.50 / 1,000,000 = $0.00125
Output Cost = 1,200 × $10.00 / 1,000,000 = $0.01200
Total Cost  = $0.01325

Bir API anahtarının toplam maliyetini hesaplamak için e-tablo uygulamanızda söz konusu anahtarın tüm satırlarındaki bireysel maliyetleri toplayın.

Kullanım Durumları

Maliyet Takibi

Yüksek kullanımlı anahtarları belirlemek ve maliyetleri optimize etmek için farklı API anahtarlarındaki harcamaları izleyin.

Faturalandırma Mutabakatı

Çalışma alanı API anahtarı kullanımını faturanızdaki API satır öğesiyle uyumlu hale getirin ve AI sağlayıcılarından alınan ücretleri doğrulayın.

Performans Analizi

Yanıt sürelerini optimize etmek için farklı modeller ve sağlayıcılar genelinde tamamlanma sürelerini analiz edin.

Kullanım Kalıpları

Kapasite planlamasına bilgi sağlamak için yoğun kullanım sürelerini ve model tercihlerini belirleyin.

Dışa Aktarma Sınırları

API kullanım aktarımları 1.000.000 satırla sınırlıdır. Dışa aktarma işlemi bu sınırı aşarsa tarih aralığınızı daraltın.

Veri Gizliliği

  • Yönetici görünürlüğü için API anahtar kimlikleri ve adları eklenmiştir
  • API kullanımı dışa aktarımlarına son kullanıcının kişisel bilgileri dahil edilmez
  • Veriler, çalışma alanınız aracılığıyla yapılan gerçek API çağrılarını yansıtır