Usage and Cost API

Usage & Cost Admin API menyediakan akses terprogram dan terperinci ke data historis penggunaan dan biaya API untuk organisasi Anda. Data ini serupa dengan informasi yang tersedia di halaman Usage dan Cost di Claude Console.

API ini memungkinkan Anda untuk memantau, menganalisis, dan mengoptimalkan implementasi Claude Anda dengan lebih baik:

• Pelacakan penggunaan yang akurat: Dapatkan jumlah token dan pola penggunaan yang tepat alih-alih hanya mengandalkan penghitungan token respons
• Rekonsiliasi biaya: Cocokkan catatan internal dengan penagihan Anthropic untuk tim keuangan dan akuntansi
• Kinerja dan peningkatan produk: Pantau kinerja produk sambil mengukur apakah perubahan pada sistem telah meningkatkannya, atau siapkan peringatan
• Optimalisasi batas laju: Optimalkan fitur seperti caching prompt atau prompt tertentu untuk memaksimalkan kapasitas yang dialokasikan untuk Anda.
• Analisis lanjutan: Lakukan analisis data yang lebih mendalam daripada yang tersedia di Console

Organisasi Claude Enterprise menggunakan kunci Analytics API dengan API yang berbeda; lihat API mana yang Anda butuhkan?.



API mana yang Anda butuhkan?

Anthropic menyediakan pelaporan biaya dan penggunaan melalui dua API, tergantung pada produk Claude mana yang dikelola organisasi Anda:

Organisasi induk Claude Enterprise tidak muncul di Claude Console dan tidak memiliki kunci Admin API, sehingga bagi mereka kunci Analytics API adalah satu-satunya jalur ke data ini. Lihat Analytics APIs untuk cara membuat setiap jenis kunci dan paket mana yang berlaku untuk data biaya Claude Enterprise.



Solusi mitra

Platform observabilitas terkemuka menawarkan integrasi siap pakai untuk memantau penggunaan dan biaya Claude API Anda, tanpa menulis kode khusus. Integrasi ini menyediakan dasbor, peringatan, dan analitik untuk membantu Anda mengelola penggunaan API secara efektif.



Mulai cepat

Dapatkan penggunaan harian organisasi Anda selama 7 hari terakhir:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-08T00:00:00Z&\
ending_at=2025-01-15T00:00:00Z&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

