---
title: "Hadkan kunci API LLM kepada IP pelayan anda | BroadRouter"
description: "Lindungi kunci BroadNet Inference dengan senarai IP dibenarkan, asingkan kunci inferens daripada kelayakan portal dan batalkan kunci bocor dalam beberapa saat."
url: https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/
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/guides/api-keys-ip-allow-lists/) (dikemas kini 2026-11-16).

# Kunci API kepada pelayan anda dengan senarai IP dibenarkan

Dikemas kini 2026-11-16

Tambah alamat IPv4 atau IPv6 keluar (egress) atau julat CIDR pelayan anda ke senarai dibenarkan akaun, sehingga 32 entri. Kunci baharu mewarisi senarai itu melainkan anda menghantar allowed\_ips semasa menciptanya. Permintaan dari alamat lain menerima 403, dan perubahan senarai atau pembatalan kunci berkuat kuasa dalam lima saat.

Kunci yang bocor ialah punca paling biasa bil API melambung. BroadNet Inference memberi anda dua kawalan: senarai IP dibenarkan (IP allow-list) dan pembatalan (revoke) yang pantas.

## Dua jenis kelayakan

| Kelayakan | Gunakan untuk | Anggap sebagai |
| --- | --- | --- |
| Kunci inferens | Permintaan model ke `/v1/*` | Rahsia untuk satu aplikasi atau ejen |
| Kelayakan portal | Automasi akaun: kunci, IP dibenarkan, pembelian | Kuasa penuh ke atas akaun |

Kedua-duanya dipaparkan sekali sahaja. Portal hanya menyimpan cincangan SHA-256, jadi ia tidak boleh memaparkan kunci itu lagi. Kunci inferens bayar ikut guna sah selama setahun dari tarikh dicipta, dan satu akaun boleh memegang sehingga sepuluh kunci aktif.

## Tetapkan senarai dibenarkan

Di halaman akaun, tambah satu alamat IPv4 atau IPv6 atau julat CIDR bagi setiap baris, sehingga 32 entri. Senarai kosong bermakna tiada sekatan IP. Kunci baharu mewarisi senarai akaun ini. Edge menyemak IP klien yang dilaporkan oleh Cloudflare pada setiap permintaan API.

Untuk mengurus senarai akaun daripada skrip, `PUT /portal/allowed_ips` menggantikannya dalam satu panggilan (memerlukan kelayakan portal).

Beri satu kunci senarainya sendiri semasa anda menciptanya dengan kelayakan portal:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

`allowed_ips` per kunci menggantikan senarai akaun yang diwarisi bagi kunci itu. Respons mengandungi kunci mentah sekali sahaja; simpan dengan segera.

## Batalkan kunci yang bocor dengan pantas

`DELETE /portal/keys/{alias}` membatalkan kunci bayar ikut guna, dan `DELETE /portal/keys/hourly/{alias}` membatalkan kunci sejam (caj pembelian asal kekal). Selepas pembatalan atau perubahan senarai dibenarkan, permintaan baharu berhenti dalam lima saat.

```bash
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
```

Tetapkan `KEY_ALIAS` kepada alias yang dipaparkan bagi kunci itu di halaman akaun atau dalam `GET /portal/keys`. Alias bukan kunci rahsia. Jika kelayakan portal bocor, batalkannya dengan `DELETE /portal/credentials/{id}`: ia boleh melakukan semua yang boleh dilakukan oleh akaun anda.

## Penyelesaian masalah

-   **403 dari pelayan yang telah anda senaraikan.** Edge melihat alamat keluar awam anda, bukan IP peribadi pelayan. Pelayan di belakang get laluan NAT, proksi atau pengimbang beban keluar melalui alamat peranti itu. Pelayan yang mempunyai IPv6 mungkin keluar melalui IPv6 walaupun anda hanya menyenaraikan alamat IPv4nya. Senaraikan alamat sebenar yang digunakan oleh permintaan untuk keluar, atau julat CIDR yang meliputinya.
-   **Kunci baharu mengabaikan senarai akaun.** Tatasusunan `allowed_ips` per kunci menggantikan senarai akaun yang diwarisi bagi kunci itu. Semak apa yang anda hantar semasa menciptanya.
-   **409 `key_limit_reached`.** Akaun sudah mempunyai sepuluh kunci aktif. Batalkan satu yang tidak lagi digunakan.
-   **Permintaan masih berjaya beberapa saat selepas pembatalan.** Ini dijangka sehingga lima saat sementara cache dikemas kini.

