DeepSeek V4 API Kullanıcı Kılavuzu

1. Kayıt ve Kimlik Doğrulama

DeepSeek V4 API, geçiş maliyetlerini önemli ölçüde azaltan ve geliştiricilerin mevcut AI ekosistem araçlarıyla sorunsuz bir şekilde entegre olmalarını sağlayan OpenAI SDK ile uyumludur.

API Anahtarı Alma

1. DeepSeek Platformunu ziyaret edin.
2. Sağ üst köşedeki "API Keys" -> "Create new secret key" seçeneğine tıklayın.
3. Not: Anahtar oluşturulduktan sonra yalnızca bir kez görüntülenir, bu nedenle güvenli bir şekilde kaydedin.

2. Hızlı Başlangıç (Python Örneği)

İlk olarak, resmi OpenAI SDK'sını yükleyin (evet, doğru okudunuz, sadece OpenAI SDK'sını kullanın):

pip install openai

Ardından, sadece iki parametreyi değiştirin: base_url ve api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # DeepSeek API Anahtarınız
    base_url="https://api.deepseek.com"  # Kilit nokta!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # Model adı, V4 sürümünden sonra farklılık gösterebilir
    messages=[
        {"role": "system", "content": "You are a helpful AI assistant."},
        {"role": "user", "content": "Hello, please introduce DeepSeek V4."},
    ],
    stream=False
)

print(response.choices[0].message.content)

3. Gelişmiş Özellikler

3.1 Akış Çıktısı (Streaming Output)

Kullanıcı deneyimini geliştirmek için, kullanıcıların daktilo benzeri bir üretim efekti görmesini sağlayan akış çıktısını etkinleştirmeniz önerilir.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Write a long poem about whales"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 İşlev Çağırma (Function Calling)

DeepSeek V4, JSON parametrelerini tam olarak ayrıştırabilen güçlü İşlev Çağırmayı destekler ve bu da onu Ajanlar (Agents) oluşturmak için ideal hale getirir.

3.3 JSON Modu

Modelin geçerli JSON formatı çıktısı vermesi gerekiyorsa, response_format içinde json_object belirtmeyi ve istemde açıkça JSON çıktısı talep etmeyi unutmayın.

4. Fiyatlandırma ve Maliyet Optimizasyonu

DeepSeek V4 fiyatlandırması son derece uygundur (belirli fiyatlar resmi duyuru bekleniyor, V3'e 0,14 $/M jeton olarak bakın). Daha fazla para biriktirmek için:

• İstem Önbelleğe Alma (Prompt Caching): V4, bir bağlam önbelleğe alma mekanizması sunar. Sistem İsteminiz uzunsa (örneğin, bilgi tabanı), sonraki istekler önbellek isabetleri nedeniyle önemli ölçüde daha az maliyetli olacaktır.
• Bağlamı Düzenleyin: İlgisiz sohbet geçmişini içine doldurmayın.

5. En İyi Uygulamalar

• Hata Yönetimi: Özellikle rate_limit_exceeded (429) hataları için üstel geri çekilme yeniden deneme stratejisiyle try-except uyguladığınızdan emin olun.
• Zaman Aşımı Ayarları: Karmaşık akıl yürütme görevleri daha uzun üretim süreleri gerektirebilir, bu nedenle zaman aşımını 60 saniye veya daha fazlasına ayarlayın.
• Sistem İstemi: V4'e net bir "kişilik" (persona) verin ve daha iyi performans gösterecektir.

Sorun mu yaşıyorsunuz? API Dokümantasyonumuzu kontrol edin veya yardım için Discord topluluğuna katılın.