API Penggunaan dan Biaya

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

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.

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"

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 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"

Batas granularitas waktu

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.

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 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