Permintaan dari alamat yang tiada dalam senarai menerima 403. Lihat [semua kod ralat BroadNet dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/). Untuk membuat permintaan pertama dengan kunci baharu, ikuti [panduan OpenAI Python SDK](https://broadrouter.com/ms/guides/openai-python-sdk/). [Entri glosari senarai IP dibenarkan](https://broadrouter.com/ms/glossary/ip-allow-list/) menerangkan konsep ini secara umum.

_[image: A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."]_

## Istilah dalam panduan ini

[Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/)

Kunci API ialah rentetan rahsia yang mengenal pasti dan membenarkan klien yang memanggil sesuatu API. API LLM biasanya menjangkakannya dalam pengepala Authorization: Bearer, dan sesiapa yang memegang kunci itu boleh membuat permintaan yang dibilkan kepada akaun pemiliknya.

[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.

[Baris Arab (tashkeel, Arabic diacritics)](https://broadrouter.com/ms/glossary/arabic-diacritics/)

Baris Arab, atau tashkeel, ialah tanda kecil yang ditulis di atas atau di bawah huruf untuk menunjukkan vokal pendek, konsonan berganda dan ketiadaan vokal. Ia pilihan: kebanyakan teks Arab, termasuk berita, meninggalkannya, jadi pembaca dan perisian meneka vokal daripada konteks.

[Senarai IP dibenarkan (IP allow list)](https://broadrouter.com/ms/glossary/ip-allow-list/)

Senarai IP dibenarkan ialah kawalan keselamatan yang hanya menerima permintaan daripada alamat IP atau julat CIDR yang disenaraikan dan menolak yang lain. Pada API, ia mengehadkan kerosakan akibat kunci yang bocor, kerana kunci itu tidak berfungsi dari rangkaian yang tiada dalam senarai.

## Soalan lazim

### Bagaimanakah saya mengehadkan kunci API LLM kepada alamat IP pelayan saya?

Tambah alamat keluar awam pelayan, atau julat CIDR, ke senarai dibenarkan akaun di halaman akaun BroadNet, atau hantar allowed\_ips semasa mencipta kunci melalui POST /portal/keys. Permintaan dari alamat lain ditolak dengan 403.

### Adakah senarai dibenarkan yang kosong menyekat semua?

Tidak. Senarai kosong bermakna tiada sekatan IP, jadi kunci berfungsi dari mana-mana alamat. Tambah sekurang-kurangnya satu entri untuk menghidupkan sekatan.

### Bolehkah saya menggunakan kunci inferens untuk mencipta kunci lain?

Tidak. Kunci inferens hanya memanggil laluan model /v1/\*. Mencipta dan membatalkan kunci, menukar IP dibenarkan dan membeli kunci sejam memerlukan kelayakan portal, yang membawa kuasa penuh ke atas akaun.

### Berapa cepatkah pembatalan kunci yang bocor berkuat kuasa?

Dokumentasi BroadNet menyatakan permintaan baharu berhenti dalam lima saat selepas pembatalan atau perubahan senarai dibenarkan, kerana keputusan kebenaran boleh kekal dalam cache yang direplikasi selama itu.

## Panduan berkaitan

-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [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-api-keys-ip-allow-lists&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API BroadNet Inference, senarai IP dibenarkan (disemak 2026-11-16) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [Rujukan API BroadNet Inference, kunci sejam dan kelayakan portal (disemak 2026-11-16) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [Rujukan API BroadNet Inference, had (hayat kunci dan kunci aktif) (disemak 2026-11-16) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
