Kullanım Ölçer

TsgcAIUsageMeter, uygulamanızın bir dil modeline gönderdiği her isteğin belirteçlerini sayar ve paraya çevirir. Onu TsgcAIChat.UsageMeter özelliğine atayın, bir fiyat listesi ve bir bütçe verin; bütçeye ulaşan kullanıcı, bir sonraki istek gönderilmeden önce reddedilir.

TsgcAIUsageMeter

Sağlayıcı ve model başına fiyatlar, kullanıcı ve oturum başına güncel toplamlar, bir isteği engelleyebilen toplam, günlük veya aylık bütçeler ve CSV'ye, herhangi bir TDataSet'e ve bir OpenTelemetry toplayıcısına dışa aktarım.

Bileşen sınıfı

TsgcAIUsageMeter

Amaç

Belirteç maliyetleri, bütçeler ve kullanım dışa aktarımı

Platformlar

Windows, macOS, Linux, iOS ve Android

Sürümler. TsgcAIUsageMeter sgcAI, sgcWebSockets Enterprise ve All-Access sürümlerinde bulunur, yani TsgcAIChat ile aynı sürümlerde. 2026.11.0 sürümünde yeni. sgcAI kendi başına yeterlidir: bileşenin üzerine kurulduğu sgcWebSockets Core çalışma zamanını da içerir. Delphi 7 ile Delphi 13 ve C++ Builder için kullanılabilir.

Her isteğin maliyetini hesaplayın, her kullanıcıyı sınırlayın

Bir fiyat ekleyin, bir bütçe ekleyin, ölçeri sohbete atayın. Sohbetin ve onu kullanan bir ajanın her isteği sayılır.

uses
  sgcAI, sgcAI_Chat, sgcAI_UsageMeter;

procedure TForm1.MeterUsage;
var
  oPrice: TsgcAIUsagePrice;
  oBudget: TsgcAIUsageBudget;
begin
  oPrice := sgcAIUsageMeter1.Prices.Add; // or Prices.LoadFromFile('prices.json')
  oPrice.Provider := 'openai';
  oPrice.Model := 'gpt-5*';
  oPrice.InputPerMillion := 1.25;
  oPrice.OutputPerMillion := 10;
  oPrice.CachedPerMillion := 0.125;

  oBudget := sgcAIUsageMeter1.Budgets.Add; // every user can spend 2 USD a day
  oBudget.Scope := aubsUser;
  oBudget.Period := aubpDay;
  oBudget.MaxCost := 2;
  sgcAIUsageMeter1.OnBudgetExceeded := DoBudgetExceeded;

  // optional: one OpenTelemetry span per request
  sgcAIUsageMeter1.OpenTelemetry.Enabled := True;
  sgcAIUsageMeter1.OpenTelemetry.Endpoint := 'http://localhost:4318';

  sgcAIChat1.UserId := 'user-1';
  sgcAIChat1.UsageMeter := sgcAIUsageMeter1;
  Memo1.Lines.Add(sgcAIChat1.Chat('Hello'));

  Memo1.Lines.Add(Format('user-1 spent %.6f %s and %d tokens',
    [sgcAIUsageMeter1.TotalCost('user-1'), sgcAIUsageMeter1.Currency,
    sgcAIUsageMeter1.TotalTokens('user-1')]));
  sgcAIUsageMeter1.SaveToCSV('usage.csv');
end;

procedure TForm1.DoBudgetExceeded(Sender: TObject;
  const aBudget: TsgcAIUsageBudget; const aKey: string; aCost: Double;
  aTokens: Int64);
begin
  Memo1.Lines.Add(Format('Budget "%s" reached by %s: %.4f USD',
    [aBudget.DisplayName, aKey, aCost]));
end;

Temel özellikler & yöntemler

En sık başvuracağınız üyeler.

Fiyatlar

Prices, her sağlayıcı ve modelin milyon girdi, çıktı ve önbellek belirteci başına fiyatını tutar. gpt-5* gibi model kalıplarına izin verilir ve en belirgin eşleşme kazanır. Prices.LoadFromFile ve LoadFromJSON bir fiyat listesi yükler. Önbellekteki belirteçler CachedPerMillion ile faturalanır.

Toplamlar

TotalCost ve TotalTokens, her şeyin, bir kullanıcının, bir oturumun veya bir oturumdaki bir kullanıcının toplamlarını döndürür. Records ve RecordCount toplamları değiştirmeden son MaxRecords isteği listeler, Clear her şeyi sıfırlar.

Bütçeler

Budgets öğelerinin her birinde bir Scope (aubsGlobal, aubsUser veya aubsSession), isteğe bağlı bir Key, bir Period (aubpTotal, aubpDay veya aubpMonth) ve bir MaxCost ya da MaxTokens sınırı bulunur. BlockWhenExceeded ile bir sonraki istek gönderilmeden önce reddedilir.

Dışa aktarım

SaveToCSV ve ToCSV, her istek için zaman damgası, sağlayıcı, model, kullanıcı, oturum, belirteçler ve maliyet içeren bir satır yazar. ExportToDataSet, kayıtları alan adları eşleşen herhangi bir TDataSet bileşenine ekler.

OpenTelemetry

OpenTelemetry.Enabled ile her istek, GenAI semantik kurallarına uygun bir OTLP/HTTP span'ine dönüşür: sağlayıcı, model, girdi, çıktı ve önbellek belirteçleri, kullanıcı ve oturum. Bir arka plan iş parçacığı onu gönderir, böylece sohbet toplayıcıyı asla beklemez.

Olaylar

OnRecord, maliyeti hesaplanan her istekte tetiklenir. OnBudgetExceeded, sınıra ulaşıldığında bütçe, anahtar ve dönem başına bir kez tetiklenir. Fallback sağlayıcısı tarafından yanıtlanan isteklerin maliyeti, yanıtlayan sağlayıcı ve modelle hesaplanır.

Spesifikasyonlar & referanslar

Bu bileşenin kullandığı hizmet ve protokoller için yetkili kaynaklar.

Keşfetmeye devam edin

Çevrimiçi yardımsgcAI bileşenleri için tam API referansı ve kullanım kılavuzu.
Tüm sgcAI BileşenleriHer sgcAI bileşeninin özellik matrisine göz atın.
Ücretsiz Deneme Sürümünü İndirinKendi API anahtarlarınızla deneyin.
FiyatlandırmaSingle, Team ve Site lisansları, tam kaynak kodu.
En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

Başlamaya Hazır mısınız?

Ücretsiz deneme sürümünü indirin ve yapay zeka özelliklerinizin her kullanıcı için ne kadara mal olduğunu öğrenin.