TR ▾

AI API Anahtarını curl ve Python ile Test Etme

Başarılı bir API anahtarı testini temsil eden üç yeşil gösterge ışığı olan bir kilitte dönen anahtar

AI API anahtarı erişimini test etmenin yolu, hiçbir şey oluşturmadan üç istek göndermek, yaklaşık iki dakika sürer ve anahtarın geçerli, bakiyeli ve metin oluşturmasına izin verilip verilmediğini anlarsınız.

güncellendi

Temel noktalar

  • İlk olarak GET /v1/models çağrısı yapın: bu, krediden harcamadan anahtarın kabul edildiğini kanıtlar.
  • Oluşturmanın çalıştığını onaylamak için uncensored modeline kısa bir sohbet isteği gönderin.
  • Ne kadar kaldığını görmek için X-Balance-USD başlığını okuyun veya GET /v1/balance çağrısı yapın.
  • 401 anahtara, 402 bakiyeye, 429 istek hızınıza işaret eder.

Üç çağrı testi

Bir AI API anahtarını düzgün test etmek için üç ayrı şeyi kanıtlamanız gerekir: sunucunun anahtarı kabul etmesi, anahtarın arkasında kredi olması ve gerçek bir tamamlamanın dönmesi. Her soru için bir istek, teşhisi basit tutar. Bir şey başarısız olursa hangi katmanın sorumlu olduğunu bilirsiniz.

  1. Model listesi. Anahtarı doğrular ve hiçbir şey maliyetmez.
  2. Sohbet tamamlama. Modelin yanıt verdiğini ve istek formatınızın doğru olduğunu doğrular.
  3. Bakiye. Testten sonra ne kadar kaldığını doğrular.

Aşağıdakilerin hepsi base URL https://api.aiapisource.com/v1 ve model ID uncensored kullanır. Anahtarınızı bir ortam değişkenine koyun, böylece kabuk geçmişinize veya bir depoya karışmaz.

export AIAPI_KEY="paste-your-key-here"

Henüz anahtarınız yoksa, API anahtarı sayfası nasıl oluşturulacağını gösterir. Yeni hesaplar tek tıkla $0,50 deneme kredisi talep edebilir; bu makaledeki her test için yeterlidir.

Adım 1: curl ile model listesini alın

En ucuz kontrol salt okunur bir istektir. GET /v1/models model listesini döndürür ve geçerli bir anahtar gerektirir, bu nedenle başarılı bir yanıt kimlik doğrulamayı kanıtlar.

curl -s https://api.aiapisource.com/v1/models \
  -H "Authorization: Bearer $AIAPI_KEY"

Sağlıklı bir yanıt, uncensored içeren bir data dizisi içeren JSON'dur. Bir HTML sayfası, bağlantı hatası veya boş yanıt görürseniz sorun URL'dedir, anahtar değil. /v1 sonekini koruduğunuzdan ve değişkeninizdeki anahtardan sonra boşluk bırakmadığınızdan emin olun.

Yanıt başlıklarını görmek için curl komutuna -i ekleyin. API her çağrıda X-Request-Id gönderir. Bu değeri destek ile iletişime geçtiğinizde saklayın, çünkü tam isteği tanımlar.

Adım 2: bir sohbet isteği gönderin

Şimdi oluşturmayı kontrol edin. İstemi küçük tutun ve çıktıyı sınırlandırın, böylece test bir kuruşun çok küçük bir kısmına mal olur.

curl -s https://api.aiapisource.com/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the single word: ready"}],
    "max_tokens": 10
  }'

choices[0].message.content ve prompt_tokens ile completion_tokens içeren bir usage nesnesi arayın. Yaklaşık 20 giriş tokenı ve 5 çıktı tokenı içeren bir istek, 20 / 1.000.000 x $0,15 artı 5 / 1.000.000 x $0,50 maliyetinde olup bu yaklaşık $0,0000055 eder. Yüz tanesini bir kuruştan ucuza çalıştırabilirsiniz.

Aynı uç nokta akış için de çalışır: "stream": true ekleyin ve tokenlar sunucu tarafından gönderilen olaylar olarak gelir. Temel çağrı çalıştıktan sonra bunu ayrı olarak test edin.

Adım 3: Python ile aynı test

Gerçek kodunuz bir OpenAI SDK kullanıyorsa, testleri SDK üzerinden de yapın. curl'ün yakalamayacağı sorunları yakalar, örneğin base URL'nin yanlış argümana geçirilmesi.

import os
from openai import OpenAI

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

print([m.id for m in client.models.list().data])

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

İlk yazdırma, uncensored içeren bir liste göstermelidir. İkinci model yanıtını gösterir. SDK kurulumu hakkında daha uzun bir rehber için bu sitedeki OpenAI API Python kılavuzu'ne bakın.

Python sürümünü anahtarı dışa çıkardığınız aynı kabukta çalıştırın. Eğer AIAPI_KEY üzerinde KeyError yükseltirse, değişken o oturumda ayarlanmamıştır; bu, testin ağa ulaşmadan önce başarısız olmasının en yaygın nedenidir.

