API Penggunaan dan Biaya
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 Claude Console.
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 laju dan Tingkat Prioritas: Optimalkan fitur seperti prompt caching 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 Console
Kunci API Admin diperlukan
API 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 Claude Console.
Solusi mitra
Platform observabilitas terkemuka menawarkan integrasi siap pakai untuk memantau penggunaan dan biaya API Claude Anda, tanpa menulis kode khusus. Integrasi ini menyediakan dashboard, 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 dashboard 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 integrasi
Jika 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, atau1d) - Pelacakan token: Ukur input yang tidak di-cache, input yang di-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-5-20250929&\
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 Anthropic Console.
Batas granularitas waktu
| Granularitas | Batas Default | Batas Maksimum | Kasus Penggunaan |
|---|---|---|---|
1m | 60 bucket | 1440 bucket | Pemantauan real-time |
1h | 24 bucket | 168 bucket | Pola harian |
1d | 7 bucket | 31 bucket | Laporan 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:
- Buat permintaan awal Anda
- Jika
has_moreadalahtrue, gunakan nilainext_pagedalam permintaan berikutnya - Lanjutkan sampai
has_moreadalahfalse
# 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 prompt caching
- 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 mungkin 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 dashboard 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.
Bagaimana cara mendapatkan rincian biaya per pengguna untuk Claude Code?
Gunakan API Analitik Claude Code, yang menyediakan estimasi biaya per pengguna dan metrik produktivitas tanpa keterbatasan kinerja dari merinci biaya berdasarkan banyak kunci API. Untuk penggunaan API umum dengan banyak kunci, gunakan API Penggunaan untuk melacak konsumsi token sebagai proksi biaya.
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 laju Anda. Pelajari lebih lanjut tentang beberapa fitur lain ini:
- Ikhtisar API Admin
- Referensi API Admin
- Harga
- Prompt caching - Optimalkan biaya dengan caching
- Pemrosesan batch - Diskon 50% untuk permintaan batch
- Batas laju - Pahami tingkat penggunaan