DeepSeek-V4-Flash API Yayında: Resmi API Nasıl Kullanılır (Açık Beta Kılavuzu)

DeepSeek bu sabah resmi DeepSeek-V4-Flash API'sini yayınladı. Duyuru 31 Temmuz 2026'da yapıldı ve sürüm notları üç şeyi netleştiriyor: modelin ajan yetenekleri ciddi bir yükseltme aldı, artık OpenAI'nin Yanıtlar API'si formatını doğal olarak destekliyor ve ilk günden itibaren Codex ile çalışıyor.

Nisan ayından beri deepseek-v4-flash çağırıyorsanız, önizleme sürümünü kullanıyordunuz. Bu sürüm, modeli resmi versiyonu DeepSeek-V4-Flash-0731'e taşıyor ve tek bir kod satırı değiştirmeden yükseltmeyi alırsınız. Model adı aynı kalıyor.

Bu kılavuz her şeyi adım adım açıklıyor: bir anahtar edinme, ilk çağrınızı yapma, düşünme modunu açıp kapatma ve genel beta fiyatlandırmasının nasıl olduğunu. DeepSeek ürün yelpazesine yeniyseniz, aileye genel bir bakış için DeepSeek V4 Nedir? ile başlayın, sonra buraya geri dönün.

31 Temmuz'da Gerçekte Neler Yayınlandı

Resmi değişiklik günlüğüne göre, sürüm yalnızca API'yi kapsıyor. DeepSeek uygulaması ve web modelleri değişmedi, V4-Pro API'si de değişmedi. İşte özet:

• DeepSeek-V4-Flash-0731, V4-Flash serisinin resmi sürümüdür, şu anda API'de genel beta sürümündedir.
• V4-Flash-Preview ile aynı mimari ve boyut. DeepSeek, modelin yalnızca yeniden eğitildiğini belirtiyor, bu nedenle kazançlar daha büyük bir ağdan değil, eğitimden geliyor.
• Ajan kıyaslamaları V4-Pro-Preview'u geride bıraktı. DeepSeek, Terminal Bench 2.1'i 82.7, Cybergym'i 76.7, Toolathlon'u 70.3 olarak doğrulanmış ve DeepSWE'yi 54.4 olarak rapor ediyor. Bunlar DeepSeek'in kendi yayınladığı sayılar olup, kendi test düzenekleriyle azami çabayla test edilmiştir.
• Yerel Yanıtlar API desteği ve resmi Codex entegrasyonu. Her ikisini de DeepSeek-V4-Flash artık Yanıtlar API'sini ve Codex'i destekliyor başlıklı yazımızda derinlemesine ele alıyoruz.
• Değişiklik günlüğüne göre DeepSeek-V4-Pro'nun resmi sürümü “yakında çıkacak”. V4-Pro için Yanıtlar API'si ve Codex desteğinin Ağustos 2026 başlarında gelmesi bekleniyor.

Dürüst olmak gerekirse: başlıktaki kıyaslama iddiası ("V4-Pro-Preview'u fazlasıyla aşıyor") DeepSeek'in kendi değerlendirmesinden geliyor ve listelenen kıyaslamalardan ikisi (DSBench-FullStack ve DSBench-Hard) dahili test setleridir. Bağımsız verilerin ortaya çıkması birkaç gün sürecektir.

Adım 1: API anahtarınızı alın

DeepSeek Platformu'na gidin, oturum açın ve API Anahtarları sayfasından bir anahtar oluşturun. Anahtarlar sk- ile başlar. Sabit kodlamak yerine bir ortam değişkeni olarak saklayın:

export DEEPSEEK_API_KEY="sk-anahtarınız-buraya"

DeepSeek API hem OpenAI hem de Anthropic API formatlarıyla uyumludur, bu nedenle DeepSeek'e özel bir SDK'ya ihtiyacınız yoktur. İki temel URL önemlidir:

Adım 2: İlk çağrınızı yapın

