Spend Limits API
Tetapkan batas pengeluaran pada setiap anggota Claude Enterprise, lihat dari mana batas pengeluaran setiap anggota diwarisi, dan tinjau atau tindak lanjuti permintaan anggota untuk batas yang lebih tinggi.
Spend Limits API memungkinkan Anda menetapkan “spend limit” (batas pengeluaran) pada setiap anggota Claude Enterprise, melihat dari mana batas pengeluaran setiap anggota diwarisi, dan meninjau atau menindaklanjuti permintaan anggota untuk batas yang lebih tinggi.
Untuk pelaporan penggunaan dan biaya per pengguna dan per rentang waktu, lihat API Analitik atau Usage and Cost Analytics API.
Ikhtisar
API ini menyediakan delapan endpoint pada dua sumber daya:
| Sumber daya | Endpoint | Digunakan untuk |
|---|---|---|
| Batas pengeluaran | GET /v1/organizations/spend_limits/effectiveGET /v1/organizations/spend_limits/{spend_limit_id}POST /v1/organizations/spend_limitsDELETE /v1/organizations/spend_limits/{spend_limit_id} | Membaca batas pengeluaran efektif setiap anggota dan pengeluaran periode berjalan; menetapkan atau menghapus override per pengguna. |
| Permintaan kenaikan batas pengeluaran | GET /v1/organizations/spend_limit_increase_requestsGET /v1/organizations/spend_limit_increase_requests/{id}POST /v1/organizations/spend_limit_increase_requests/{id}/approvePOST /v1/organizations/spend_limit_increase_requests/{id}/deny | Mendaftar permintaan anggota untuk batas pengeluaran yang lebih tinggi, beserta konteks yang diperlukan untuk memutuskan; menyetujui atau menolak setiap permintaan. |
Gunakan endpoint batas pengeluaran untuk menjawab “batas pengeluaran apa yang berlaku untuk setiap anggota, dari mana asalnya, dan seberapa dekat mereka dengan batas tersebut?” serta untuk menetapkan override per pengguna. Gunakan endpoint permintaan kenaikan batas pengeluaran untuk memproses antrean permintaan yang diajukan anggota.
Prasyarat
- Organisasi Anda harus menggunakan paket Claude Enterprise.
- Kredit penggunaan harus diaktifkan untuk organisasi Anda. Pemilik utama Anda dapat mengaktifkannya di pengaturan penagihan claude.ai.
SDK menyediakan endpoint ini di bawah client.beta.organization.spend_limits, dan CLI ant di bawah ant beta:organization:spend-limits. Keduanya mengirimkan header anthropic-version untuk Anda. Contoh-contoh membaca kunci Admin API dari variabel lingkungan ANTHROPIC_API_KEY. SDK dan CLI mengambil halaman berikutnya untuk Anda saat Anda menelusuri hasil, sehingga limit menetapkan ukuran halaman, bukan total (lihat Paginasi).
Mulai cepat
Tampilkan daftar batas pengeluaran bulanan efektif dan pengeluaran periode berjalan setiap anggota:
client = anthropic.Anthropic()
effective_limits = client.beta.organization.spend_limits.effective.list(limit=20)
for effective_limit in effective_limits:
scope = effective_limit.scope
if scope.type == "user":
amount = effective_limit.amount or "unlimited"
print(f"{scope.user_id}: {effective_limit.period_to_date_spend} of {amount}")Konsep utama
Hierarki batas pengeluaran
Sebuah effective spend limit (batas pengeluaran efektif) berlaku pada pengeluaran setiap anggota, yang ditentukan dari hierarki tingkat cakupan. Ketika seorang anggota tidak memiliki override per pengguna, mereka mewarisi batas pengeluaran yang dikonfigurasi untuk grup mereka (jika organisasi Anda menggunakan batas berbasis grup), tingkat kursi mereka, atau default seluruh organisasi. Batas pengeluaran grup adalah default per anggota: setiap anggota yang mewarisinya dibatasi berdasarkan pengeluaran mereka sendiri, bukan anggaran grup yang digabungkan.
Membaca GET /v1/organizations/spend_limits/effective mengembalikan setiap anggota saat ini beserta batas pengeluaran efektif mereka yang telah ditentukan, dari mana batas tersebut ditentukan (source), dan pengeluaran periode berjalan mereka. Menetapkan override per pengguna dengan POST /v1/organizations/spend_limits mengunci seorang anggota pada batas pengeluaran tertentu terlepas dari apa yang seharusnya mereka warisi. Menghapus override mengembalikan mereka ke batas pengeluaran yang diwarisi (atau membiarkan mereka tanpa batas jika tidak ada).
Field source pada baris setiap anggota memberi tahu Anda dari tingkat mana batas pengeluaran mereka ditentukan: user (override per pengguna), seat_tier, rbac_group, atau organization. Perlakukan tipe cakupan sebagai himpunan terbuka; lewati nilai yang tidak dikenal alih-alih gagal.
Periode
period adalah jendela berulang di mana batas pengeluaran diberlakukan dan pengeluaran direset. Sebuah batas pengeluaran diidentifikasi oleh pasangan (scope, period)-nya. Saat ini monthly adalah satu-satunya periode yang didukung; pengeluaran bulanan direset pada 00:00 UTC di tanggal satu setiap bulan kalender. Perlakukan period sebagai himpunan terbuka.
Jumlah dan mata uang
Semua nilai moneter berupa string dalam satuan terkecil (minor units) dari mata uang penagihan organisasi (sen, untuk USD). Misalnya, "50000" mewakili $500,00 USD. Parse sebagai desimal dan bagi dengan 100 untuk menampilkan dolar; hindari floating-point biner untuk nilai besar.
amount bersifat nullable. Pada baris efektif seorang anggota, null berarti tanpa batas (tidak ada batas pengeluaran) dan "0" berarti anggota tidak dapat menggunakan Claude melebihi penggunaan yang termasuk dalam paket mereka. Pada baris batas pengeluaran yang dikonfigurasi (seperti yang dikembalikan oleh GET /v1/organizations/spend_limits/{id}), null hanya berarti tidak ada batas pengeluaran numerik yang ditetapkan; baca baris efektif anggota untuk membedakan tanpa batas dari hanya-penggunaan-termasuk.
period_to_date_spend adalah pengeluaran anggota yang terakumulasi sejak awal period saat ini, dalam format satuan terkecil yang sama; nilai ini mungkin mengandung bagian pecahan (misalnya, "41280.125"). Nilainya mungkin terbaca sebagai "0" jika pembacaan pengeluaran untuk sementara tidak tersedia; perlakukan nilai ini sebagai informasi, bukan transaksional.
Siklus hidup permintaan kenaikan
Sebuah spend limit increase request (permintaan kenaikan batas pengeluaran) dibuat ketika seorang anggota mengklik Request more usage di claude.ai. Permintaan tidak dibuat melalui API ini. status sebuah permintaan adalah salah satu dari:
| Status | Arti |
|---|---|
pending | Menunggu tindakan admin. Permintaan biasanya membawa spend_summary langsung sehingga Anda dapat melihat batas pengeluaran efektif anggota saat ini dan pengeluaran periode berjalan saat mengambil keputusan; spend_summary mungkin bernilai null jika tidak dapat dihitung. |
approved | Permintaan diselesaikan dengan persetujuan: baik admin menyetujuinya secara eksplisit, tindakan admin lain menaikkan batas pengeluaran anggota, atau dukungan Anthropic menaikkan batas pengeluaran atas nama organisasi. spend_summary bernilai null. |
denied | Admin menolak. spend_summary bernilai null. Anggota dapat langsung mengirim permintaan baru; hanya permintaan pending yang memblokir permintaan baru. Admin tetap dapat menaikkan batas pengeluaran anggota secara langsung kapan saja. |
Baik approved maupun denied bersifat terminal. Seorang anggota memiliki paling banyak satu permintaan pending pada satu waktu.
Menyetujui dengan POST /v1/organizations/spend_limit_increase_requests/{id}/approve menulis baris batas pengeluaran per pengguna yang sama dengan yang ditulis oleh POST /v1/organizations/spend_limits. Menetapkan batas pengeluaran secara langsung tidak mentransisikan permintaan yang pending; gunakan endpoint approve untuk menyelesaikan permintaan.
Secara default, Anthropic mengirim email kepada anggota ketika permintaan mereka disetujui atau ditolak. Sertakan suppress_notification: true saat menyetujui atau menolak untuk menekan email tersebut (misalnya, ketika sistem Anda sendiri yang memberi tahu anggota).
Pembuatan versi
Kirim header anthropic-version pada setiap permintaan; lihat Versi API untuk versi yang tersedia.
Pembatasan laju
Kedelapan endpoint berbagi satu “rate limit” (batas laju) per organisasi sebesar 60 permintaan per menit. Permintaan yang melebihi batas mengembalikan 429 Too Many Requests.
Paginasi
GET /v1/organizations/spend_limits/effective dan GET /v1/organizations/spend_limit_increase_requests dipaginasi dengan kursor opaque. Permintaan pertama mengembalikan hingga limit baris ditambah kursor next_page; teruskan kursor tersebut tanpa perubahan sebagai parameter page pada permintaan berikutnya, dan ulangi hingga next_page bernilai null.
Jangan mengubah parameter query di tengah urutan. Cursor terikat pada filter yang menerbitkannya. Jika Anda mengubah user_ids[], period[], status[], atau actor_ids[] dan meneruskan cursor lama, Anda akan mendapatkan 400 dengan “cursor does not match current query parameters”. Mulailah urutan baru dari halaman pertama.
Serialisasi parameter daftar
Parameter daftar menggunakan notasi kurung siku: ulangi nama parameter dengan [] untuk setiap nilai.
user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPqRespons error
Respons error mengikuti bentuk standar yang didokumentasikan di Error Claude API. Sertakan request_id dari body respons saat menghubungi dukungan.
Batas pengeluaran
Mendaftar batas pengeluaran efektif setiap anggota
GET /v1/organizations/spend_limits/effective mengembalikan satu baris per anggota saat ini, yang mencerminkan batas pengeluaran efektif setiap anggota, source-nya dalam hierarki cakupan, dan period_to_date_spend mereka. Memerlukan cakupan read:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Mendaftar batas pengeluaran efektifPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
effective_limits = client.beta.organization.spend_limits.effective.list(limit=20)
for effective_limit in effective_limits:
scope = effective_limit.scope
if scope.type == "user":
amount = effective_limit.amount or "unlimited"
print(f"{scope.user_id}: {effective_limit.period_to_date_spend} of {amount}"){
"data": [
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "jane@example.com",
"deleted": false
},
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}
],
"next_page": "page_..."
}Mendapatkan satu batas pengeluaran
GET /v1/organizations/spend_limits/{spend_limit_id} mengembalikan satu batas pengeluaran yang dikonfigurasi berdasarkan ID. Gunakan untuk memeriksa baris yang dirujuk oleh field spend_limit_id. Memerlukan cakupan read:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Mengambil batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
spend_limit = client.beta.organization.spend_limits.retrieve(
"spl_01AbCdEfGhIjKlMnOpQrSt"
)
amount = spend_limit.amount or "none"
print(f"id: {spend_limit.id}")
print(f"amount: {amount}")Menetapkan override per pengguna
POST /v1/organizations/spend_limits menetapkan override batas pengeluaran per pengguna. Ini adalah upsert dengan kunci (scope, period): menetapkan batas untuk pengguna dan periode yang sudah memilikinya akan menimpanya di tempat. Endpoint ini hanya menerima scope.type: "user"; default tingkat seat-tier, grup, dan organisasi dikonfigurasi di pengaturan claude.ai. Memerlukan cakupan write:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Membuat batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
spend_limit = client.beta.organization.spend_limits.set(
scope={"type": "user", "user_id": "user_01AbCdEfGh"}, amount="75000"
)
print(f"id: {spend_limit.id}")
print(f"amount: {spend_limit.amount}"){
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:02:44Z",
"updated_at": "2026-05-11T10:02:44Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}Menghapus override per pengguna
DELETE /v1/organizations/spend_limits/{spend_limit_id} menghapus override per pengguna, setelah itu anggota kembali ke default tingkat kursi, grup, atau organisasi yang diwarisi. Baris tingkat seat-tier, grup, dan organisasi tidak dapat dihapus melalui endpoint ini. Memerlukan cakupan write:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Menghapus batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
deleted_spend_limit = client.beta.organization.spend_limits.delete(
"spl_01RsTuVwXyZaBcDeFgHiJk"
)
print(f"id: {deleted_spend_limit.id}")Permintaan kenaikan batas pengeluaran
Mendaftar permintaan kenaikan
GET /v1/organizations/spend_limit_increase_requests mendaftar permintaan, yang terbaru lebih dulu. Filter berdasarkan status[] (pending, approved, denied) dan actor_ids[]. Daftar ini mengecualikan permintaan yang pemohonnya bukan lagi anggota organisasi. Memerlukan cakupan read:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Mendaftar permintaan kenaikan batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
increase_requests = client.beta.organization.spend_limits.increase_requests.list(
status=["pending"], limit=50
)
for increase_request in increase_requests:
print(f"{increase_request.id}: {increase_request.status}")Setiap permintaan pending membawa spend_summary langsung yang menunjukkan batas pengeluaran efektif pemohon saat ini dan pengeluaran periode berjalan, cukup untuk memutuskan tanpa pencarian terpisah.
Mendapatkan satu permintaan kenaikan
GET /v1/organizations/spend_limit_increase_requests/{id} mengembalikan satu permintaan berdasarkan ID. Memerlukan cakupan read:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Mengambil permintaan kenaikan batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
increase_request = client.beta.organization.spend_limits.increase_requests.retrieve(
"slir_01AbCdEfGhIjKlMnOpQrSt"
)
print(f"id: {increase_request.id}")
print(f"status: {increase_request.status}")Menyetujui permintaan kenaikan
POST /v1/organizations/spend_limit_increase_requests/{id}/approve menyetujui permintaan pending: endpoint ini menulis batas pengeluaran per pengguna pada amount yang diberikan admin untuk pemohon dan mentransisikan permintaan ke approved. Permintaan tidak membawa jumlah yang diminta; Anda memberikan batas pengeluaran baru saat persetujuan. Memerlukan cakupan write:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Menyetujui permintaan kenaikan batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
increase_request = client.beta.organization.spend_limits.increase_requests.approve(
"slir_01AbCdEfGhIjKlMnOpQrSt", amount="75000", suppress_notification=True
)
print(f"id: {increase_request.id}")
print(f"status: {increase_request.status}")Menolak permintaan kenaikan
POST /v1/organizations/spend_limit_increase_requests/{id}/deny menolak permintaan pending. Idempoten pada denied: menolak permintaan yang sudah ditolak mengembalikan 200 dengan sumber daya yang ada. Endpoint ini menolak upaya untuk menolak permintaan yang sudah disetujui sehingga otomatisasi dapat membedakan percobaan ulang dari keputusan yang bertentangan. Memerlukan cakupan write:spend_limits.
Untuk detail parameter lengkap dan skema respons, lihat Menolak permintaan kenaikan batas pengeluaranPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. di referensi API.
client = anthropic.Anthropic()
increase_request = client.beta.organization.spend_limits.increase_requests.deny(
"slir_01AbCdEfGhIjKlMnOpQrSt", suppress_notification=True
)
print(f"id: {increase_request.id}")
print(f"status: {increase_request.status}")Contoh alur kerja
Beberapa alur kerja ini menggabungkan Spend Limits API dengan endpoint biaya dari Usage and Cost Analytics API. Endpoint biaya dirancang untuk pelaporan pengeluaran seluruh organisasi dalam rentang tanggal. GET /spend_limits/effective mengembalikan batas yang saat ini berlaku untuk setiap anggota. Mulailah penyisiran dengan endpoint biaya untuk menemukan anggota mana yang perlu dilihat, lalu baca batas mereka saat ini dengan /effective.
Endpoint Spend Limits memerlukan cakupan spend_limits dan endpoint biaya memerlukan read:analytics. Contoh-contoh menggunakan satu kunci Admin API yang memiliki cakupan dari setiap API yang dipanggil. Pemilik utama memilih cakupan ini saat membuat kunci. Semua nilai moneter pada keduanya adalah string desimal dalam satuan minor (sen). Kedua API dipaginasi dengan kursor opaque. Tetapkan limit secara eksplisit dan telusuri next_page hingga bernilai null untuk mencakup seluruh organisasi.
Mengotomatiskan alur peninjauan permintaan kenaikan
Jalankan job terjadwal yang mengambil permintaan pending, menerapkan kebijakan persetujuan organisasi Anda, dan menyelesaikan masing-masing.
-
Tampilkan daftar permintaan pending:
Pythonclient = anthropic.Anthropic() increase_requests = client.beta.organization.spend_limits.increase_requests.list( status=["pending"], limit=100 ) for increase_request in increase_requests: print(f"{increase_request.id}: {increase_request.status}")Setiap permintaan membawa
actor.user_idpemohon danspend_summarylangsung denganamountefektif mereka saat ini danperiod_to_date_spend, cukup untuk memutuskan tanpa pencarian terpisah. -
Terapkan kebijakan Anda. Misalnya, setujui otomatis ketika
amountanggota saat ini di bawah ambang, dan arahkan batas yang lebih besar untuk peninjauan manual. -
Selesaikan setiap permintaan. Untuk menyetujui, berikan batas baru:
Pythonclient = anthropic.Anthropic() increase_request = client.beta.organization.spend_limits.increase_requests.approve( "slir_01AbCdEfGhIjKlMnOpQrSt", amount="75000", suppress_notification=True ) print(f"id: {increase_request.id}") print(f"status: {increase_request.status}")Untuk menolak, panggil endpoint deny dengan ID yang sama sebagai gantinya. Kirimkan
suppress_notification: trueketika sistem Anda sendiri memberi tahu pemohon.
Mengidentifikasi anggota yang mendekati batas pengeluaran mereka
Temukan anggota yang mendekati batas mereka sehingga Anda dapat menaikkannya sebelum mereka terblokir.
-
Ambil pengeluaran bulan berjalan setiap anggota dari Usage and Cost Analytics API (satu baris untuk setiap anggota, diurutkan dari pengeluaran tertinggi secara default):
Pythonclient = anthropic.Anthropic() cost_rows = client.beta.organization.analytics.cost.list( starting_at="2026-06-01T00:00:00Z", actor_types=["user_actor"], group_by=["actor"], limit=1000, ) for cost_row in cost_rows: actor = cost_row.group.actor if actor is not None and actor.type == "user_actor": print(f"{actor.user_id}: {cost_row.cost.amount}")Setiap baris berisi
group.actor.user_id,group.actor.email_address, dancost.amount(pengeluaran anggota dalam sen). Telusurinext_pageuntuk mencakup seluruh organisasi. -
Untuk pembelanja teratas (atau semua orang di atas ambang dolar), ambil batas efektif dalam batch:
Pythonclient = anthropic.Anthropic() effective_limits = client.beta.organization.spend_limits.effective.list( user_ids=["user_01AbCdEfGh", "user_01JkLmNoPq"], limit=100 ) for effective_limit in effective_limits: scope = effective_limit.scope if scope.type == "user": amount = effective_limit.amount or "unlimited" print(f"{scope.user_id}: {effective_limit.period_to_date_spend} of {amount}")Setiap baris mengembalikan batas sebagai
amount(null= tanpa batas,"0"= hanya penggunaan termasuk) bersamaperiod_to_date_spend. -
Untuk setiap anggota dengan batas positif, hitung
period_to_date_spend / amountdan tandai mereka yang berada pada atau di atas ambang Anda (misalnya, 80 persen). Perlakukan batas"0"sebagai sudah mencapai batas. Tidak ada filter sisi server untuk rasio ini. -
Tindak lanjuti anggota yang ditandai: naikkan batas dengan
POST /v1/organizations/spend_limits, setujui permintaan kenaikan yang tertunda jika ada, atau hubungi anggota tersebut.
Menemukan anggota dengan penggunaan yang berubah cepat
Munculkan anggota yang pengeluarannya melonjak dari minggu ke minggu.
-
Ambil biaya harian per anggota selama 2 minggu terakhir dari Usage and Cost Analytics API:
Pythonclient = anthropic.Anthropic() cost_rows = client.beta.organization.analytics.cost.list( starting_at="2026-06-09T00:00:00Z", ending_at="2026-06-23T00:00:00Z", time_bucket_width="1d", actor_types=["user_actor"], group_by=["actor"], limit=1000, ) for cost_row in cost_rows: actor = cost_row.group.actor if actor is not None and actor.type == "user_actor": print(f"{actor.user_id} {cost_row.starting_at}: {cost_row.cost.amount}")Dengan
time_bucket_widthditetapkan, setiap anggota mencakup satu baris untuk setiap hari yang memiliki penggunaan. Telusuri halaman melaluinext_pageuntuk mengumpulkan seluruh rangkaian data setiap anggota. -
Kelompokkan baris berdasarkan
group.actor.user_id. Untuk setiap anggota, jumlahkan 7 hari terbaru dan 7 hari sebelumnya. Tandai anggota yang minggu terbarunya melebihi minggu sebelumnya sebesar kelipatan yang Anda pilih (misalnya, tiga kali). Biaya untuk hari-hari terbaru masih dapat berubah. Untuk perbandingan yang dapat diulang, tetapkanending_atpada atau sebelumdata_refreshed_atyang sudah Anda lihat (lihat Kesegaran data). -
Tindak lanjuti anggota yang ditandai: sesuaikan batas dengan
POST /v1/organizations/spend_limits, atau hubungi anggota tersebut.
Menaikkan sementara batas pengeluaran anggota selama insiden
Berikan ruang bagi penanggap insiden untuk bekerja selama insiden masih terbuka: naikkan batas pengeluaran mereka saat insiden dimulai, dan kembalikan setelah insiden ditutup. Batasi kenaikan ini berdasarkan sistem manajemen insiden Anda, misalnya, dengan mewajibkan ID insiden aktif yang menugaskan anggota tersebut.
-
Baca batas anggota saat ini, dan catat untuk rollback:
Pythonclient = anthropic.Anthropic() effective_limits = client.beta.organization.spend_limits.effective.list( user_ids=["user_01AbCdEfGh"], period=["monthly"] ) for effective_limit in effective_limits: scope = effective_limit.scope if scope.type == "user": amount = effective_limit.amount or "unlimited" print(f"{scope.user_id}: {effective_limit.period_to_date_spend} of {amount}") -
Naikkan batas:
Pythonclient = anthropic.Anthropic() spend_limit = client.beta.organization.spend_limits.set( scope={"type": "user", "user_id": "user_01AbCdEfGh"}, amount="500000", period="monthly", ) print(f"id: {spend_limit.id}") print(f"amount: {spend_limit.amount}") -
Jika penanggap memerlukan akses yang lebih luas selama insiden, sediakan terlebih dahulu grup incident-responders yang peran kustomnya memberikan akses tersebut, dan tambahkan anggota selama durasi insiden:
Pythonclient = anthropic.Anthropic() member = client.beta.organization.rbac_groups.members.add( "rbac_group_01UvWxYzAbCdEfGhIjKlMn", user_id="user_01AbCdEfGh" ) print(f"user_id: {member.user_id}") print(f"rbac_group_id: {member.rbac_group_id}")Lihat Manajemen pengguna untuk endpoint grup.
-
Ketika sistem insiden Anda menandai insiden sebagai ditutup, kembalikan kedua perubahan: pulihkan batas pengeluaran yang Anda catat pada langkah 1 (atau hapus override dengan
DELETE /v1/organizations/spend_limits/{spend_limit_id}jika anggota sebelumnya tidak memilikinya), dan hapus anggota dari grup denganDELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}.
Pertanyaan yang sering diajukan
Apakah menetapkan batas pengeluaran secara langsung menyelesaikan permintaan kenaikan pending seorang anggota?
Tidak. POST /v1/organizations/spend_limits menulis override tetapi membiarkan permintaan pending tidak tersentuh. Gunakan POST /v1/organizations/spend_limit_increase_requests/{id}/approve untuk menyelesaikan permintaan dan menulis override dalam satu panggilan.
Apa yang terjadi ketika saya menghapus override per pengguna?
Anggota kembali ke apa pun yang akan mereka warisi dari hierarki: default grup, seat-tier, atau organisasi mereka. Jika tidak ada default di tingkat mana pun, anggota tersebut tanpa batas.
Dapatkah saya menetapkan default seat-tier atau seluruh organisasi melalui API ini?
Tidak. Hanya override per pengguna yang dapat ditulis melalui API ini. Default tingkat seat-tier, grup, dan organisasi dikonfigurasi di pengaturan Organisasi claude.ai.
Mengapa period_to_date_spend terkadang terbaca sebagai "0" untuk anggota aktif?
Pembacaan pengeluaran dapat sementara tidak tersedia, dalam hal ini field terbaca "0" alih-alih menghasilkan error. Perlakukan sebagai informasional.
Lihat juga
Skema permintaan dan respons yang dihasilkan untuk setiap endpoint Spend Limits API.
Skema permintaan dan respons yang dihasilkan untuk endpoint permintaan kenaikan.
Lacak penggunaan token dan biaya untuk organisasi Anda.
Apakah halaman ini membantu?