TR ▾
API anahtarı al

cURL ve Bearer Token ile OpenAI Tarzı API

Komut satırından OpenAI tarzı bir API çağırmak için, tokenınızı taşıyan bir Authorization başlığı içeren bir HTTP POST gönderirsiniz. Bu sayfa, API'nin her özelliği için çalışan cURL komutlarını ve bir hata oluştuğunda çalıştırmanız gereken kontrolleri sağlar.

güncellendi

Terminal penceresi, bir sunucuya altın anahtar ve veri paketlerini ışık şeridi üzerinden gönderiyor

Temel noktalar

  • Token, Authorization: Bearer YOUR_KEY başlığında yer alır ve model ID'si uncensored'dır.
  • İki uç nokta vardır: GET /v1/models ve POST /v1/chat/completions.
  • Tokenların sunucu tarafından gönderilen olaylar üzerinden geldiğini görmek için -N ve stream true ekleyin.
  • X-Balance-USD ve hız limiti başlıklarını curl -i ile okuyun; 429 yanıtı bekleme ve yeniden deneme anlamına gelir.

Minimal istek

Bu hizmete OpenAI API cURL ile token kullanarak erişmenin en kısa yolu şudur. Anahtarı ortam değişkenine yerleştirin, böylece kabuk geçmişinize düşmez; ardından bir sohbet mesajı gönderin:

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

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

Yanıt, OpenAI sohbet tamamlama formatında JSON'dur. Cevap choices[0].message.content konumundadır ve bir usage nesnesi istem ve tamamlama tokenlarını bildirir. Komutun her parçasının bir görevi vardır:

  • Authorization: Bearer ... tokenı taşır. "Bearer" şema adıdır; tokenı elinde tutan kişi, onun sahibi olarak kabul edilir, bu yüzden onu halka açık depolarda tutmamanız önemlidir.
  • Content-Type: application/json sunucuya gövdenin nasıl okunacağını söyler. Bu olmadan istek genellikle bir gövde ayrıştırma hatası ile başarısız olur.
  • model değeri uncensored olmalıdır; bu API'nin sunduğu tek model budur.
  • messages, bir role (system, user, assistant veya tool) ve content içeren nesnelerden oluşan bir listedir.

Anahtar almak için Google veya e-posta ve şifre ile kayıt olun, ardından API anahtarı sayfasını kullanın. Yeni kullanıcılar tek tıkla $0.50 değerinde ücretsiz deneme kredisi talep edebilir: kart gerekmez, 7 gün geçerlidir, kişi başı bir kez.

Anahtarı GET /v1/models ile kontrol edin

Uzun bir isteği hata ayıklamadan önce, tokenın en ucuz çağrı ile çalıştığını doğrulayın. Modelleri listelemek ücretsizdir ve URL'nin, başlığın ve anahtarın doğru olup olmadığını gösterir.

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

İyi bir yanıt, uncensored içeren bir JSON listesidir. jq yüklüyse, yalnızca kimlikleri çıkarmak için pipe operatörünü kullanarak çıktıyı bağlayın:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Faydalı bir şey dönmüyorsa, nedenler oluşma sıklıklarına göre listelendiğinden aşağıdaki listeyi sırayla takip edin:

  1. Değişken boştur. Tüm anahtarı yazdırmadan ilk karakterleri görmek için echo "${UF_KEY:0:6}" çalıştırın.
  2. Başlık yanlış yazılmış veya anahtardan önce "Bearer" eksik.
  3. Bir belgeden veya sohbet istemcisinden gelen kıvrık tırnaklar, komuttaki düz tırnakları değiştirdi.
  4. Base URL yanlış. Base URL https://api.unfilteredaimodels.com/v1 şeklindedir; önünde api. ve sonunda /v1 bulunur.
  5. Anahtar kopyalanırken sonuna boşluk veya yeni satır karakteri eklenmiş.

Yanıt başlıklarını okuyun

Başlıkları çıktıya eklemek için -i ekleyin veya gövdeyi temiz tutarken yazdırmak için -D - kullanın:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