User-Agent: YourApp/1.0.0 (https://yourapp.com)



Usage API

Lacak konsumsi token di seluruh organisasi Anda dengan rincian terperinci berdasarkan model, workspace, dan tingkat layanan dengan endpoint /v1/organizations/usage_report/messages.



Konsep utama

• Time buckets: Agregasi data penggunaan dalam interval tetap (1m, 1h, atau 1d)
• Pelacakan token: Ukur token input yang tidak di-cache, input yang di-cache, pembuatan cache, dan token output
• Pemfilteran & pengelompokan: Filter berdasarkan kunci API, workspace, model, tingkat layanan, jendela konteks, residensi data, atau kecepatan (beta), dan kelompokkan hasil berdasarkan dimensi-dimensi ini
• Penggunaan alat server: Lacak penggunaan alat sisi server seperti pencarian web

Untuk detail parameter lengkap dan skema respons, lihat referensi Usage API.



Contoh dasar



Penggunaan harian berdasarkan model

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



Penggunaan per jam dengan pemfilteran

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-15T00:00:00Z&\
ending_at=2025-01-15T23:59:59Z&\
models[]=claude-opus-5&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



Filter penggunaan berdasarkan kunci API dan workspace

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\
api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



Residensi data

Lacak kontrol residensi data Anda dengan mengelompokkan dan memfilter penggunaan menggunakan dimensi inference_geo. Ini berguna untuk memverifikasi perutean geografis di seluruh organisasi Anda.

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

Anda juga dapat memfilter ke geo tertentu. Nilai yang valid adalah global, us, dan not_available:

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



Mode cepat (pratinjau riset)

Lacak penggunaan mode cepat dengan mengelompokkan dan memfilter menggunakan dimensi speed. Ini berguna untuk memantau penggunaan mode standar versus mode cepat.

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=speed&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Anda juga dapat memfilter ke kecepatan tertentu. Nilai yang valid adalah standard dan fast:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
speeds[]=fast&\
group_by[]=model&\
bucket_width=1d" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



Batas granularitas waktu



Cost API

Ambil rincian biaya tingkat layanan dalam USD dengan endpoint /v1/organizations/cost_report.



Konsep utama

• Mata uang: Semua biaya dalam USD, dilaporkan sebagai string desimal dalam satuan terkecil (sen)
• Jenis biaya: Lacak biaya penggunaan token, pencarian web, dan eksekusi kode
• Pengelompokan: Kelompokkan biaya berdasarkan workspace atau deskripsi untuk rincian terperinci. Saat mengelompokkan berdasarkan description, respons menyertakan bidang yang telah diurai seperti model dan inference_geo
• Time buckets: Hanya granularitas harian (1d)

Untuk detail parameter lengkap dan skema respons, lihat referensi Cost API.



Contoh dasar

curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
group_by[]=workspace_id&\
group_by[]=description" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



Paginasi

Kedua endpoint mendukung paginasi untuk dataset besar:

1. Buat permintaan awal Anda.
2. Jika has_more bernilai true, gunakan nilai next_page dalam permintaan berikutnya.
3. Lanjutkan hingga has_more bernilai false.

# Permintaan pertama
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Respons mencakup: "has_more": true, "next_page": "page_xyz..."

# Permintaan berikutnya dengan paginasi
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7&\
page=page_xyz..." \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



Kasus penggunaan umum

Jelajahi implementasi terperinci di Claude Cookbook:

• Laporan penggunaan harian: Lacak tren konsumsi token
• Atribusi biaya: Alokasikan pengeluaran berdasarkan workspace untuk chargeback
• Efisiensi cache: Ukur dan optimalkan caching prompt
• Pemantauan anggaran: Siapkan peringatan untuk ambang batas pengeluaran
• Ekspor CSV: Hasilkan laporan untuk tim keuangan



Pertanyaan yang sering diajukan



Seberapa baru datanya?

Data penggunaan dan biaya biasanya muncul dalam waktu 5 menit setelah permintaan API selesai, meskipun penundaan terkadang bisa lebih lama.



Berapa frekuensi polling yang direkomendasikan?

API mendukung polling sekali per menit untuk penggunaan berkelanjutan. Untuk lonjakan singkat (misalnya, mengunduh data berpaginasi), polling yang lebih sering dapat diterima. Simpan hasil dalam cache untuk dasbor yang memerlukan pembaruan sering.



Bagaimana cara melacak penggunaan eksekusi kode?

Biaya eksekusi kode muncul di endpoint biaya yang dikelompokkan di bawah Code Execution Usage di bidang deskripsi. Eksekusi kode tidak termasuk dalam endpoint penggunaan.



Bagaimana cara melacak penggunaan Priority Tier?

Filter atau kelompokkan berdasarkan service_tier di endpoint penggunaan dan cari nilai priority. Biaya Priority Tier tidak tersedia di endpoint biaya.



Apa yang terjadi dengan penggunaan Anthropic Workbench?

Penggunaan API dari Workbench tidak terkait dengan kunci API, sehingga api_key_id akan bernilai null bahkan saat mengelompokkan berdasarkan dimensi tersebut.



Bagaimana workspace default direpresentasikan?

Penggunaan dan biaya yang diatribusikan ke workspace default memiliki nilai null untuk workspace_id.



Bagaimana cara mendapatkan rincian biaya per pengguna untuk Claude Code?

Gunakan Claude Code Analytics API, yang menyediakan perkiraan biaya per pengguna dan metrik produktivitas tanpa keterbatasan kinerja dari merinci biaya berdasarkan banyak kunci API. Untuk penggunaan API umum dengan banyak kunci, gunakan Usage API untuk melacak konsumsi token sebagai proksi biaya.



Lihat juga

Gunakan Usage dan Cost API untuk memberikan pengalaman yang lebih baik bagi pengguna Anda, mengelola biaya, dan menjaga batas laju Anda. Pelajari lebih lanjut tentang beberapa fitur lainnya:

• Admin API
• Referensi Admin API
• Analytics APIs - API analitik dan jenis kunci mana yang dibutuhkan organisasi Anda
• Harga
• Caching prompt - Optimalkan biaya dengan caching
• Pemrosesan batch - Diskon 50% untuk permintaan batch
• Batas laju - Pahami tingkatan penggunaan
• Rate Limits API - Baca batas laju yang telah Anda konfigurasi
• Residensi data - Kontrol geografi inferensi