Sızan bir anahtar, API faturasının kontrolden çıkmasının en yaygın yoludur. BroadNet Inference size iki kontrol sunar: IP izin listesi ve hızlı iptal.
İki tür kimlik bilgisi
| Kimlik bilgisi | Ne için kullanılır | Nasıl ele alınmalı |
|---|---|---|
| Inference anahtarı | /v1/* adresine model istekleri |
Tek bir uygulama ya da ajana ait bir sır |
| Portal kimlik bilgisi | Hesap otomasyonu: anahtarlar, izin verilen IP’ler, satın almalar | Hesap üzerinde tam yetki |
İkisi de yalnızca bir kez gösterilir. Portal yalnızca bir SHA-256 özeti saklar, bu yüzden anahtarı yeniden gösteremez. Kullandıkça öde inference anahtarı oluşturulduğu andan itibaren bir yıl geçerlidir ve bir hesapta en fazla on etkin anahtar bulunabilir.
İzin listesi tanımlayın
Hesap sayfasında her satıra bir IPv4 veya IPv6 adresi ya da CIDR aralığı ekleyin; en fazla 32 kayıt girebilirsiniz. Boş liste IP kısıtlaması olmadığı anlamına gelir. Yeni anahtarlar bu hesap listesini devralır. Edge katmanı, her API isteğinde Cloudflare’in bildirdiği istemci IP’sini kontrol eder.
Hesap listesini bir betikle yönetmek için PUT /portal/allowed_ips listeyi tek çağrıda değiştirir (portal kimlik bilgisi gerekir).
Bir anahtarı portal kimlik bilgisiyle oluştururken ona kendi listesini verebilirsiniz:
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"]}'
Anahtara özel allowed_ips, o anahtar için devralınan hesap listesinin yerini alır. Yanıt, ham anahtarı yalnızca bir kez içerir; hemen saklayın.
Sızan anahtarı hızla iptal edin
DELETE /portal/keys/{alias} bir kullandıkça öde anahtarını, DELETE /portal/keys/hourly/{alias} ise saatlik bir anahtarı iptal eder (ilk satın alma ücreti olduğu gibi kalır). Bir iptal ya da izin listesi değişikliğinden sonra yeni istekler beş saniye içinde durur.
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
KEY_ALIAS değerini, hesap sayfasında ya da GET /portal/keys çıktısında anahtar için gösterilen takma ada ayarlayın. Takma ad gizli anahtarın kendisi değildir. Bir portal kimlik bilgisi sızarsa onu DELETE /portal/credentials/{id} ile iptal edin: hesabınızın yapabildiği her şeyi yapabilir.
Sorun giderme
- Listeye eklediğiniz bir sunucudan 403. Edge katmanı sunucunun özel IP’sini değil, herkese açık çıkış adresinizi görür. NAT ağ geçidi, proxy ya da yük dengeleyici arkasındaki sunucular dışarıya o cihazın adresiyle çıkar. IPv6 desteği olan bir sunucu, yalnızca IPv4 adresini listeye eklemiş olsanız bile IPv6 üzerinden çıkabilir. İsteğin gerçekten çıktığı adresi ya da onu kapsayan bir CIDR aralığını ekleyin.
- Yeni bir anahtar hesap listesini yok sayıyor. Anahtara özel bir
allowed_ipsdizisi, o anahtar için devralınan hesap listesinin yerini alır. Oluştururken ne gönderdiğinizi kontrol edin. - 409
key_limit_reached. Hesapta zaten on etkin anahtar var. Artık kullanmadığınız birini iptal edin. - İptalden birkaç saniye sonra istekler hâlâ başarılı oluyor. Önbellek güncellenirken beş saniyeye kadar bu beklenen bir durumdur.
Listede olmayan bir adresten gelen istek 403 alır. BroadNet’in tüm hata kodları ve ne zaman yeniden denenmeli rehberine bakın. Yeni bir anahtarla ilk isteğinizi göndermek için OpenAI Python SDK rehberini izleyin. IP izin listesi sözlük maddesi kavramı genel olarak açıklar.