Node aynı şekilde çalışır: OpenAI istemci yapıcısına baseURL: "https://api.aiapisource.com/v1" ve anahtarı geçirin.

Bakiyeyi kontrol et

Bir anahtar geçerli olabilir ve harcamaya hiçbir şeyi olmayabilir. Bakiyeyi okumanın iki yolu:

curl -s https://api.aiapisource.com/v1/balance \
  -H "Authorization: Bearer $AIAPI_KEY"

# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $AIAPI_KEY"

Her yanıt ayrıca X-Balance-USD başlığını taşır, bu nedenle adım 2'deki sohbet çağrısı, onu -i ile çalıştırdıysanız kalan krediyi zaten göstermiştir. Python'da OpenAI SDK bunu client.chat.completions.with_raw_response.create(...) üzerinden sunar, burada response.headers["X-Balance-USD"] okursunuz.

Başarısız veya reddedilen istekler için ücret alınmaz, bu nedenle hata veren bir test krediyi yemez. Ön ödemeli kredi süresi dolmaz, bu da kullanılmamış bakiyenin gelecek hafta hala orada olacağı anlamına gelir.

Hata kodlarını okuma

Bir test başarısız olduğunda, HTTP durumu nedeni hızla daraltır.

DurumGenel anlamNe yapılmalı
401Anahtar eksik, yanlış yazılmış veya iptal edilmişAuthorization: Bearer başlığını kontrol edin, anahtarı tekrar kopyalayın, gizli boşluklar veya tırnaklar arayın
402İsteği ödemek için kalan kredi yokBakiyeyi okuyun, ardından fiyatlandırma sayfasında bakiye yükleyin.
404Yanlış yol veya yanlış model ID/v1/chat/completions ve model uncensored kullanın
429Hız veya eşzamanlılık limiti veya kısa aşırı yüklenmeBekleyin ve tekrar deneyin; aşağıya bakın

429 bir hata kodu taşır. rate_limited dakikada çok fazla istek gönderildiğini, concurrency ise aynı anda çok fazla istek gönderildiğini gösterir. Tam bir anahtar dakikada 300 istek ve 8 eşzamanlı istek yapabilir; deneme anahtarı dakikada 60 ve aynı anda 2 istek yapabilir. Geçici aşırı yük durumunda API, 429 yanıtı ile Retry-After: 5 başlığını döndürür, bu nedenle beş saniye bekleyin ve isteği tekrar gönderin. Akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar; bu, deneme anahtarının paralel testler sırasında limite takılmasının yaygın bir nedenidir.

401, 402 ve 404 durum kodları normal API kurallarını izler, bu nedenle tabloyu bir ilk tahmin olarak ele alın ve tam mesaj için JSON hata gövdesini okuyun.

Yeniden kullanılabilir smoke-test betiği

Manuel test geçtiğinde, anahtarları döndürdüğünüzde veya ortamları değiştirdiğinizde çalıştırabileceğiniz bir betik tutun.

import os, sys
import requests

BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}

m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)

c = requests.post(
    BASE + "/chat/completions",
    headers=H,
    json={"model": "uncensored",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 5},
    timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)

Çıkış kodu, bir dağıtım kontrolüne entegre olmayı kolaylaştırır. Bu minimumun ötesindeki parametreler için API dokümantasyonu uç noktanın kabul ettiği her şeyi listeler.

Sorular ve cevaplar

API anahtarını test etmek para mı tutar?

Modeller listesi ücretsizdir. Düşük max_tokens ile kısa bir sohbet isteği, 1M giriş tokenı başına $0,15 ve 1M çıkış tokenı başına $0,50 fiyatla bir doların birkaç milyonda biri tutarındadır. Başarısız istekler için ücret alınmaz.

Kart olmadan bir API anahtarını nasıl test ederim?

Giriş yaptıktan sonra API anahtarı sayfasından $0,50 deneme kredisi talep edin. Kart gerektirmez ve 7 gün boyunca geçerlidir, kişi başı bir kez alınabilir.

Geçerli bir anahtar neden hemen 429 hatası döndürür?

Büyük olasılıkla eşzamanlılık veya dakika başına hız limitine takıldınız. Deneme anahtarları 2 eşzamanlı istek ve dakika başına 60 istek izni verir; tam sürüm anahtarlar 8 ve 300 izni verir. Hata kodunu kontrol edin, ardından birkaç saniye bekleyip yavaşlayın veya yeniden deneyin.

API anahtarını curl yerine Postman'de veya bir uygulamada test edebilir miyim?

Evet. Herhangi bir OpenAI uyumlu istemci çalışır: base URL'yi https://api.aiapisource.com/v1 olarak ayarlayın, anahtarı Bearer token olarak yapıştırın ve uncensored modelini kullanın.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın, base URL'yi değiştirin. Kurulumun tamamı bu kadar.

API anahtarı al