---
title: "Apa itu spend limit API? Anggaran, batas biaya, dan 429"
description: "Spend limit membatasi biaya akun atau proyek API dalam satu periode. Cara kerja batas, alert, dan anggaran, error yang muncul, dan model BroadNet."
url: https://broadrouter.com/id/glossary/spend-limit/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/glossary/spend-limit/) (diperbarui 2026-11-16).

# Spend limit (batas pengeluaran)

Diperbarui 2026-11-16

Spend limit adalah batas jumlah yang boleh dibelanjakan sebuah akun, proyek, atau key API dalam satu periode, biasanya sebulan. Saat pemakaian mencapai batas, penyedia menolak permintaan berikutnya, sering dengan error HTTP 429 atau 400, sampai periode di-reset atau batasnya dinaikkan.

Disebut juga: spend limit, batas pengeluaran, batas biaya API, batas anggaran, limit pemakaian, spending limit, spend cap, budget cap, usage cap

[Rate limit](https://broadrouter.com/id/glossary/rate-limit/) mengatur seberapa cepat Anda bisa berbelanja. Spend limit mengatur seberapa banyak.

## Cara kerjanya

Penyedia menumpuk beberapa lapis batas. Dua contoh yang terdokumentasi:

| Penyedia | Kontrol | Yang terjadi saat tercapai |
| --- | --- | --- |
| Anthropic | Batas pengeluaran per tier per bulan kalender (Start, Build, Scale; Custom tidak punya) | Pemakaian dihentikan sampai pukul 00:00 UTC tanggal satu bulan berikutnya; HTTP 429 `rate_limit_error` dengan `error.details.error_code` `enforced_spend_limit_reached`, tanpa `retry-after` |
| Anthropic | Batas lebih rendah yang Anda tetapkan sendiri, untuk organisasi atau workspace | HTTP 400 `invalid_request_error`, pesan diawali “You have reached your specified API usage limits” |
| OpenAI | Batas pemakaian bulanan per tier | Tidak dijelaskan di panduan |
| OpenAI | Spend alert | Mengirim notifikasi; trafik tetap berjalan |
| OpenAI | Hard spend limit, untuk organisasi atau proyek | Permintaan yang terdampak mengembalikan 429 |

Batas per tier Anthropic adalah USD 500 (Start), USD 1.000 (Build), dan USD 200.000 (Scale) per bulan. Panduan OpenAI mencantumkan batas pemakaian bulanan per tier, dari USD 100 di Free hingga USD 200.000 di Grow, dan menyatakan tier naik saat total pembelian kredit melewati ambang tertentu.

Bagian yang rumit: 429 karena spend limit terlihat sama dengan 429 karena rate limit. Di API Anthropic, kode error-nya yang membedakan, dan respons batas pengeluaran tidak punya header `retry-after`:

```python
err = resp.json().get("error", {})
if resp.status_code == 429 and err.get("details", {}).get("error_code") == "enforced_spend_limit_reached":
    stop_job_and_alert()      # retrying will not help
elif resp.status_code == 429:
    backoff_and_retry()
```

## Mengapa penting

-   **Alert datang terlambat.** Loop yang cepat bisa menghabiskan banyak uang sebelum email sampai. Batas keras (hard cap) menghentikannya.
-   **Retry memperburuk keadaan.** Klien yang melakukan backoff dan retry untuk setiap 429 akan menghantam spend limit tanpa guna. Bedakan keduanya.
-   **Batas bersama.** Batas level akun yang dipakai banyak aplikasi membuat satu job yang lepas kendali bisa memblokir yang lain. Anggaran per proyek atau anggaran di kode Anda sendiri menjaga semuanya terpisah.

## Di BroadNet Inference

Referensi API BroadNet mencantumkan enam batas pada key bayar sesuai pemakaian. Tiga yang membatasi biaya dan throughput adalah 30 permintaan per menit, 4 permintaan berjalan bersamaan, dan pengeluaran, yang didefinisikan sebagai “the native budget shared by the account’s pay-as-you-go keys” (Terjemahan BroadRouter: anggaran native yang dipakai bersama oleh key bayar sesuai pemakaian di akun itu); sisanya adalah model yang diizinkan, masa berlaku key satu tahun, dan maksimal sepuluh key aktif per akun. Akunnya [prabayar](https://broadrouter.com/id/glossary/prepaid-credit/), jadi saldo adalah batas terluar. Dua kode status yang penting:

-   **429**: “A rate, concurrency, token-rate or spending limit was reached.” (Terjemahan BroadRouter: batas laju, konkurensi, laju token, atau pengeluaran telah tercapai.)
-   **401**: key yang tidak ada, tidak valid, atau kedaluwarsa, atau akun yang anggaran bayar sesuai pemakaian bersamanya diblokir (dokumentasinya memakai frasa “a blocked native PAYG budget holder”), “including exhausted PAYG allowance” (Terjemahan BroadRouter: termasuk jatah PAYG yang sudah habis).

Halaman privasi BroadNet menyebut key dibatasi berdasarkan model, laju, dan pengeluaran, tetapi referensi API tidak menunjukkan pengaturan anggaran per key atau per proyek, jadi pasang pengecekan anggaran berjalan di kode Anda sendiri sebelum setiap permintaan, seperti di [kontrol pengeluaran API LLM](https://broadrouter.com/id/blog/llm-api-spend-control/). Untuk skenario terburuk yang pasti, [paket harga tetap](https://broadrouter.com/id/plans/) atau key per jam seharga $0.50 membatasi pengeluaran secara desain. Penanganan retry ada di [panduan error dan retry](https://broadrouter.com/id/guides/errors-and-retries/).

## Pertanyaan umum

### Perlukah saya me-retry permintaan yang terkena spend limit?

Tidak. Anthropic menyatakan 429 karena batas pengeluaran tidak membawa header retry-after dan retry akan terus gagal sampai akses dibuka kembali. Beri tahu manusia atau hentikan job-nya.

### Apakah spend alert sama dengan spend limit?

Tidak. OpenAI membedakan spend alert, yang hanya mengirim notifikasi dan membiarkan trafik tetap berjalan, dari hard spend limit, yang membuat permintaan mengembalikan 429.

### Bisakah saya mengatur anggaran terpisah per key BroadNet?

Halaman privasi BroadNet menyebut API key yang dibatasi lingkupnya mengontrol akses berdasarkan model, laju, dan pengeluaran, tetapi referensi API-nya mendokumentasikan pengeluaran key bayar sesuai pemakaian sebagai anggaran native yang dipakai bersama oleh key di akun itu, dan tidak menunjukkan pengaturan anggaran per key. Cek detail key Anda, dan terapkan anggaran per aplikasi di kode Anda sendiri.

## Lihat juga

-   [Kredit prabayar (prepaid credit)](https://broadrouter.com/id/glossary/prepaid-credit/) (istilah)
-   [Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/) (istilah)
-   [Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/) (istilah)
-   [Kunci API (API key)](https://broadrouter.com/id/glossary/api-key/) (istilah)
-   [Exponential backoff](https://broadrouter.com/id/glossary/exponential-backoff/) (istilah)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/) (panduan)
-   [Kontrol biaya API LLM: anggaran, batas kunci, dan proteksi loop](https://broadrouter.com/id/blog/llm-api-spend-control/) (artikel)
-   [Cara mengatasi error 429 API LLM: backoff, jitter, dan limiter](https://broadrouter.com/id/blog/handle-llm-api-429-rate-limits/) (artikel)

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

[Mulai](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-spend-limit&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi Anthropic Claude API, rate limits: spend limit, batas per tier, 429 enforced\_spend\_limit\_reached (diperiksa 2026-11-15)](https://platform.claude.com/docs/en/api/rate-limits)
-   [Dokumentasi API OpenAI, panduan rate limits: usage tier, spend alert, dan hard spend limit (diperiksa 2026-11-15)](https://developers.openai.com/api/docs/guides/rate-limits)
-   [Referensi API BroadNet Inference: batas PAYG, anggaran native bersama, arti 401 dan 429 (diperiksa 2026-11-15) (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-spend-limit&utm_content=sources)
