TR ▾
API anahtarı al

güncellendi

DeepSeek API Anahtarı Çalışmıyor: Nedenler ve Çözümler

Bir deepseek api key not working hatası göründüğünde, asıl sorunun anahtar olması düşündüğünüzden daha az sıklıkta olur. Çoğu hata base URL'den, boş bir bakiyeden, yanlış bir model adından veya anahtarı yanlış yere gönderen bir istemciden kaynaklanır.

API anahtarı sorun giderme işlemini gösteren, yedek boru hattıyla birlikte bir boru hattında engellenmiş bir anahtarı simgeleyen görsel
SillyTavern'de API ile rol yapma sohbetini temsil eden, bir sunucuya bağlı yüzen maskeler içeren bir sahne illüstrasyonu

Tek satırlık bir testle başlayın

Uygulamanızda herhangi bir şeyi değiştirmeden önce, istemciyi devre dışı bırakmayın. Tek bir curl çağrısı, anahtarın, URL'nin ve model adının birlikte çalışıp çalışmadığını gösterir. Yer tutucuları sağlayıcınızın kontrol paneli ve belgelerindeki değerlerle değiştirin.

curl -i https://YOUR-PROVIDER/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'

-i bayrağı durum satırını ve başlıkları yazdırır ve bunlar içerikten daha önemlidir. curl çalışır ve uygulamanız çalışmazsa, hata uygulama ayarlarındadır. curl da başarısız olursa, sorun anahtar, hesap veya uç noktadadır.

Önce durum kodunu okuyun

KodYaygın anlamNe kontrol edilmeli
401Anahtar reddedildiKopyalama hataları, ekstra boşluklar, iptal edilmiş veya silinmiş anahtar, farklı bir sağlayıcıdan anahtar
402 veya bir bakiye mesajıKredi kalmadıHesap bakiyesi ve faturalandırma sayfası
404Yanlış yol veya modelTemel URL, son /v1, model adı yazımı
429Çok fazla istekDakika başına istekler, eşzamanlı istekler, yeniden dene başlıkları
5xx veya zaman aşımıSağlayıcı tarafı veya ağSağlayıcı durum sayfası, daha sonra yeniden dene, bölgesel yönlendirme

Bunlar OpenAI tarzı sağlayıcılar arasında yaygın anlamlardır. Her sağlayıcı kendi kesin kodlarını belgeler, bu yüzden detaylar için güncel dokümanlarını kontrol edin.

Anahtarın kendisi

Anahtarlar uzun dizgelerdir ve sıkıcı şekillerde bozulur. Anahtarı düz metin düzenleyiciye yapıştırın ve sona eklenmiş bir boşluk veya yeni satır, baştaki bir tırnak işareti veya bir sohbet uygulaması tarafından eklenen bir satır sonu olup olmadığını kontrol edin. Başlığın Authorization: Bearer KEY şeklinde, Bearer'dan sonra tek bir boşluk olacak şekilde yazıldığından emin olun. Anahtarı bir ortam değişkeninde ayarladıysanız, yüklendiğini doğrulamak için uygulamanızda anahtarın uzunluğunu yazdırın (değerini değil).

Başka iki durum yaygındır. İlk olarak, bir anahtar oluşturdunuz, sayfayı kapattınız ve maskelenmiş bir kopyasını kopyaladınız. Çoğu kontrol paneli bir anahtarı yalnızca bir kez gösterir, bu nedenle yeni bir anahtar oluşturun. İkinci olarak, bir hizmetten gelen bir anahtarı başka bir hizmetin URL'sine karşı kullanıyorsunuz. Bir anahtar, onu veren sağlayıcı için geçerlidir.

Bakiye, faturalandırma ve ücretsiz kredi

Çoğu API anahtarı yalnızca hesabın kredisi varken çalışır. Boş bir bakiye, kırık bir anahtar gibi görünebilir. Sağlayıcınızın faturalandırma sayfasını açın, fonlarınızın olduğundan, bir bakiye yükleme işleminin gerçekten işlediğinden ve herhangi bir promosyon kredisinin süresinin dolmadığından emin olun. Kripto ve kart yüklemeleri görünmeye birkaç dakika sürebilir.

Başka bir ön ödemeli hizmetin bunu nasıl yönettiğini karşılaştırmak isterseniz, modelimiz basittir: kredi satın alırsınız, çağrılar krediden 1M girdi token başı $0.15 ve 1M çıktı token başı $0.50 oranında düşer, başarısız veya reddedilen istekler için ücret alınmaz ve kredi asla sona ermez. Bakiyeyi GET /v1/balance ile veya her yanıtta X-Balance-USD başlığı üzerinden okuyabilirsiniz.

Temel URL ve model adı

SillyTavern, Janitor AI ve editör eklentileri gibi araçlardaki en sık görülen neden, base URL'nin biraz yanlış yazılmasıdır. Yaygın hatalar: eksik /v1, iki kez /v1/v1, http yerine https kullanımı veya zaten ekleyen bir alana tam /chat/completions yolunun yapıştırılmasıdır. Model alanı diğer tuzaktır. Sağlayıcının listelediği bir model ID'siyle eşleşmelidir. Sağlayıcı destekliyorsa GET /v1/models ile listeyin veya güncel dokümanları okuyun.

