Anthropic Admin API ile kullanım raporu almanın tam rehberi

Şirketinizin AI faturası her ay geliyor ama tek bir toplam rakam olarak geliyor. Kimin ne kadar kullandığını, hangi ekibin hangi modeli çalıştırdığını, harcamanın hangi gün patladığını konsoldaki özet grafikten çıkaramazsınız. Bunun için Anthropic'in organizasyon uçlarını, yani Admin API'yi kullanmanız gerekir.

Bu rehber geliştirici olmayan bir okuyucu için yazıldı. Terminale iki komut yapıştırabiliyorsanız yeterli. Amacımız size kod öğretmek değil, elinizde denetlenebilir bir tablo olmasını sağlamak.

Admin anahtarı nereden alınır

En sık yapılan hata burada başlıyor: insanlar claude.ai'a girip anahtar arıyor. Orada yok. Admin anahtarı console.anthropic.com üzerinden alınır.

Yol şu: console.anthropic.com → Settings → Admin keys → Create key. Anahtar sk-ant-admin ile başlar ve yalnızca bir kez gösterilir. Kopyalayıp bir parola kasasına koymadan o ekranı kapatmayın, aksi halde yeni anahtar üretmeniz gerekir.

Elinizdeki normal API anahtarı, yani sk-ant-api ile başlayan anahtar, bu işi görmez. Organizasyon uçlarına o anahtarla istek attığınızda yetki hatası alırsınız. İkisi farklı kapılar: biri model çağırmak için, diğeri organizasyonu yönetmek için.

İki uç nokta, iki farklı soru

Karıştırılmaması gereken iki adres var.

GET /v1/organizations/usage_report/messages size hacim verir: hangi anahtar, hangi model, ne kadar iş yaptı. Kullanım deseni sorularının cevabı buradadır.

GET /v1/organizations/cost_report size para verir: hangi kalem ne tuttu. Fatura mutabakatının cevabı buradadır.

İkisi aynı soruya farklı açılardan bakar ve önemli bir noktada ayrışırlar: kullanım raporu saatlik kırılım verebilirken, maliyet raporu yalnızca günlük çalışır. Bu ayrımın denetim açısından sonuçlarına birazdan geleceğiz.

Her iki istekte de iki başlık zorunludur: kimlik için x-api-key, sürüm için anthropic-version: 2023-06-01.

İlk çağrı

Önce anahtarı ortam değişkenine koyun ki komut geçmişinizde açıkta kalmasın.

export ANTHROPIC_ADMIN_KEY="sk-ant-admin-..."

Sonra son bir haftanın kullanımını, API anahtarı ve model kırılımıyla isteyin:

curl -s "https://api.anthropic.com/v1/organizations/usage_report/messages?starting_at=2026-07-14T00:00:00Z&bucket_width=1d&group_by[]=api_key_id&group_by[]=model" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

URL'yi tırnak içine almayı unutmayın. group_by[] ifadesindeki köşeli parantezler tırnaksız bırakılırsa kabuk bunları dosya adı kalıbı sanır ve istek bozulur. Bu, ilk denemede en çok vakit kaybettiren ayrıntıdır.

Maliyet tarafı için:

curl -s "https://api.anthropic.com/v1/organizations/cost_report?starting_at=2026-07-01T00:00:00Z&bucket_width=1d&group_by[]=description" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Maliyet raporunda tutarlar en küçük para biriminde, ondalıklı metin olarak döner. Yani gelen değeri doğrudan "dolar" diye tabloya yazarsanız yüz katı yanlış bir rapor üretirsiniz. Muhasebeye göndermeden önce birimi bir kez doğrulayın.

bucket_width sınırları: bu rehberin en kritik tablosu

bucket_width verinin hangi çözünürlükte toplanacağını belirler ve her seçeneğin sert bir üst sınırı vardır.

Tablodaki en önemli satır ortadaki. Saatlik kırılım en fazla yedi gün geriye gidebilir.

Pratik sonuç: denetimi tek seferlik bir proje gibi değil, haftalık tekrarlayan bir iş gibi kurun. Yedi günden eski saat bilgisi geri gelmiyor.

group_by ile kırılım almak

Kullanım raporunda gruplayabileceğiniz alanlar şunlar: account_id, api_key_id, context_window, inference_geo, model, service_account_id, service_tier, workspace_id.

Yönetici gözüyle en çok işe yarayan üçü:

• api_key_id — Kişi başına ayrı anahtar dağıttıysanız bu, fiilen kişi kırılımıdır. Dağıtmadıysanız tek satır görürsünüz ve denetim burada biter. Bu tuzağı paylaşımlı tek hesap sorunu yazısında ayrıntılı anlattık.
• workspace_id — Ekip veya departman kırılımı. Bütçeyi bölmenin en kolay yolu.
• model — Pahalı modelin ucuz işlerde kullanılıp kullanılmadığını gösterir. Maliyet çalışmasının başlangıç noktasıdır.

Maliyet raporunda gruplama seçenekleri daha dardır: yalnızca description veya workspace_id. Yani "hangi kişi ne kadar harcadı" sorusunu doğrudan maliyet raporundan alamazsınız; kullanım kırılımıyla eşleştirerek tahmin edersiniz.

API'nin cevaplayamadığı üç soru

Beklentiyi baştan doğru kurmak, sonradan hayal kırıklığı yaşamaktan iyidir.

İçerik yok

Kullanım raporu token sayar, metin göstermez. Yani "birisi prompt içine müşteri veritabanı parolası yapıştırdı mı" sorusunun cevabı bu API'de yoktur. Bunun için sohbet içeriğine, yani export dosyasına bakmanız gerekir. Adımları claude.ai export dosyasıyla denetim yazısında bulabilirsiniz.

Koltuk kullanımı ile API kullanımı aynı şey değil

Ekibiniz çoğunlukla claude.ai arayüzünü kullanıyorsa organizasyon uçlarındaki API rakamları sizin gerçek kullanımınızı temsil etmez. Bu iki kanalı ayrı ayrı ölçmek zorundasınız.

Kişi kırılımı ancak kimlik ayrıksa

Rapor size anahtar ve hesap kimliği verir, isim vermez. Kimlik eşleşmesini kendi tarafınızda tutmuyorsanız elinizde anlamsız kimlik dizileri kalır. Denetime başlamadan önce basit bir eşleme tablosu hazırlayın.

Haftalık pratik akış

1. Pazartesi sabahı 1h kovalarıyla son 7 günü çekin, mesai dışı hacmi kaydedin.
2. Aynı istekte group_by[]=api_key_id ve group_by[]=model ekleyin.
3. Ayda bir 1d kovalarıyla 31 günü çekip maliyet raporuyla karşılaştırın.
4. Sapan anahtarları not edin; sapma iki hafta üst üste tekrar ediyorsa konuşun.
5. Anahtar sahibi ile kişi eşleşmesini her ay tazeleyin, ayrılan çalışanların anahtarlarını kapatın.

Bu akış haftada on beş dakika sürer ve şirketin AI harcamasını "belirsiz kalem" olmaktan çıkarır. Kurumsal Enterprise planındaysanız Anthropic'in Mayıs 2026'da duyurduğu Compliance API ile CrowdStrike, Microsoft Purview, Okta, Wiz ve Zscaler entegrasyonlarını da değerlendirebilirsiniz; OpenAI tarafında ChatGPT Enterprise ve Edu için benzer bir Compliance API mevcut.