En hızlı sağlık kontrolü curl'dur:

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Summarize what changed in DeepSeek-V4-Flash-0731."}
    ],
    "stream": false
  }'

OpenAI Python SDK aracılığıyla aynı çağrı:

# pip3 install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Write a Python function that validates an email address."}
    ],
    stream=False
)

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

Ve Node.js:

// npm install openai
import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.deepseek.com",
  apiKey: process.env.DEEPSEEK_API_KEY,
});

const completion = await openai.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(completion.choices[0].message.content);

deepseek-v4-flash model adı artık 0731 sürümünü işaret ettiği için, önizlemeye karşı oluşturduğunuz mevcut entegrasyonlar yeni modeli otomatik olarak algılar. Taşınacak hiçbir şey yok.

Adım 3: Düşünme modunu ve muhakeme çabasını kontrol edin

V4-Flash hem düşünmesiz modu hem de düşünme modunu destekler ve düşünme varsayılandır. Bunu `thinking` parametresiyle kontrol eder ve derinliği `reasoning_effort` ile ayarlayabilirsiniz:

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Plan a database migration from MySQL to Postgres."}],
    reasoning_effort="high",
    extra_body={"thinking": {"type": "enabled"}}
)

Parametreleri ayarlamadan önce bilmeniz gereken iki davranış:

• `temperature` ve `top_p` düşünme modu açıkken etkisizdir.
• FIM tamamlaması (ortayı doldurma, hala beta) yalnızca düşünmesiz modda çalışır.

Otomatik tamamlama gibi gecikmeye duyarlı uç noktalar için düşünmeyi devre dışı bırakın. Ajan döngüleri ve zor hata ayıklama görevleri için açık tutun ve çaba seviyesini artırın.

Adım 4: Yanıtı yayınlayın

`stream: true` olarak ayarlayın ve API sunucu tarafından gönderilen olayları döndürür. Daha önce SSE yüklerinde hata ayıklamadıysanız, sunucu tarafından gönderilen olaylarla LLM yanıtlarını yayınlama kılavuzumuz formatı ayrıntılı olarak açıklar.

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Explain connection pooling."}],
    stream=True
)

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

Genel beta sırasındaki fiyatlandırma

Resmi Modeller ve Fiyatlandırma sayfasına göre, V4-Flash agresif bir şekilde ucuz kalıyor:

Üç fiyatlandırma notu:

• Bağlam önbelleğe alma otomatiktir ve bir önbellek isabeti, ıskalamadan 50 kat daha az maliyetlidir. Bir sistem istemini yeniden kullanan uzun süreli ajan oturumları büyük ölçüde fayda sağlar.
• DeepSeek bir yoğun/yoğun olmayan saat politikası duyurdu: yoğun saat kullanımı (Pekin saatiyle 9:00-12:00 ve 14:00-18:00) normal fiyatların 2 katı olarak faturalandırılacaktır. 31 Temmuz itibarıyla belgelerde yürürlük tarihinin “resmi duyuruya tabi” olduğu belirtiliyor, bu nedenle henüz aktif değil. Fiyatlandırma sayfasını takip edin.
• Eşzamanlılık limiti kendi hikayesini anlatıyor: Flash için 2.500 eşzamanlı istek, Pro için ise 500. DeepSeek bu modeli ajan filoları tarafından yoğun bir şekilde kullanılması için tasarladı.

V4 ailesindeki maliyetin tam tablosu için, V4-Pro kalıcı fiyat indirimi geçmişi dahil olmak üzere, DeepSeek V4 API fiyatlandırma analizimize bakın.

Apidog'da API'yi test edin ve hata ayıklayın

Ham curl bir basit test için işe yarar, ancak düşünme ile düşünmesiz çıktıları karşılaştırdığınızda veya modelin araç çağrılarını nasıl akıttığını izlediğinizde, görünürlük istersiniz. İşte Apidog'da yaklaşık beş dakika süren bir iş akışı:

