AI API Maliyet Takipçisi: Başlıklarla Harcamayı İzleyin
Her yanıt kalan bakiyenizi gösterdiği için yaklaşık elli satırda bir AI API maliyet takipçisi oluşturabilirsiniz. Bu kılavuz, harcamayı istek başına nasıl loglayacağınızı, bakiye uç noktalarını nasıl okuyacağınızı ve kredi bitmeden önce nasıl uyarı vereceğinizi gösterir.


Temel noktalar
- Her yanıt, kalan kredinizi gösteren bir X-Balance-USD başlığı taşır.
- GET /v1/balance ve credit_grants uç noktaları, talep üzerine bakiyeyi döndürür.
- Çağrı başına maliyet (girdi x 0.15 + çıktı x 0.50) / 1.000.000 dolardır.
- CSV'ye log yazın ve bakiye bir eşiğin altına düştüğünde uyarı verin.
Sayılar nereden geliyor
Ön ödemeli kredi, sağlayıcının zaten kümülatif toplamı tuttuğu için maliyet takibini basitleştirir. Bunu üç yerde alırsınız:
- API çağrılarında istek sonrası kalanı gösteren
X-Balance-USDyanıt başlığı GET /v1/balance, basit bir bakiye sorgulama.GET /v1/dashboard/billing/credit_grants, dashboardlar ve sarmalayıcılar gibi araçların zaten nasıl çağrılacağını bildiği OpenAI tarzı yol.
Bunların yanı sıra, her tamamlama bir usage nesnesi döndürür; istem ve tamamlama token sayılarını içerir. Tokenleri fiyatlarla ($0,15 girdi başına 1M, $0,50 çıktı başına 1M) birleştirerek herhangi bir isteğin maliyetini kendiniz hesaplayabilir ve bunu bakiyedeki düşüşle karşılaştırabilirsiniz. İki değer uyuşmalıdır. Uyuşmazlarsa, araştırmanız gereken bir durum bulmuş olursunuz. Tüm parametre detayları dokümantasyonda yer alır.
Bir istekte başlığı okuyun
curl ile -i ekleyin ve başlıklara bakın:
curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
| grep -i "x-balance-usd"
Python'da OpenAI SDK, ham yanıtları with_raw_response üzerinden açığa çıkarır; bu size başlıkları ve ayrıştırılmış nesneyi birlikte verir:
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
raw = client.chat.completions.with_raw_response.create(
model="uncensored",
messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)Her çağrıyı kaydeden küçük bir loglayıcı
Çağrılarınızı bir fonksiyonun içine alın ve her seferinde bir CSV satırı yazın. Satır; zamanı, istek kimliğini, token sayılarını, hesaplanan maliyeti ve bakiyeyi içerir.
import csv, time
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50 # dollars per 1M tokens
LOG = "api_spend.csv"
def cost(usage):
return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000
def tracked_chat(messages, tag="default"):
raw = client.chat.completions.with_raw_response.create(
model="uncensored", messages=messages)
r = raw.parse()
row = [
time.strftime("%Y-%m-%d %H:%M:%S"),
raw.headers.get("x-request-id"),
tag,
r.usage.prompt_tokens,
r.usage.completion_tokens,
round(cost(r.usage), 6),
raw.headers.get("x-balance-usd"),
]
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow(row)
return r, row
tag bağımsız değişkeni, günlüğün işe yarar olmasını sağlayan püf noktasıdır. "özetler" veya "sohbet" gibi bir özellik adı iletin; daha sonra ürünün hangi kısmının para harcadığını görmek için etikete göre maliyeti toplayabilirsiniz. Tam çağrıyı tanımladığı için, bir ücret hakkında sorunuz gelmesi veya bir sorun bildirmeniz gerektiğinde istek kimliği yardımcı olur.
Matematiği kontrol edin
2.400 girdi tokeni ve 600 çıktı tokeni olan bir çağrıyı ele alalım:
- Girdi: 2.400 x 0,15 / 1.000.000 = $0,00036
- Çıktı: 600 x 0,50 / 1.000.000 = $0,00030
- Toplam: $0,00066
Bunlardan bin tanesi $0,66 eder. CSV'niz hesaplanan maliyetlerin toplamından çok daha hızlı düşüyorsa, loglamadığınız yeniden denemeleri, aynı anahtarı kullanan arka plan işlerini veya açık bıraktığınız akışları kontrol edin. Başarısız veya reddedilen istekler ücretlendirilmez, bu nedenle hatalar bakiyeyi hiç değiştirmemelidir. Küçük yuvarlama farklarının ortalama etkisini görmek için tek tek değil, çoklu çağrılar üzerinden toplamları karşılaştırın.
Akış çağrıları ve kullanım
stream: true ile kullanım sayıları akışın sonunda gelir. Son parçadan toplayın ve akış kapandıktan sonra satırı loglayın.
def tracked_stream(messages, tag="chat"):
usage = None
for chunk in client.chat.completions.create(
model="uncensored", messages=messages, stream=True):
if chunk.choices and chunk.choices[0].delta.content:
yield chunk.choices[0].delta.content
usage = getattr(chunk, "usage", None) or usage
if usage:
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])
Sadece bakiyeye ihtiyacınız varsa, akış bittikten sonra GET /v1/balance çağrısı yapın. Bu ucuz bir istektir ve bir cron işi tarafından periyodik bir kontrol olarak da çalışır.
Özelliklere göre harcama toplama
CSV, okunduğu sürece kullanışlıdır. Bu kısa betik, ekstra paket kullanmadan maliyeti etikete göre toplar ve en güncel bakiyeyi gösterir.
import csv
from collections import defaultdict
totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
for row in csv.reader(f):
ts, req_id, tag, pin, pout, cost_usd, balance = row
totals[tag] += float(cost_usd)
last_balance = balance or last_balance
for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)
Bunu günlük olarak çalıştırın ve çıktıyı ekip kanalınıza yapıştırın. Görünmez kalan harcama, insanların tartışabileceği bir sayıya dönüşür ve diğerlerinden on kat pahalı olan bir özellik hemen dikkat çeker. Kabaca bir bütçe için günlük toplamı 30 ile çarpın ve %20 tampon ekleyin.
Düşük bakiye uyarısı ekleyin
Günün ortasında kredinin bitmesi bir ürünü çevrimdışı bırakır, bu yüzden erken uyarı verin. Her 15 dakikada bir çalışan bir cron işi yeterlidir.
import requests
BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00 # dollars
r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text) # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.
Ham JSON'u bir kez yazdırın ve ayrıştırma kodunu yazmadan önce inceleyin. Gerçek alan adı kontrol etmek on saniye sürer; bir makaleden tahmin etmek uyarıyı sessizce bozabilir. Normal harcamanızı en az bir gün karşılayacak bir eşik seçin; CSV bunu size söyler: dün maliyetini toplayın ve bunu minimum olarak kullanın.
Uyarı tetiklendiğinde bakiye yükleyin. $20 ile $500 arası herhangi bir tam miktar çalışır; $50'den +%5, $100'den +%10 ve $200'den +%15 kredi eklenir ve kredi süresi dolmaz. Takipçi için bir anahtar almak için API anahtarı sayfasını kullanın.
Harcamayı öngörülebilir kılan alışkanlıklar
- Test trafiğinin üretim sayılarında hiç gizlenmemesi için ortam başına bir anahtar kullanın.
- Uzun yanıtların gerekmediği uç noktalarda
max_tokensdeğerini sınırlayın. Varsayılan olarak isteğe bağlıdır, bu nedenle sınırsız yanıtlar mümkündür. - Sohbet geçmişini kısaltın. Girdi tokenleri çıktıdan daha ucuzdur, ancak uzun bir geçmiş her adımda tekrarlandığında birikim yapar.
- Etiketlere göre haftalık toplamı gözden geçirin ve faturanın yarısından fazlasını oluşturan tek etiketi arayın.
Bir alışkanlık daha: Her log satırıyla birlikte istek kimliğini saklayın. Bir ay sonra bir sayı yanlış görünürse, ortalamalardan tartışmak yerine bunu belirli bir çağrıyla eşleştirebilirsiniz. Başarısız istekler faturalandırılmadığı için, hatalarda yapılan yeniden denemeler maliyet eklemez, ancak başarılı bir yanıt sonrası yapılanlar ekler; bu nedenle yeniden deneme mantığınızın yalnızca gerçek hatalarda tetiklendiğinden emin olun. Başarılı bir isteği döngü içinde yeniden gönderen bir hata, herhangi bir token başına ücret alan API'de şaşırtıcı bir faturanın en yaygın nedenidir.
Daha fazla kılavuz
Sorular ve cevaplar
Bakiye başlığı her yanıtta görünür mü?
X-Balance-USD başlığı, bu API için listelenen yanıt başlıklarının bir parçasıdır. Ham yanıtı okuyun ve eksik değeri bilinmeyen olarak değerlendirin.
Her isteği loglamadan maliyeti nasıl alabilirim?
Evet. GET /v1/balance uç noktasını bir zaman çizelgesi ile sorgulayın ve okumalar arasındaki farkı hesaplayın.
Başarısız istekler bakiyeyi değiştirir mi?
Hayır. Başarısız veya reddedilen istekler için ücret alınmaz.
Mevcut bir OpenAI paneli aracının hangi uç noktası kullanması gerekir?
Çoğu araç zaten destekleyen OpenAI tarzı GET /v1/dashboard/billing/credit_grants rotasını kullanın.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.