---
title: "Kod ralat API LLM 401, 402, 409, 429: bila cuba semula"
description: "Maksud setiap status HTTP BroadNet Inference API, yang mana perlu dicuba semula dengan backoff, yang mana dibaiki dahulu, dan apa yang dihantar kepada sokongan."
url: https://broadrouter.com/ms/guides/errors-and-retries/
lang: ms
updated: 2026-11-14
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/guides/errors-and-retries/) (dikemas kini 2026-11-14).

# Kod ralat BroadNet Inference dan bila perlu cuba semula

Dikemas kini 2026-11-14

Semak status HTTP sebelum menghurai badan respons. Cuba semula 429 dan 5xx dengan backoff eksponen yang terhad. Baiki 400, 403, 413 dan 422 sebelum mencuba semula. Untuk 401, semak kunci dan baki; untuk 402, tambah dana ke akaun. Sentiasa log pengepala X-Request-ID untuk sokongan.

API memulangkan status HTTP biasa dan kod ralat yang boleh dibaca mesin. Pilih langkah seterusnya berdasarkan status. Jadual ini mengikut [rujukan API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-errors-and-retries&utm_content=body#errors) BroadNet.

| Status | Maksud | Tindakan |
| --- | --- | --- |
| 400 / 422 | Permintaan atau medan tidak sah | Baiki permintaan dahulu |
| 401 | Kunci tiada, tidak sah atau tamat tempoh, bajet bayar ikut guna disekat, atau elaun telah habis | Semak status kunci dan baki akaun |
| 402 `insufficient_balance` | Akaun tidak dapat menampung pembelian; badan respons termasuk baki dan harga | Tambah dana ke akaun, kemudian cuba lagi |
| 403 | Ditolak oleh dasar model, laluan atau IP | Baiki ketidakpadanan itu, contohnya [senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/) |
| 409 | Bercanggah dengan keadaan akaun: `mint_in_progress`, `key_limit_reached`, `credential_limit_reached`, `key_pending` | Cuba semula `mint_in_progress` sahaja, dengan `request_id` yang sama |
| 413 | Permintaan terlalu besar; fail transkripsi dihadkan kepada 26,214,400 bait | Kecilkan permintaan |
| 429 | Had kadar, keserentakan, kadar token atau perbelanjaan dicapai | Baca butiran respons, tunggu dan cuba semula |
| 500 / 502 / 503 / 504 | Pemprosesan di pihak pelayan | Cuba semula dengan backoff eksponen yang terhad; guna semula `request_id` yang sama untuk pembelian kunci sejam |

Dokumentasi BroadNet menyatakan supaya anda menyemak status HTTP sebelum menghurai badan JSON, kemudian membaca kod `error` yang boleh dibaca mesin jika ada.

## Apakah had yang menyebabkan 429?

Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 permintaan serentak. Menurut dokumentasi BroadNet, kunci sejam mendapat 120 permintaan seminit, satu strim dan 300,000 token seminit. Pada [pelan tanpa had](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/), setiap sesi menjalankan satu permintaan pada satu masa. Untuk melihat perbandingan had ini dengan OpenAI, Anthropic, Groq dan DeepSeek, baca [had kadar API LLM mengikut penyedia](https://broadrouter.com/ms/blog/llm-api-rate-limits-by-provider/).

## Bagaimanakah cara mencuba semula dengan OpenAI SDK?

Menurut [README di GitHub](https://github.com/openai/openai-python#retries), OpenAI Python SDK sudah pun mencuba semula ralat sambungan serta respons 408, 409, 429 dan 5xx sebanyak dua kali secara lalai, dengan backoff eksponen yang singkat. Tamat masa lalainya ialah 10 minit. Tetapkan kedua-duanya secara eksplisit. Dalam kod di bawah, nilai `0` untuk `max_retries` mematikan cuba semula automatik, dan `timeout` dalam saat; naikkan nilainya untuk jawapan penaakulan yang panjang:

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_retries=4,   # 0 turns automatic retries off
    timeout=120,     # seconds; raise it for long reasoning answers
)
```

## Bagaimanakah saya menulis backoff sendiri?

Jika anda memanggil API tanpa SDK, hadkan bilangan percubaan dan juga tempoh menunggu. Dalam fungsi di bawah, respons dipulangkan serta-merta jika statusnya bukan untuk dicuba semula, kerana itu sama ada kejayaan atau ralat yang perlu dibaiki, bukan dicuba semula:

```python
import random, time, requests

RETRY = {429, 500, 502, 503, 504}

def post_with_backoff(url, headers, body, tries=5):
    for attempt in range(tries):
        r = requests.post(url, headers=headers, json=body, timeout=120)
        if r.status_code not in RETRY:
            return r                      # success, or an error to fix rather than retry
        time.sleep(min(30, 2 ** attempt) + random.random())
    return r
```

Jangan sekali-kali mencuba semula 400, 403, 413 atau 422 tanpa perubahan: permintaan yang sama akan gagal dengan cara yang sama. Setiap cuba semula permintaan chat ialah inferens baharu dan dibilkan sekali lagi pada bayar ikut guna. Lihat [exponential backoff](https://broadrouter.com/ms/glossary/exponential-backoff/) untuk corak umumnya.

## Mencuba semula pembelian kunci sejam dengan selamat

`POST /portal/keys/hourly` menerima `request_id`. Selepas tamat masa, sambungan terputus, 409 `mint_in_progress` atau 5xx, cuba semula dengan `request_id` yang **sama**. `request_id` yang diguna semula tidak sekali-kali mencipta atau mengenakan caj untuk kunci kedua; ulangan itu memulangkan `already_issued: true` dan alias. Jangan jana id baharu sehingga anda tahu keputusan yang pertama. Maklumat lanjut tentang [idempotency key](https://broadrouter.com/ms/glossary/idempotency-key/).

## Penyelesaian masalah

-   **401 sejurus selepas tambah nilai.** Halaman akaun BroadNet memaparkan elaun terkini yang direkodkan dan menandakan perubahan dana sebagai sedang dikemas kini semasa ia diproses. Muat semula halaman dan cuba lagi setelah selesai.
-   **429 walaupun hanya beberapa permintaan seminit.** Anda mungkin mencapai had keserentakan 4 permintaan, contohnya dengan strim panjang yang berjalan selari. Gunakan kumpulan pekerja (worker pool) yang kecil.
-   **403 pada satu model tetapi tidak pada model lain.** Dasar kunci itu tidak meliputi model atau laluan tersebut. Contohnya, kunci pelan adalah untuk `broadnet/deepseek-v4.1-flash`, dan kunci sejam hanya meliputi `broadnet/gemma-4-26b-a4b`.
-   **SDK mencuba semula dan anda dibilkan dua kali.** Permintaan chat yang dicuba semula ialah inferens baharu. Tetapkan `max_retries=0` di tempat jawapan berganda lebih mahal daripada permintaan yang gagal.

## Apa yang perlu dihantar kepada sokongan

Sertakan nilai pengepala `X-Request-ID`, cap masa UTC, laluan, status HTTP dan alias kunci anda. Jangan sekali-kali menghantar kunci itu sendiri. [Panduan OpenAI Python SDK](https://broadrouter.com/ms/guides/openai-python-sdk/) menunjukkan cara membaca pengepala tersebut.

## Istilah dalam panduan ini

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

[Backoff eksponen (exponential backoff)](https://broadrouter.com/ms/glossary/exponential-backoff/)

Backoff eksponen ialah strategi cuba semula di mana klien menunggu lebih lama selepas setiap percubaan yang gagal, biasanya menggandakan kelewatan sehingga had tertentu, sebelum mencuba lagi. Menambah jitter rawak pada setiap penantian menyebarkan cubaan semula daripada banyak klien supaya mereka tidak mengenai pelayan pada saat yang sama.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

[Kunci idempotensi (idempotency key)](https://broadrouter.com/ms/glossary/idempotency-key/)

Kunci idempotensi ialah nilai unik, biasanya ID rawak seperti UUID, yang dilampirkan oleh klien pada permintaan yang mengubah keadaan, seperti pembayaran atau pembelian. Jika permintaan yang sama dihantar semula dengan kunci yang sama, pelayan memulangkan hasil asal dan tidak melakukan tindakan itu dua kali.

[Penstriman (streaming)](https://broadrouter.com/ms/glossary/streaming/)

Penstriman ialah cara memulangkan respons model bahasa dalam cebisan kecil semasa ia masih dijana, dan bukan sebagai satu jawapan di penghujung. API serasi OpenAI menstrim melalui server-sent events apabila permintaan menetapkan stream kepada true.

[Tamat masa permintaan (request timeout)](https://broadrouter.com/ms/glossary/request-timeout/)

Tamat masa permintaan (request timeout) ialah tempoh paling lama klien HTTP menunggu pelayan sebelum meninggalkan permintaan. Klien biasanya membahagikannya kepada connect timeout untuk membuka sambungan dan read timeout untuk menunggu data. Panggilan LLM memerlukan read timeout yang longgar kerana jawapan panjang mengambil masa.

## Soalan lazim

### Patutkah saya mencuba semula ralat 429 daripada API LLM?

Ya, dengan backoff eksponen yang terhad. Di BroadNet Inference, 429 bermaksud had kadar, keserentakan, kadar token atau perbelanjaan telah dicapai. Kurangkan paralelisme jika ia berulang, dan berhenti mencuba semula apabila had perbelanjaan ialah puncanya.

### Mengapakah saya mendapat 401 walaupun kunci saya betul?

Di BroadNet, 401 juga meliputi elaun bayar ikut guna yang telah habis atau bajet yang disekat, bukan hanya kunci yang salah atau tamat tempoh. Semak baki akaun dan status kunci di halaman akaun.

### Apakah perbezaan antara 401 dan 403 di sini?

401 berkaitan kunci atau elaun akaun. 403 bermaksud kunci berfungsi tetapi permintaan ditolak oleh dasar model, laluan atau IP, contohnya panggilan daripada alamat yang tiada dalam senarai dibenarkan.

### Adakah OpenAI SDK mencuba semula ralat secara automatik?

Ya. Secara lalai, OpenAI Python SDK mencuba semula ralat sambungan, 408, 409, 429 dan 5xx sebanyak dua kali dengan backoff eksponen yang singkat. Tetapkan max\_retries untuk mengubah bilangannya, atau 0 untuk mematikan cuba semula.

## Panduan berkaitan

-   [Strim chat completions dan kendalikan sambungan yang terputus](https://broadrouter.com/ms/guides/streaming-chat-completions/)
-   [Kunci API kepada pelayan anda dengan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)

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-guides-errors-and-retries&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API BroadNet Inference, ralat dan cuba semula (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-errors-and-retries&utm_content=sources#errors)
-   [Rujukan API BroadNet Inference, had (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-errors-and-retries&utm_content=sources#limits)
-   [README OpenAI Python SDK, cuba semula dan tamat masa (disemak 2026-11-14)](https://github.com/openai/openai-python#retries)