Bilmeniz gereken dört yanıt başlığı vardır:

BaşlıkAnlamı
X-Request-IdBu istek için tanımlayıcı. Destek ile iletişime geçtiğinizde bu kimliği tırnak içinde belirtin.
X-Balance-USDKalan ön ödemeli krediniz.
X-RateLimit-Limit-RequestsAnahtarınız için dakikada izin verilen istek sayısı.
X-RateLimit-Limit-ConcurrencyAnahtarınız için eşzamanlı izin verilen istek sayısı.

Sınırlar tam anahtar için dakikada 300 istek ve 8 eşzamanlı istek, deneme anahtarı için ise dakikada 60 ve 2 eşzamanlı istektir. Yukarıdaki istek, testi küçük tutmak için max_tokens değerini 5 olarak ayarlar. Normal kullanımda max_tokens isteğe bağlıdır ve tamamlama, isteminizden sonra 100.000 tokenlık pencerede kalanı kullanabilir.

Komut satırından akış

"stream": true ayarlayın ve -N ekleyin, böylece curl çıktısını arabelleğe almaz. data: ile başlayan satırlar göreceksiniz; her biri küçük bir JSON parçası taşır ve son data: [DONE] gelir. Önceki parça token kullanımını içerir.

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

Yalnızca metni yazdırmak için akışı kısa bir boru hattıyla filtreleyin:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

Akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar. Bir betikten paralel olarak çok sayıda akış başlatır ve tamamlanmalarını beklemeyi unutursanız, istek hızı düşük olsa bile eşzamanlılık sınırına takılırsınız.

JSON modu ve araç çağrıları

JSON modu, modelin tek bir geçerli JSON nesnesi döndürmesini sağlar. İstediğiniz şekli istemde belirtin, aksi halde anahtarlar modelin seçtiği şey olur.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

Araç çağırma, standart tools ve tool_choice alanlarını kullanır. Model, metin yerine bir tool_calls dizisiyle yanıt verir; fonksiyonu kendiniz çalıştırırsınız ve sonucu role: "tool" ve eşleşen tool_call_id ile bir mesaj olarak geri gönderirsiniz.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

Yanıttan choices[0].message.tool_calls[0].function.arguments değerine bakın. Bu, ayrıştırmanız, kendi hava durumu fonksiyonunuzu çağırmanız ve bir sonraki istekte döndürmeniz gereken bir JSON dizgesidir. temperature, top_p, stop, seed ve cezalar gibi parametreler iletilir. dokümantasyon desteklenen tüm alanları listeler.

Tokenı güvende tutun ve komutları düzenli tutun

Bir bearer token, farklı bir adla şifredir. Ona sahip olan herkes kredinizi harcayabilir, bu yüzden aynı özenle davranın. Gerçek bir anahtarı asla genel bir sorunda, bir ekran görüntüsünde veya paylaşılan bir terminal günlüğünde yapıştırmayın. Bir anahtarın sızdığını düşünüyorsanız, anahtar sayfasından değiştirin ve betiklerinizi güncelleyin.

Kabuk geçmişi, kişisel bir makinede en yaygın sızma yoludur. Anahtarı doğrudan bir komuta yazmak, onu geçmiş dosyasına kaydeder. export ile bir kez ayarlamak bile bu satırı kaydeder. İki daha temiz alışkanlık yardımcı olur. Anahtarı yalnızca sizin okuyabileceğiniz bir dosyadan okuyun veya kabuğunuz boşlukla başlayan satırları yok sayacak şekilde ayarlanmışsa komutu bir boşlukla başlatın. Küçük bir dosya iyi çalışır:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

Uzun JSON gövdeleri tek tırnak içinde okunması zordur ve istemin kendisi bir kesme işareti içerdiğinde tırnaklama bozulur. Gövdeyi bir dosyaya koyun ve curl'un -d @file ile okumasını sağlayın:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

