---
title: "Kode error API LLM 401, 402, 409, 429: kapan retry | BroadRouter"
description: "Arti setiap status HTTP dari API BroadNet Inference, mana yang dicoba ulang dengan backoff, mana yang harus diperbaiki dulu, dan apa yang dikirim ke tim dukungan."
url: https://broadrouter.com/id/guides/errors-and-retries/
lang: id
updated: 2026-11-14
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/guides/errors-and-retries/) (diperbarui 2026-11-14).

# Kode error BroadNet Inference dan kapan harus mencoba ulang

Diperbarui 2026-11-14

Periksa status HTTP sebelum mem-parse body. Coba ulang 429 dan 5xx dengan exponential backoff yang dibatasi. Perbaiki 400, 403, 413, dan 422 sebelum mencoba ulang. Untuk 401, periksa kunci dan saldo; untuk 402, isi saldo akun. Selalu catat header X-Request-ID untuk tim dukungan.

API mengembalikan status HTTP biasa dan kode error yang dapat dibaca mesin. Tentukan langkah berikutnya dari status tersebut. Tabel ini mengikuti [referensi API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-errors-and-retries&utm_content=body#errors) BroadNet.

| Status | Artinya | Yang harus dilakukan |
| --- | --- | --- |
| 400 / 422 | Permintaan atau field tidak valid | Perbaiki permintaannya dulu |
| 401 | Kunci tidak ada, tidak valid, atau kedaluwarsa, anggaran bayar sesuai pemakaian diblokir, atau jatah habis | Periksa status kunci dan saldo akun |
| 402 `insufficient_balance` | Akun tidak dapat menutup pembelian; body berisi saldo dan harga | Isi saldo akun, lalu coba lagi |
| 403 | Ditolak oleh kebijakan model, rute, atau IP | Perbaiki ketidakcocokannya, misalnya [daftar IP yang diizinkan](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/) |
| 409 | Konflik dengan status akun: `mint_in_progress`, `key_limit_reached`, `credential_limit_reached`, `key_pending` | Coba ulang hanya `mint_in_progress`, dengan `request_id` yang sama |
| 413 | Permintaan terlalu besar; file transkripsi dibatasi 26.214.400 byte | Perkecil permintaannya |
| 429 | Batas laju, konkurensi, laju token, atau pengeluaran tercapai | Baca detail respons, tunggu, lalu coba ulang |
| 500 / 502 / 503 / 504 | Pemrosesan di sisi server | Coba ulang dengan exponential backoff yang dibatasi; pakai ulang `request_id` yang sama untuk pembelian kunci per jam |

Dokumentasi BroadNet meminta Anda memeriksa status HTTP sebelum mem-parse body JSON, lalu membaca kode `error` yang dapat dibaca mesin jika ada.

## Batas apa saja yang memicu 429?

Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan yang berjalan bersamaan. Menurut dokumentasi BroadNet, kunci per jam mendapat 120 permintaan per menit, satu stream, dan 300,000 token per menit. Di [paket unlimited](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/), setiap sesi menjalankan satu permintaan dalam satu waktu. Untuk membandingkan batas ini dengan OpenAI, Anthropic, Groq, dan DeepSeek, baca [rate limit API LLM per penyedia](https://broadrouter.com/id/blog/llm-api-rate-limits-by-provider/).

## Bagaimana mencoba ulang dengan OpenAI SDK?

Menurut [README-nya di GitHub](https://github.com/openai/openai-python#retries), OpenAI Python SDK sudah mencoba ulang error koneksi serta respons 408, 409, 429, dan 5xx sebanyak dua kali secara default, dengan exponential backoff singkat. Timeout default-nya 10 menit. Atur keduanya secara eksplisit (komentar di kode: `max_retries=0` mematikan percobaan ulang otomatis; `timeout` dalam detik dan sebaiknya dinaikkan untuk jawaban penalaran 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
)
```

## Bagaimana menulis backoff sendiri?

Jika Anda memanggil API tanpa SDK, batasi jumlah percobaan dan lama menunggu. Fungsi di bawah langsung mengembalikan respons jika statusnya tidak termasuk yang dicoba ulang: itu berarti sukses, atau error yang harus diperbaiki alih-alih dicoba ulang.

```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 pernah mencoba ulang 400, 403, 413, atau 422 tanpa perubahan: permintaan yang sama akan gagal dengan cara yang sama. Setiap percobaan ulang permintaan chat adalah inferensi baru dan ditagih lagi pada skema bayar sesuai pemakaian. Lihat [exponential backoff](https://broadrouter.com/id/glossary/exponential-backoff/) untuk pola umumnya.

## Mencoba ulang pembelian kunci per jam dengan aman

`POST /portal/keys/hourly` menerima `request_id`. Setelah timeout, koneksi terputus, 409 `mint_in_progress`, atau 5xx, coba ulang dengan `request_id` yang **sama**. `request_id` yang dipakai ulang tidak akan pernah membuat atau menagih kunci kedua; pengulangannya mengembalikan `already_issued: true` beserta alias kuncinya. Jangan membuat id baru sebelum Anda tahu hasil yang pertama. Selengkapnya tentang [idempotency key](https://broadrouter.com/id/glossary/idempotency-key/).

## Pemecahan masalah

-   **401 tepat setelah top up.** Halaman akun BroadNet menampilkan jatah terakhir yang tercatat dan menandai perubahan dana sebagai sedang diperbarui selama diproses. Muat ulang halaman dan coba lagi setelah selesai.
-   **429 padahal hanya beberapa permintaan per menit.** Kemungkinan Anda terkena batas konkurensi 4 permintaan, misalnya karena stream panjang yang berjalan paralel. Gunakan worker pool yang kecil.
-   **403 di satu model tetapi tidak di model lain.** Kebijakan kunci tidak mencakup model atau rute itu. Misalnya, kunci paket untuk `broadnet/deepseek-v4.1-flash`, dan kunci per jam hanya mencakup `broadnet/gemma-4-26b-a4b`.
-   **SDK mencoba ulang dan Anda ditagih dua kali.** Permintaan chat yang dicoba ulang adalah inferensi baru. Atur `max_retries=0` jika jawaban ganda lebih mahal daripada jawaban yang gagal.

## Apa yang dikirim ke tim dukungan

Sertakan nilai header `X-Request-ID`, timestamp UTC, rute, status HTTP, dan alias kunci Anda. Jangan pernah mengirim kuncinya. [Panduan OpenAI Python SDK](https://broadrouter.com/id/guides/openai-python-sdk/) menunjukkan cara membaca header tersebut.

## Istilah dalam panduan ini

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

[Exponential backoff](https://broadrouter.com/id/glossary/exponential-backoff/)

Exponential backoff adalah strategi percobaan ulang di mana client menunggu makin lama setelah setiap percobaan yang gagal, biasanya menggandakan jedanya sampai batas tertentu, sebelum mencoba lagi. Menambahkan jitter acak pada setiap jeda menyebarkan percobaan ulang dari banyak client agar tidak menghantam server pada saat yang sama.

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

Kredit prabayar adalah uang yang diisi ke akun API sebelum dipakai. Setiap request memotong biayanya dari saldo, dan saat saldo habis, request berbayar per pemakaian berhenti sampai Anda melakukan top up. Dengan begitu, pengeluaran dibatasi sebesar uang yang sudah Anda setor.

[Idempotency key](https://broadrouter.com/id/glossary/idempotency-key/)

Idempotency key adalah nilai unik, biasanya ID acak seperti UUID, yang dilampirkan klien pada request yang mengubah state, misalnya pembayaran atau pembelian. Jika request yang sama dikirim lagi dengan key yang sama, server mengembalikan hasil aslinya alih-alih menjalankan aksi itu dua kali.

[Request timeout (batas waktu permintaan)](https://broadrouter.com/id/glossary/request-timeout/)

Request timeout adalah waktu terlama sebuah client HTTP menunggu server sebelum membatalkan permintaan. Client biasanya membaginya menjadi connect timeout untuk membuka koneksi dan read timeout untuk menunggu data. Panggilan LLM memerlukan read timeout yang longgar karena jawaban panjang butuh waktu.

[Token](https://broadrouter.com/id/glossary/token/)

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

## Pertanyaan umum

### Apakah error 429 dari API LLM perlu dicoba ulang?

Ya, dengan exponential backoff yang dibatasi. Di BroadNet Inference, 429 berarti batas laju, konkurensi, laju token, atau batas pengeluaran tercapai. Kurangi paralelisme jika terus terjadi, dan hentikan percobaan ulang jika penyebabnya batas pengeluaran.

### Kenapa saya mendapat 401 padahal kunci saya benar?

Di BroadNet, 401 juga mencakup jatah bayar sesuai pemakaian yang habis atau anggaran yang diblokir, bukan hanya kunci yang salah atau kedaluwarsa. Periksa saldo akun dan status kunci di halaman akun.

### Apa bedanya 401 dan 403 di sini?

401 berkaitan dengan kunci atau jatah akun. 403 berarti kuncinya berfungsi tetapi permintaan ditolak oleh kebijakan model, rute, atau IP, misalnya panggilan dari alamat yang tidak ada di daftar IP yang diizinkan.

### Apakah OpenAI SDK mencoba ulang error secara otomatis?

Ya. Secara default OpenAI Python SDK mencoba ulang error koneksi, 408, 409, 429, dan 5xx sebanyak dua kali dengan exponential backoff singkat. Atur max\_retries untuk mengubah jumlahnya, atau 0 untuk mematikannya.

## Panduan terkait

-   [Streaming chat completions dan menangani koneksi terputus](https://broadrouter.com/id/guides/streaming-chat-completions/)
-   [Batasi kunci API ke server Anda dengan IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/)
-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)

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

**Sumber**

-   [Referensi API BroadNet Inference, error dan percobaan ulang (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-errors-and-retries&utm_content=sources#errors)
-   [Referensi API BroadNet Inference, batas (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-errors-and-retries&utm_content=sources#limits)
-   [README OpenAI Python SDK, percobaan ulang dan timeout (diperiksa 2026-11-14)](https://github.com/openai/openai-python#retries)