Belirli araçlar için kurulum kılavuzları bu sitede mevcuttur: SillyTavern'da anahtar kullanma, Janitor AI'da ve VS Code'da.

Hız limitleri ve eşzamanlılık

Eşzamanlı isteklerin bir patlaması, geçerli bir anahtarla bile 429 hatasına neden olabilir. Bir Retry-After başlığı arayın ve geri çekilin. Python'da minimal bir yeniden deneme şöyle görünür:

import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")

def ask(prompt):
    for attempt in range(4):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited")

Uç noktamızda tam bir anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir. Akışlı bir istek, akış bitene kadar slotunu tutar. Hata kodu rate_limited veya concurrencydir ve geçici bir aşırı yüklenme, Retry-After: 5 ile 429 döndürür.

Ağ ve bölgesel sorunlar

Eğer curl takılırsa veya sıfırlanırsa, sorun sizin ile sağlayıcı arasında olabilir: kurumsal bir proxy, VPN, DNS veya bölgesel bir blok. Farklı bir ağ deneyin, proxy'nin Authorization başlıklarını geçirdiğinden emin olun ve uzun üretimler için istemci zaman aşımınızı artırın. Akışlı yanıtlar, arabellek kullanan proxy'ler tarafından da kesilebilir; iki sorunu ayırmak için stream: false ile test edin.

Beş dakikada çalıştırabileceğiniz bir kontrol listesi

  1. curl testini çalıştırın ve durum kodunu not edin.
  2. Yeni bir anahtar oluşturun ve test edin. Yeni anahtar çalışırsa, eski anahtar yanlış kopyalanmış veya iptal edilmiştir.
  3. Kredideki bakiyeyi ve herhangi bir son kullanma tarihini kontrol edin.
  4. Temel URL ve model kimliğini sağlayıcının dokümanlarıyla karakter karakter karşılaştırın.
  5. Akışsız, araç kullanmadan ve kısa bir istemle tek bir istek gönderin. Özellikleri tek tek ekleyin.
  6. Eşzamanlı çağrıları kontrol edin. Uygulamanız aynı anda birkaç istek gönderiyorsa, eşzamanlılığı düşürün.
  7. Farklı bir ağ deneyin veya VPN'i kapatın.
  8. İstek ID'si dahil olmak üzere yanıt başlıklarına bakın. Destek ekibi bu ID'den çağrınızı bulabilir.

Beşinci adım şaşırtıcı sayıda hata bulur. Hafifçe geçersiz araç tanımları, çok büyük bir max_tokens değeri veya boyut sınırının üzerindeki bir gövde, anahtar sorunları gibi görünen hatalar döndürebilir. Uç noktamızda gövde sınırı 8 MB'tır ve her yanıt, destek için alıntılanabilecek bir X-Request-Id başlığı taşır.

Yedek bir uç nokta yapılandırın

Kesintiler ve limitler her sağlayıcıda olur, bu nedenle yapılandırmanızda ikinci bir OpenAI uyumlu uç nokta bulundurun. Bizimkisi, yasal yetişkin kullanım için içerik reddi olmadan cevap verecek şekilde ayarlanmış, barındırılan açık ağırlıklı bir modeldir. DeepSeek'in resmi API'si değildir ve bir yönlendirici de değildir; bu nedenle farklı yanıtlar ve farklı davranışlar bekleyin. Geçiş yapmak iki ayar gerektirir: base URL https://api.deepseekapikey.com/v1 ve model uncensored.

curl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Yeni kullanıcılar, API anahtarı sayfası üzerinde tek tıkla 7 gün geçerli $0,50 deneme kredisi talep edebilir. Yüklemeler kripto ile $20 ile $500 arasında yapılır; ayrıntılar için fiyatlandırma sayfası ve dokümantasyon sayfasına bakın.

Sorular ve cevaplar

Anahtarım neden curl'de çalışıyor ama uygulamamda çalışmıyor?

Uygulamanızın büyük ihtimalle yanlış base URL'si, yanlış model adı veya eski bir anahtar kopyası var. Ayarlarını çalışan curl çağrınızla karakter karakter karşılaştırın.

Geçerli bir anahtar isteklerin başarılı olacağını garanti eder mi?

Hayır. Boş bakiye, hız limiti veya bilinmeyen bir model adı, mükemmel bir anahtarla bile başarısızlıkla sonuçlanabilir.

Farklı bir sağlayıcıyla aynı kodu kullanabilir miyim?

Her ikisi de OpenAI uyumluysa evet. Base URL'yi, anahtarı ve model ID'sini değiştirin.

Sizin uç noktanız DeepSeek ile aynı modeli mi kullanıyor?

Hayır. Bağımsız bir sağlayıcı tarafından işletilen açık ağırlıklı bir modeldir ve herhangi bir satıcının resmi API'si değildir.

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.

API anahtarı al