Aynı yaklaşım, büyük istemleri 8 MB gövde sınırında yönetilebilir kılar ve bir dosya git'te sürümlendirilebilirken anahtar depodan dışarıda kalır. Windows PowerShell'de JSON etrafındaki tek tırnaklar farklı davranır ve ters eğik çizgi satır devamı yoktur; -d @request.json biçimi bu iki sorunu önler ve bir komutu devam ettirmek için bir satırın sonunda ters tırnak (backtick) kullanabilirsiniz.

Testler bittiğinde bir SDK'ya geçin. OpenAI Python ve Node kütüphaneleri aynı Base URL ve anahtarı kabul eder, yeniden denemeleri ve akışı sizin için yönetir ve burada elle ayrıştırdığınız aynı yanıt formatını okur. cURL komutları, bir hatanın kodunuzdan mı yoksa istekten mi kaynaklandığını kontrol etmenin en hızlı yolu olmaya devam eder, bu yüzden bilinen iyi birini notlarınızda tutun. Bir sorunu destek ekibine bildirdiğinizde, başarısız çağrının X-Request-Id'sini ve kesin durum kodunu ekleyin; bu çift, testi tekrar etmenizi istemeden isteği bulmalarını sağlar ve bir iletişim döngüsünden tasarruf sağlar.

Hatalar, yeniden denemeler ve çağrı başına maliyet

Bir limiti aştığınızda API HTTP 429 yanıtı verir. Hata kodu hangi limiti aştığınızı söyler: rate_limited dakikada çok fazla istek anlamına gelir, concurrency aynı anda çok fazla istek anlamına gelir. Geçici bir aşırı yüklenme de 429 döndürür ve Retry-After: 5 ekler. Curl, geçici hatalar için kendi başına yeniden deneyebilir:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Ayrıca gövdeyi 8 MB altında tutun, bu, isteme dosyalar eklerseniz önemlidir.

Başarısız veya reddedilen istekler için ücret alınmaz. Başarılı olanlar basit bir formülü izler: 1M girdi tokenı başına $0.15 ve 1M çıktı tokenı başına $0.50. 40 girdi tokenı ve 120 çıktı tokenı ile bir test çağrısı 40 / 1.000.000 x $0.15 = $0.000006 artı 120 / 1.000.000 x $0.50 = $0.00006 maliyetinde olur, yani toplam $0.000066 eder. Bin tanesi $0.066 eder.

Kredi ön ödemelidir ve süresi dolmaz. Yüklemeler $20 ile $500 arasında tam miktarlarda yapılır; $50'den itibaren %5, $100'den itibaren %10 ve $200'den itibaren %15 bonus uygulanır. Ödeme kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile yapılabilir. fiyatlandırma sayfası detayları gösterir. Bir yanıt yanlış görünüyorsa, mitler ve gerçekler sayfası modelin ne yapıp ne yapmadığını açıklar.

Sorular ve cevaplar

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

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

Token, bir cURL komutunda nereye yerleştirilir?
    Bir başlıkta: -H "Authorization: Bearer YOUR_KEY". İstek gövdesine ayrıca Content-Type: application/json başlığı da eklenmelidir.
Hangi model adını kullanmalıyım?
    Sansürsüz modeli kullanın. GET /v1/models ile bunu doğrulayabilirsiniz.
Neden 429 yanıtı alıyorum?
    Bir limite ulaştınız. rate_limited kodu dakikada çok fazla istek anlamına gelir, concurrency ise aynı anda çok fazla istek anlamına gelir. Birkaç saniye bekleyin veya eşzamanlı çağrı sayısını azaltın.
Kalan kredimi nasıl görebilirim?
    Her yanıt bir X-Balance-USD başlığı içerir. Başlıkları curl -i veya curl -D - ile yazdırın.
Bu, resmi OpenAI API'si mi?
    Hayır. Bağımsız bir OpenAI uyumlu hizmettir ve tek bir açık ağırlıklı model çalıştırır; bu nedenle Base URL ve anahtarı değiştirdikten sonra OpenAI formatı için geliştirilmiş SDK'lar ve cURL komutları çalışır.