The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
API Admin Penggunaan & Biaya menyediakan akses terprogram dan granular ke data penggunaan dan biaya API historis untuk organisasi Anda. Data ini mirip dengan informasi yang tersedia di halaman Penggunaan dan Biaya dari Konsol Anthropic. API ini memungkinkan Anda untuk memantau, menganalisis, dan mengoptimalkan implementasi Claude dengan lebih baik:
  • Pelacakan Penggunaan yang Akurat: Dapatkan jumlah token yang tepat dan pola penggunaan 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
  • Optimisasi batas kecepatan dan Tingkat Prioritas: Optimalkan fitur seperti caching prompt atau prompt spesifik untuk memanfaatkan kapasitas yang dialokasikan secara maksimal, atau beli kapasitas khusus.
  • Analisis Lanjutan: Lakukan analisis data yang lebih mendalam daripada yang tersedia di Konsol
Kunci API Admin diperlukanAPI ini adalah bagian dari API Admin. Endpoint ini memerlukan kunci API Admin (dimulai dengan sk-ant-admin...) yang berbeda dari kunci API standar. Hanya anggota organisasi dengan peran admin yang dapat menyediakan kunci API Admin melalui Konsol Anthropic.

​
Solusi mitra

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

Datadog

Observabilitas LLM dengan pelacakan dan pemantauan otomatis

Grafana Cloud

Integrasi tanpa agen untuk observabilitas LLM yang mudah dengan dasbor dan peringatan siap pakai

Honeycomb

Kueri dan visualisasi lanjutan melalui OpenTelemetry

​
Mulai cepat

Dapatkan penggunaan harian organisasi Anda untuk 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"
Atur header User-Agent untuk integrasiJika Anda membangun integrasi, atur header User-Agent Anda untuk membantu kami memahami pola penggunaan:
User-Agent: YourApp/1.0.0 (https://yourapp.com)

​
API Penggunaan

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

​
Konsep kunci

  • Bucket waktu: Agregat data penggunaan dalam interval tetap (1m, 1h, atau 1d)
  • Pelacakan token: Ukur input tidak ter-cache, input ter-cache, pembuatan cache, dan token output
  • Penyaringan & pengelompokan: Filter berdasarkan kunci API, ruang kerja, model, tingkat layanan, atau jendela konteks, dan kelompokkan hasil berdasarkan dimensi ini
  • Penggunaan alat server: Lacak penggunaan alat sisi server seperti pencarian web
Untuk detail parameter lengkap dan skema respons, lihat referensi API Penggunaan.

​
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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Penggunaan per jam dengan penyaringan

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-sonnet-4-20250514&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Filter penggunaan berdasarkan kunci API dan ruang kerja

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"
Untuk mengambil ID kunci API organisasi Anda, gunakan endpoint Daftar Kunci API.Untuk mengambil ID ruang kerja organisasi Anda, gunakan endpoint Daftar Ruang Kerja, atau temukan ID ruang kerja organisasi Anda di Konsol Anthropic.

​
Batas granularitas waktu

GranularitasBatas DefaultBatas MaksimumKasus Penggunaan
1m60 bucket1440 bucketPemantauan real-time
1h24 bucket168 bucketPola harian
1d7 bucket31 bucketLaporan mingguan/bulanan

​
API Biaya

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

​
Konsep kunci

  • Mata uang: Semua biaya dalam USD, dilaporkan sebagai string desimal dalam unit terkecil (sen)
  • Jenis biaya: Lacak penggunaan token, pencarian web, dan biaya eksekusi kode
  • Pengelompokan: Kelompokkan biaya berdasarkan ruang kerja atau deskripsi untuk rincian detail
  • Bucket waktu: Hanya granularitas harian (1d)
Untuk detail parameter lengkap dan skema respons, lihat referensi API Biaya.
Biaya Tingkat Prioritas menggunakan model penagihan yang berbeda dan tidak termasuk dalam endpoint biaya. Lacak penggunaan Tingkat Prioritas melalui endpoint penggunaan sebagai gantinya.

​
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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Paginasi

Kedua endpoint mendukung paginasi untuk dataset besar:
  1. Buat permintaan awal Anda
  2. Jika has_more adalah true, gunakan nilai next_page dalam permintaan berikutnya
  3. Lanjutkan sampai has_more adalah 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# Respons termasuk: "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..." \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Kasus penggunaan umum

Jelajahi implementasi detail di anthropic-cookbook:
  • Laporan penggunaan harian: Lacak tren konsumsi token
  • Atribusi biaya: Alokasikan pengeluaran berdasarkan ruang kerja untuk chargeback
  • Efisiensi cache: Ukur dan optimalkan caching prompt
  • Pemantauan anggaran: Siapkan peringatan untuk ambang batas pengeluaran
  • Ekspor CSV: Buat laporan untuk tim keuangan

​
Pertanyaan yang sering diajukan

​
Seberapa segar datanya?

Data penggunaan dan biaya biasanya muncul dalam 5 menit setelah penyelesaian permintaan API, meskipun penundaan kadang-kadang bisa lebih lama.

​
Berapa frekuensi polling yang direkomendasikan?

API mendukung polling sekali per menit untuk penggunaan berkelanjutan. Untuk burst pendek (misalnya, mengunduh data yang dipaginasi), polling yang lebih sering dapat diterima. Cache hasil 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 Tingkat Prioritas?

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

​
Apa yang terjadi dengan penggunaan Workbench?

Penggunaan API dari Workbench tidak dikaitkan dengan kunci API, jadi api_key_id akan menjadi null bahkan ketika mengelompokkan berdasarkan dimensi tersebut.

​
Bagaimana ruang kerja default direpresentasikan?

Penggunaan dan biaya yang dikaitkan dengan ruang kerja default memiliki nilai null untuk workspace_id.

​
Lihat juga

API Penggunaan dan Biaya dapat digunakan untuk membantu Anda memberikan pengalaman yang lebih baik bagi pengguna Anda, membantu Anda mengelola biaya, dan mempertahankan batas kecepatan Anda. Pelajari lebih lanjut tentang beberapa fitur lain ini: