---
title: API Penggunaan dan Biaya
url: https://platform.claude.com/docs/id/manage-claude/usage-cost-api
description: Akses data penggunaan dan biaya API organisasi Anda secara terprogram dengan Usage and Cost Admin API.
---
**Admin API tidak tersedia untuk akun individu.** Untuk berkolaborasi dengan rekan tim dan menambahkan anggota, siapkan organisasi Anda di halaman [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) di Claude Console.
Usage and 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](https://platform.claude.com/usage) (`platform.claude.com/usage`) dan halaman [Cost](https://platform.claude.com/cost) (`platform.claude.com/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 presisi 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
* **Optimasi ["rate limit" (batas laju)](https://platform.claude.com/docs/id/api/rate-limits):** Optimalkan fitur seperti ["prompt caching" (caching prompt)](https://platform.claude.com/docs/id/build-with-claude/prompt-caching) atau prompt tertentu untuk memaksimalkan kapasitas yang dialokasikan kepada Anda.
* **Analisis lanjutan:** Lakukan analisis data yang lebih mendalam daripada yang tersedia di Console
**Kredensial Admin API diperlukan.** Endpoint ini merupakan bagian dari Admin API. Anda dapat mengaksesnya menggunakan [kunci Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api-keys), token OAuth dengan cakupan `org:admin`, atau kunci akun pribadi maupun akun layanan yang tidak dibatasi pada suatu workspace; kunci API workspace tidak dapat digunakan. Lihat [Autentikasi](https://platform.claude.com/docs/id/manage-claude/admin-api#authentication) untuk detailnya.
Organisasi Claude Enterprise menggunakan kunci API Analytics dengan API yang berbeda; lihat [API mana yang Anda butuhkan?](https://platform.claude.com/docs/id/manage-claude/usage-cost-api#which-api-do-you-need).
**Claude Platform on AWS:** Endpoint API Penggunaan dan Biaya terprogram saat ini belum tersedia. Sebagai gantinya, lihat data penggunaan dan biaya di halaman **Usage** dan **Cost** pada Claude Console.
## API mana yang Anda butuhkan?
Anthropic menyediakan pelaporan biaya dan penggunaan melalui dua API, tergantung pada produk Claude mana yang dikelola organisasi Anda:
| Organisasi Anda | API | Jenis kunci |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Claude Console (Claude Platform) | Usage and Cost Admin API yang dijelaskan di halaman ini | Kunci Admin API (`sk-ant-admin01-...`) atau [kredensial Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api#authentication) lainnya |
| Claude Enterprise (claude.ai) | Endpoint biaya dan penggunaan [Claude Enterprise Analytics API](https://platform.claude.com/docs/id/api/beta/organization/analytics) | Kunci API Analytics |
Organisasi induk Claude Enterprise tidak muncul di Claude Console dan tidak memiliki kunci Admin API, sehingga bagi mereka kunci API Analytics adalah satu-satunya jalur untuk mengakses data ini. Lihat [Analytics API](https://platform.claude.com/docs/id/manage-claude/analytics-api) 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 perlu menulis kode kustom. Integrasi ini menyediakan dasbor, peringatan, dan analitik untuk membantu Anda mengelola penggunaan API secara efektif.
Platform kecerdasan cloud untuk melacak dan memperkirakan biaya
Observabilitas LLM dengan tracing dan pemantauan otomatis
Integrasi tanpa agen untuk observabilitas LLM yang mudah dengan dasbor dan peringatan siap pakai
Platform FinOps untuk manajemen biaya cloud dan AI
Kueri dan visualisasi lanjutan melalui OpenTelemetry
Atribusi penggunaan dan biaya ke item kerja Jira
Platform FinOps untuk observabilitas biaya & penggunaan LLM
## Mulai cepat
Dapatkan penggunaan harian organisasi Anda selama 7 hari terakhir:
```bash cURL
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"
```
**Tetapkan header User-Agent untuk integrasi**
Jika Anda membangun integrasi, tetapkan header User-Agent Anda untuk membantu Anthropic memahami pola penggunaan:
```text wrap
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 menggunakan endpoint `/v1/organizations/usage_report/messages`.
### Konsep utama
* **Bucket waktu:** Agregasikan 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, "context window" (jendela konteks), [residensi data](https://platform.claude.com/docs/id/manage-claude/data-residency), atau kecepatan, 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](https://platform.claude.com/docs/id/api/beta/organization/usage_report/retrieve_messages).
### Contoh dasar
#### Penggunaan harian berdasarkan model
```bash cURL
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
```bash cURL
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-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
```bash cURL
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"
```
Untuk mengambil ID kunci API organisasi Anda, gunakan endpoint [List API Keys](https://platform.claude.com/docs/id/api/organization/api_keys/list).
Untuk mengambil ID workspace organisasi Anda, gunakan endpoint [List Workspaces](https://platform.claude.com/docs/id/api/organization/workspaces/list), atau temukan ID workspace organisasi Anda di Claude Console.
#### Residensi data
Lacak [kontrol residensi data](https://platform.claude.com/docs/id/manage-claude/data-residency) Anda dengan mengelompokkan dan memfilter penggunaan menggunakan dimensi `inference_geo`. Ini berguna untuk memverifikasi perutean geografis di seluruh organisasi Anda.
```bash cURL
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`:
```bash cURL
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"
```
Model yang dirilis sebelum Februari 2026 (sebelum Claude Opus 4.6 dan Claude Sonnet 4.6) tidak mendukung parameter permintaan `inference_geo`, sehingga laporan penggunaannya mengembalikan `"not_available"` untuk dimensi ini. Anda dapat menggunakan `not_available` sebagai nilai filter di `inference_geos[]` untuk menargetkan model-model tersebut.
#### Fast mode
Lacak penggunaan [fast mode](https://platform.claude.com/docs/id/build-with-claude/fast-mode) dengan mengelompokkan dan memfilter menggunakan dimensi `speed`. Ini berguna untuk memantau penggunaan mode standar versus fast mode.
```bash cURL
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 "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
Anda juga dapat memfilter ke kecepatan tertentu. Nilai yang valid adalah `standard` dan `fast`:
```bash cURL
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 "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
### Batas granularitas waktu
| Granularitas | Batas default | Batas maksimum | Kasus penggunaan |
| ------------ | ------------- | -------------- | ------------------------ |
| `1m` | 60 bucket | 1.440 bucket | Pemantauan real-time |
| `1h` | 24 bucket | 168 bucket | Pola harian |
| `1d` | 7 bucket | 31 bucket | Laporan mingguan/bulanan |
## 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 field yang telah diurai seperti `model` dan `inference_geo`
* **Bucket waktu:** Hanya granularitas harian (`1d`)
Untuk detail parameter lengkap dan skema respons, lihat [referensi Cost API](https://platform.claude.com/docs/id/api/beta/organization/cost_report/retrieve).
Biaya Priority Tier menggunakan model penagihan yang berbeda dan tidak disertakan dalam endpoint biaya. Sebagai gantinya, lacak penggunaan Priority Tier melalui endpoint penggunaan.
### Contoh dasar
```bash cURL
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`.
```bash cURL
# 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](https://platform.claude.com/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 pengeluaran
* **Ekspor CSV:** Hasilkan laporan untuk tim keuangan
## Pertanyaan yang sering diajukan
### Seberapa baru datanya?
Data penggunaan dan biaya biasanya muncul dalam 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. 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` pada field deskripsi. Eksekusi kode tidak disertakan 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 playground?
Penggunaan API dari playground di Claude Console (dan dari Workbench lama sebelumnya) tidak dikaitkan 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](https://platform.claude.com/docs/id/manage-claude/claude-code-analytics-api), yang menyediakan estimasi biaya per pengguna dan metrik produktivitas tanpa keterbatasan kinerja akibat merinci biaya berdasarkan banyak kunci API. Untuk penggunaan API umum dengan banyak kunci, gunakan [Usage API](https://platform.claude.com/docs/id/manage-claude/usage-cost-api#usage-api) untuk melacak konsumsi token sebagai proksi biaya.
## Lihat juga
Gunakan Usage API 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 ini:
* [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api)
* [Referensi Admin API](https://platform.claude.com/docs/id/api/beta/organization)
* [Analytics API](https://platform.claude.com/docs/id/manage-claude/analytics-api) - API analitik dan jenis kunci mana yang dibutuhkan organisasi Anda
* [Harga](https://platform.claude.com/docs/id/about-claude/pricing)
* [Caching prompt](https://platform.claude.com/docs/id/build-with-claude/prompt-caching) - Optimalkan biaya dengan caching
* [Pemrosesan batch](https://platform.claude.com/docs/id/build-with-claude/batch-processing) - Diskon 50% untuk permintaan batch
* [Batas laju](https://platform.claude.com/docs/id/api/rate-limits) - Pahami tingkat penggunaan
* [Rate Limits API](https://platform.claude.com/docs/id/manage-claude/rate-limits-api) - Baca batas laju yang telah Anda konfigurasi
* [Residensi data](https://platform.claude.com/docs/id/manage-claude/data-residency) - Kontrol geografi inferensi