1. Bir proje oluşturun ve uç noktayı ekleyin. POST https://api.deepseek.com/chat/completions ekleyin (veya tüm uç noktaların bir kerede gelmesi için OpenAI uyumlu bir belirtim içe aktarın).
2. Anahtarı bir ortam değişkeni olarak saklayın. DEEPSEEK_API_KEY'i bir Apidog ortamına yerleştirin ve Yetkilendirme başlığında Bearer {{DEEPSEEK_API_KEY}} olarak referans verin. Bir test anahtarı ile bir üretim anahtarı arasında geçiş yapmak, açılır menüye tıklamayla mümkün olur.
3. Gönderin ve inceleyin. Akış çağrıları için Apidog, SSE olaylarını geldikçe işler, böylece ham data: satırları duvarına bakmak yerine, muhakeme içeriğini ve yanıt içeriğini ayrı deltalar olarak geldiğini izleyebilirsiniz.
4. Varyantları test senaryoları olarak kaydedin. Düşünme modu etkin olan bir kaydedilmiş isteği ve düşünme modu olmayan bir isteği tutun, ardından her model güncellemesinden sonra her ikisini de yeniden çalıştırın. DeepSeek, deepseek-v4-flash'a bir sonraki sessiz yükseltmeyi yayınladığında, istemlerinizin hala beklendiği gibi çalışıp çalışmadığını tek bir tıklamayla öğreneceksiniz.

Apidog'u ücretsiz indirin, yukarıdaki tüm akış ücretsiz planda çalışır.

SSS

Yeni modeli almak için kodumu değiştirmem gerekiyor mu? Hayır. deepseek-v4-flash model adı artık DeepSeek-V4-Flash-0731'i sunuyor. Mevcut entegrasyonlar otomatik olarak yükseltilir.

Bu, DeepSeek uygulamasıyla aynı model mi? Hayır. 31 Temmuz güncellemesi yalnızca API'yi kapsar. Uygulama ve web modelleri değişmemiştir.

deepseek-chat ve deepseek-reasoner'a ne oldu? Bu eski model adlarının 24 Temmuz 2026'da kullanımdan kaldırılması planlanıyordu. deepseek-v4-flash veya deepseek-v4-pro kullanın. DeepSeek V4 API'sini nasıl kullanacağınız hakkındaki kılavuzumuz geçişi kapsar.

Ücretsiz kullanabilir miyim? DeepSeek'in API'si kalıcı ücretsiz katmanı olmayan, kullandıkça öde modeliyle çalışır, ancak önbellek isabeti fiyatlandırması uygulamada denemeleri neredeyse ücretsiz hale getirir. Mevcut seçenekler için DeepSeek V4 API'sini ücretsiz nasıl kullanacağınızı görün.

V4-Flash, Codex ve Yanıtlar API'si ile çalışıyor mu? Evet, her ikisiyle de çalışıyor ve şu ana kadar bunu yapan tek DeepSeek modelidir. V4-Pro desteğinin Ağustos 2026 başlarında gelmesi bekleniyor. Tam kurulumu Yanıtlar API'si ve Codex kılavuzumuzda bulabilirsiniz.

Sonuç

DeepSeek-V4-Flash-0731 sessiz bir sürüm: aynı model adı, aynı fiyatlar, aynı mimari ve en azından DeepSeek'in kendi testlerinde daha büyük V4-Pro-Preview'u geride bırakan bir dizi ajan kıyaslama puanı. Yanıtlar API desteği ve Codex adaptasyonu, bu modelin hedeflendiği yeri işaret ediyor: her Batılı laboratuvarı alt eden fiyatlarla yüksek eşzamanlı ajan iş yükleri.

Bir anahtar alın, OpenAI SDK'nızı https://api.deepseek.com adresine yönlendirin ve kıyaslama tablosuna güvenmeden önce modeli kendi test paketinizden geçirin. Apidog bu doğrulama döngüsünü hızlandırır: istemlerinizi bir kez test senaryosu olarak kaydedin, her model güncellemesinde yeniden çalıştırın ve bir daha asla sessiz bir yükseltme karşısında şaşırmayın.