AI API Anahtarı Test Aracı: Bir Anahtarı 30 Saniyede Kontrol Edin

Neden web sayfası yerine yerel olarak test edilmeli

Bir AI API anahtarı test sayfası aradığınızda, anahtar yapıştırıp düğmeye basabileceğiniz birçok sayfa çıkar. Bunlardan kaçının. Bir anahtar, paranızı harcayan bir şifredir ve böyle bir sayfanın anahtarla ne yaptığını bilemezsiniz. Aşağıdaki testler yarım dakika sürer, kendi makinenizde çalışır ve anahtarı yalnızca kullanmak istediğiniz API'ye gönderir.

Üç şeye ihtiyacınız var: anahtar, https://api.getaiapikey.com/v1 base URL ve uncensored model ID. Anahtarı ortam değişkenine yerleştirin, böylece kabuk geçmişinde veya commit edebileceğiniz bir dosyada yer almaz.

Copyexport API_KEY="paste-your-key-here"

Anahtarlar API anahtarı sayfası üzerinden gelir. Henüz bir tane yoksa, yeni kullanıcılar kayıt olduktan sonra tek tıkla orada $0,50 değerinde ücretsiz deneme kredisi talep edebilir; bu, bu makaledeki her test için birkaç kez yeterli olacaktır.

Kontrol 1: curl ile modelleri listele

En ucuz test model listesidir. Geçerli bir anahtar ve doğru base URL gerektirir ve herhangi bir metin üretmez.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

-i bayrağı yanıt başlıklarını yazdırır. Sağlıklı bir yanıt HTTP/2 200 ile başlar ve uncensored model kimliğini içeren bir JSON gövdesi içerir. Bunun yerine bir kimlik doğrulama hatası (genellikle 401 durumu) görürseniz anahtar yanlış, kopyalanırken sonuna boşluk eklenmiş veya başlıkta Bearer kelimesi eksiktir. 404 hatası URL'nin yanlış olduğunu, çoğunlukla eksik veya çift /v1 olduğunu gösterir.

Kontrol 2: gerçek bir tamamlama çalıştır

Bir anahtar geçerli olabilir ancak gerçek bir istekte başarısız olabilir, örneğin bakiye boşsa. Bu nedenle küçük bir sohbet çağrısı gönderin ve maliyeti sıfıra yakın tutmak için çıktıyı sınırlayın:

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

Gövdeden önce başlıkları okuyun. X-Request-Id isteği tanımlar; destek ekibi bunu ister. X-Balance-USD kalan krediyi gösterir. X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency anahtarınızın hız limitlerini ortaya koyar: tam anahtar için 300 ve 8, deneme anahtarı için 60 ve 2. Bu tek istek bu nedenle kimlik doğrulamayı, modeli, bakiyeyi ve anahtar türünü kontrol eder.

Testin fiyatı ihmal edilebilir düzeydedir. Yaklaşık 10 tokenluk bir istem ve 5 tokenluk bir yanıt, 10 x $0,15 / 1M + 5 x $0,50 / 1M tutarındadır, bu da yaklaşık $0,000004 eder. Başarısız veya reddedilen istekler için hiç ücret alınmaz.

Kontrol 3: Python ile aynı test

Gerçek kodunuz Python kullanıyorsa, kodunuzun çalışacağı şekilde test edin. Bu betik resmi openai paketini kullanır, bu nedenle burada başarılı olmak uygulamanızın kurulumunun da çalıştığını gösterir:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

with_raw_response sarmalayıcısı başlıklara erişim sağlar, parse() ise normal yanıt nesnesini döndürür. Python kurulumu Python'da bir LLM istemcisi nasıl kurulur sayfasında kapsanmıştır, eğer içe aktarma başarısız olursa.

Tamamlama olmadan bakiyenizi kontrol edin

Metin oluşturmadan bakiyeyi okumak için bakiye uç noktalarından birini çağırın. Bir OpenAI tarzı uç nokta ve bir kısa uç nokta vardır:

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

