---
title: "Apakah itu had perbelanjaan API? Bajet, had dan 429 | BroadRouter"
description: "Had perbelanjaan mengehadkan belanja akaun atau projek API dalam satu tempoh. Cara had, amaran dan bajet berfungsi, ralat yang dipulangkan, dan model BroadNet."
url: https://broadrouter.com/ms/glossary/spend-limit/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/glossary/spend-limit/) (dikemas kini 2026-11-16).

# Had perbelanjaan (spend limit)

Dikemas kini 2026-11-16

Had perbelanjaan ialah had ke atas jumlah yang boleh dibelanjakan oleh akaun, projek atau kunci API dalam satu tempoh, biasanya sebulan. Apabila penggunaan mencapainya, penyedia menolak permintaan seterusnya, selalunya dengan ralat HTTP 429 atau 400, sehingga tempoh itu ditetapkan semula atau had dinaikkan.

Juga dikenali sebagai: had belanja, bajet API, had kos API, spending limit, spend cap, budget cap, usage cap

[Had kadar](https://broadrouter.com/ms/glossary/rate-limit/) mengawal sepantas mana anda boleh berbelanja. Had perbelanjaan mengawal sebanyak mana.

## Cara ia berfungsi

Penyedia menyusun beberapa lapisan had. Dua contoh yang didokumenkan:

| Penyedia | Kawalan | Apa yang berlaku apabila dicapai |
| --- | --- | --- |
| Anthropic | Had perbelanjaan peringkat setiap bulan kalendar (Start, Build, Scale; Custom tiada had) | Penggunaan dijeda hingga 00:00 UTC pada hari pertama bulan berikutnya; HTTP 429 `rate_limit_error` dengan `error.details.error_code` `enforced_spend_limit_reached`, tiada `retry-after` |
| Anthropic | Had anda sendiri yang lebih rendah, organisasi atau ruang kerja | HTTP 400 `invalid_request_error`, mesej bermula dengan “You have reached your specified API usage limits” |
| OpenAI | Had penggunaan bulanan setiap peringkat | Tidak diterangkan dalam panduan |
| OpenAI | Amaran perbelanjaan | Menghantar pemberitahuan; trafik diteruskan |
| OpenAI | Had perbelanjaan mutlak, organisasi atau projek | Permintaan yang terjejas memulangkan 429 |

Had peringkat Anthropic ialah USD 500 (Start), USD 1,000 (Build) dan USD 200,000 (Scale) sebulan. Panduan OpenAI menyenaraikan had penggunaan bulanan mengikut peringkat, daripada USD 100 pada Free hingga USD 200,000 pada Grow, dan menyatakan peringkat naik apabila jumlah pembelian kredit melepasi ambang tertentu.

Bahagian yang mengelirukan ialah 429 had perbelanjaan kelihatan sama seperti 429 had kadar. Pada API Anthropic, kod ralat membezakan kedua-duanya, dan respons had perbelanjaan tidak mempunyai pengepala `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 ia penting

-   **Amaran datang lambat.** Gelung yang pantas boleh membelanjakan banyak sebelum e-mel tiba. Had mutlak menghentikannya.
-   **Cuba semula memburukkan keadaan.** Klien yang membuat backoff dan mencuba semula setiap 429 akan terus mengasak had perbelanjaan tanpa hasil. Bezakan kedua-duanya.
-   **Had dikongsi.** Had peringkat akaun yang dikongsi oleh banyak aplikasi membolehkan satu tugas yang terlepas kawalan menyekat yang lain. Bajet setiap projek atau bajet dalam kod anda sendiri memisahkannya.

## Di BroadNet Inference

Rujukan API BroadNet menyenaraikan enam had pada kunci bayar ikut guna. Tiga yang mengehadkan kos dan daya pemprosesan ialah 30 permintaan seminit, 4 serentak, dan perbelanjaan, yang ditakrifkan sebagai “the native budget shared by the account’s pay-as-you-go keys” (Terjemahan BroadRouter: “bajet native yang dikongsi oleh kunci bayar ikut guna akaun itu”); yang lain ialah model yang dibenarkan, jangka hayat kunci satu tahun dan sehingga sepuluh kunci aktif bagi setiap akaun. Akaun ini [prabayar](https://broadrouter.com/ms/glossary/prepaid-credit/), jadi baki ialah had luarnya. Dua kod status penting:

-   **429**: “A rate, concurrency, token-rate or spending limit was reached.” (Terjemahan BroadRouter: “Had kadar, keserentakan, kadar token atau perbelanjaan telah dicapai.”)
-   **401**: kunci yang tiada, tidak sah atau tamat tempoh, atau akaun yang bajet bayar ikut guna dikongsinya disekat (perkataan dokumentasi ialah “a blocked native PAYG budget holder” (Terjemahan BroadRouter: “pemegang bajet PAYG native yang disekat”)), “including exhausted PAYG allowance” (Terjemahan BroadRouter: “termasuk elaun PAYG yang telah habis”).

Halaman privasi BroadNet menyatakan kunci diskop mengikut model, kadar dan perbelanjaan, tetapi rujukan API tidak menunjukkan tetapan bajet bagi setiap kunci atau projek, jadi letakkan semakan bajet berjalan dalam kod anda sendiri sebelum setiap permintaan, seperti dalam [kawalan perbelanjaan API LLM](https://broadrouter.com/ms/blog/llm-api-spend-control/). Untuk senario terburuk yang tetap, [pelan harga tetap](https://broadrouter.com/ms/plans/) atau kunci sejam pada $0.50 mengehadkan perbelanjaan secara reka bentuk. Pengendalian cuba semula ada dalam [panduan ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Soalan lazim

### Patutkah saya mencuba semula permintaan yang mencapai had perbelanjaan?

Tidak. Anthropic menyatakan 429 untuk had perbelanjaannya tidak membawa pengepala retry-after dan percubaan semula akan gagal sehingga akses disambung semula. Maklumkan seseorang atau hentikan tugas itu.

### Adakah amaran perbelanjaan sama dengan had perbelanjaan?

Tidak. OpenAI membezakan amaran perbelanjaan, yang hanya memberi pemberitahuan dan membiarkan trafik berterusan, daripada had perbelanjaan mutlak, yang menyebabkan permintaan memulangkan 429.

### Bolehkah saya menetapkan bajet berasingan bagi setiap kunci BroadNet?

Halaman privasi BroadNet menyatakan kunci API berskop mengawal akses mengikut model, kadar dan perbelanjaan, tetapi rujukan API-nya mendokumenkan perbelanjaan pada kunci bayar ikut guna sebagai bajet native yang dikongsi oleh kunci-kunci akaun dan tidak menunjukkan tetapan bajet bagi setiap kunci. Semak butiran kunci anda, dan kuatkuasakan bajet setiap aplikasi dalam kod anda sendiri.

## Lihat juga

-   [Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/) (istilah)
-   [Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/) (istilah)
-   [Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/) (istilah)
-   [Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/) (istilah)
-   [Backoff eksponen (exponential backoff)](https://broadrouter.com/ms/glossary/exponential-backoff/) (istilah)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/) (panduan)
-   [Kawalan perbelanjaan API LLM: bajet, had kunci dan perlindungan gelung](https://broadrouter.com/ms/blog/llm-api-spend-control/) (artikel)
-   [Cara mengendalikan ralat 429 API LLM: backoff, jitter dan pengehad](https://broadrouter.com/ms/blog/handle-llm-api-429-rate-limits/) (artikel)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

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

**Sumber**

-   [Dokumentasi Anthropic Claude API, rate limits: had perbelanjaan, had peringkat, 429 enforced\_spend\_limit\_reached (disemak 2026-11-15)](https://platform.claude.com/docs/en/api/rate-limits)
-   [Dokumentasi OpenAI API, panduan had kadar: peringkat penggunaan, amaran perbelanjaan dan had perbelanjaan mutlak (disemak 2026-11-15)](https://developers.openai.com/api/docs/guides/rate-limits)
-   [Rujukan API BroadNet Inference: had PAYG, bajet native dikongsi, maksud 401 dan 429 (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-spend-limit&utm_content=sources)