OpenAI kredi-verme formatını zaten bekleyen araçlar ikinci yolu olduğu gibi kullanabilir. Bu çağrıyı bir izleme betiğine ekleyin ve üretim botu kuruduğundan önce uyarı alırsınız. Bakiye yükleme işlemleri $20'den başlar ve kredi hiç sona ermez, bu nedenle rahat bir rezerv tutmanın cezası yoktur. Tutarlar ve bonuslar fiyatlandırma sayfasında yer alır.

Testi bir sağlık kontrolüne dönüştürün

Anahtar çalıştıktan sonra testi saklayın. Belirli bir aralıkta çalışan küçük bir betik, kullanıcılarınız fark etmeden önce kötü bir dağıtım, süresi dolmuş gizli anahtar veya düşük bakiye konusunda sizi bilgilendirir. İşte yerleşik fetch kullanan bir Node sürümü (Node 18 veya üzeri):

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

İstek başarısız olursa veya bakiye 5 $'ın altına düşerse betik sıfırdan farklı bir kodla sonlanır, böylece bir cron işi veya CI adımı sizi uyarabilir. Eşiği kendi yakma hızınıza göre seçin: Günde 2 $ harcarsanız, 5 $ size iki günden biraz daha fazla uyarı süresi verir.

Geçen bir testin kanıtlamadığı şeyler

Yeşil onay, auth, yönlendirme ve modelin o anda düşük yükte çalıştığını gösterir. Uygulamanızın aynı anda 20 kullanıcıyla nasıl davrandığını göstermez. Bunun için sınırları aklınızda tutun: tam anahtar aynı anda 8 isteği işler ve akış istekleri, akış bitene kadar slotlarını korur. Lansmandan önce paralel istekler için bir sınır koyarak kendi kodunuzu yük testi ile test edin.

Hataları okuma

Ne görürsünüz	En olası neden	Ne yapılmalı
Kimlik doğrulama hatası, genellikle 401	Yanlış anahtar, ekstra boşluk, Bearer öneki yok	Anahtarı yeniden kopyalayın, başlık dizgesini kontrol edin
JSON yerine 404 veya HTML	Yanlış temel URL	Tam olarak https://api.getaiapikey.com/v1 kullanın
Model bulunamadı	İstekte farklı model kimliği	model alanını uncensored olarak ayarlayın
429 hatası rate_limited veya concurrency ile	Dakikada veya aynı anda çok fazla istek	Bekleyin, ardından gecikme ile yeniden deneyin
429 ile Retry-After: 5	Geçici aşırı yüklenme	5 saniye bekleyin ve yeniden deneyin
Bağlantı veya zaman aşımı hatası	Ağ, proxy veya güvenlik duvarı	Başka bir ağdan test edin, proxy değişkenlerini kontrol edin

8 MB'ın üzerindeki istekler reddedilir; bu nedenle yalnızca büyük istekler başarısız olursa gövde boyutunu kontrol edin. dokümantasyon tüm hata kodlarını ve başlıkları listeler.

Bir anahtarı yönetmek için iyi alışkanlıklar

• Anahtarı ortam değişkeninde veya gizli depolamada tutun, istemci tarafı kodunda, genel bir depoda veya bir ekran görüntüsünde değil.
• Mümkünse uygulama başına bir anahtar kullanın, böylece bir sızıntıyı izlemek ve değiştirmek kolay olur.
• Bir anahtarın sızmış olabileceğini düşünüyorsanız, onu değiştirin ve ardından beklenmeyen harcamalar için bakiyeye bakın.
• Deneme anahtarını birden fazla program arasında paylaşmayın: 2 eşzamanlı istekle hız limitlerine çabuk ulaşılır.

Sadece kayıt olmadan önce ücretsiz bir seçeneğin var olup olmadığını görmek istiyorsanız, ücretsiz LLM API anahtarı hakkındaki makale nelerin mevcut olduğunu açıklar. Aksi takdirde, yukarıdaki üç kontrol, bir anahtarın test etmesi için gereken her şeydir.

Daha fazla kılavuz

• AI API Anahtarı Fiyatlandırması: Bir Anahtar Gerçekte Ne Kadar Tutar
• AI API Kontrol Listesi