DeepSeek-V4.1-Flash bugün, 10 Eylül 2026 tarihinde API'de Genel Kullanıma (GA) sunuldu. Sürüm notu kısa olsa da DeepSeek API'sini çağıran herkes için üç şeyi değiştiriyor: bundan böyle kullanılacak tek bir model kimliği var, `deepseek-flash`; token başına ücretler tekrar düştü; ve dört gün sonra, 14 Eylül'de, `deepseek-v4-pro`'ya yapılan her istek bu modele yönlendirilecek ve Flash fiyatlarından faturalandırılacak.
Bu kılavuzun var olma nedeni bu son nokta. Eğer V4-Pro üzerinde üretim kodunuz varsa, bir geçiş tarihi seçemezsiniz. Eğer V4-Flash kullanıyorsanız, zaten eski adıyla yeni model tarafından hizmet alıyorsunuz demektir. Her iki durumda da, bugün gönderdiğiniz parametreleri kontrol etmekte fayda var.
Bu yazı pratik tarafı ele alıyor: model kimliği, temel URL'ler, üç dilde ilk çağrı, muhakeme çabası, görsel girişi, yayın (streaming) ve fiyatlandırma. Mimari ve kıyaslama hikayesi için önce DeepSeek-V4.1-Flash Nedir'i okuyun.
Koda herhangi bir şey bağlamadan önce, istekleri hızlı bir şekilde göndermek ve yanıtları karşılaştırmak için kolay bir yol isteyeceksiniz. Apidog bunu halleder: onu `https://api.deepseek.com` adresine yönlendirin, anahtarı bir değişken olarak saklayın ve çalışan her çağrıyı tekrar çalıştırılabilir bir test olarak kaydedin. İş akışı sona yaklaşıyor.
Kısaca
- Model kimliği: `deepseek-flash`. Eski adlar `deepseek-v4-flash` ve `deepseek-v4-flash-vision-exp` hala çalışıyor ancak V4.1-Flash'a çözümleniyor.
- Temel URL'ler değişmedi: `https://api.deepseek.com` (OpenAI uyumlu) ve `https://api.deepseek.com/anthropic` (Anthropic uyumlu).
- `deepseek-v4-pro`, 14 Eylül 2026 TSİ 04:00'te V4.1-Flash'a yönlendirilecek.
- Bağlam 1M token, maksimum çıktı 384K, eşzamanlılık sınırı 2.500.
- Yoğun olmayan saatlerde 1M token başına fiyatlandırma: önbellek isabeti 0,003 $, önbellek kaçırma 0,15 $, çıktı 0,60 $. Yoğun saatlerde iki katı.
- Görsel yereldir. Görseller `content` dizisine `image_url` parçaları olarak girer.
API Çağıranlar İçin Neler Değişti?
İşte sürüm notundan ve değişiklik günlüğünden alınan farklar.
Tek model kimliği. Kanonik ad artık `deepseek-flash`, içinde sürüm yok. İsteklerinizi ve testlerinizi bir sürüm dizesine değil, davranışa sabitleyin, çünkü bir sonraki Flash sürümü aynı ad altında yayınlanacak.
Eski adlar hala yönlendiriliyor. `deepseek-v4-flash` ve `deepseek-v4-flash-vision-exp` şimdilik kabul ediliyor, ancak arkalarındaki modeller olan V4-Flash ve V4-Flash-Vision-Exp kullanımdan kaldırıldı. Bu adlara yapılan istekler V4.1-Flash tarafından sunuluyor. Hiçbir şey bozulmaz, ancak düşündüğünüz modeli çalıştırmıyorsunuz. Mümkün olduğunda yeniden adlandırın.
Beta adı kalktı. 8 Eylül'den itibaren iki günlük beta `deepseek-v4.1-flash-expires-on-0910` olarak çalıştı. Söz verildiği gibi süresi doldu. `deepseek-flash`'a geçin.
Temel URL'ler ve formatlar değişmedi. OpenAI uyumlu çağrılar `https://api.deepseek.com` adresine, Anthropic uyumlu çağrılar `https://api.deepseek.com/anthropic` adresine gider ve Flash serisinin zaten desteklediği Yanıtlar API formatı aynen devam eder. SDK yapılandırmanız hareket etmez.
V4-Pro'nun dört günü var. 14 Eylül 2026 TSİ 04:00'ten (Pekin saatiyle 12:00) itibaren, her `deepseek-v4-pro` isteği V4.1-Flash'a yönlendirilecek ve V4.1-Flash ücretleri üzerinden faturalandırılacak. DeepSeek'in belirttiği neden, V4.1-Flash'ın "performans, maliyet, hız ve toplam süre açısından V4 Pro'yu kapsamlı bir şekilde geride bırakması" ve birçok tarafın testlerini referans göstermesidir. Bu bir satıcı iddiasıdır. V4-Pro kullanım dışı bırakma geçiş kılavuzu, geçiş sizin için gerçekleşmeden önce kendi istemleriniz üzerinde bunu nasıl kontrol edeceğinizi gösterir.
Adım 1: Bir Anahtar Alın
DeepSeek platformuna giriş yapın, API Anahtarlarını açın ve bir anahtar oluşturun. Anahtarlar `sk-` ile başlar. Kaynağa yapıştırmak yerine dışa aktarın:
export DEEPSEEK_API_KEY="sk-anahtarınız-burada"
DeepSeek'e özgü bir SDK'ya gerek yoktur. Temel URL'yi değiştirdikten sonra hem OpenAI hem de Anthropic istemci kütüphaneleri çalışır.
Adım 2: İlk Çağrınızı Yapın
Önce curl, çünkü API'nin kendisi dışındaki her değişkeni ortadan kaldırır:
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-d '{
"model": "deepseek-flash",
"messages": [
{"role": "system", "content": "You are a support engineer for a payments API."},
{"role": "user", "content": "A customer gets HTTP 402 on /v1/charges. List the three most likely causes."}
],
"stream": false
}'
Aynı çağrı OpenAI Python SDK'sı aracılığıyla:
# pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{"role": "system", "content": "Bir ödeme API'si için destek mühendisisin."},
{"role": "user", "content": "Bir müşteri /v1/charges üzerinde HTTP 402 alıyor. En olası üç nedeni listele."},
],
)
print(response.choices[0].message.content)
Ve Node:
// npm install openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek.com",
apiKey: process.env.DEEPSEEK_API_KEY,
});
const completion = await client.chat.completions.create({
model: "deepseek-flash",
messages: [
{ role: "user", content: "Faturalara boş geçilebilir refunded_at zaman damgası ekleyen bir Postgres geçişi yaz." },
],
});
console.log(completion.choices[0].message.content);
Eğer önceki sürüme V4-Flash API kılavuzunu takip ederek kurulum yaptıysanız, tek fark model dizgisidir.
Adım 3: Muhakeme Çabası ve Düşünme Modu
Model kartı, muhakeme çabasını 1'den 100'e kadar "sürekli kontrol edilebilir" olarak tanımlar. Bu, çoğu API'nin sunduğu düşük/orta/yüksek ön ayarlardan bir ayrılıştır ve katman başına değil, uç nokta başına maliyeti ve gecikmeyi ayarlayabileceğiniz anlamına gelir.
Bu 1'den 100'e kadar olan değeri taşıyan parametre şekli API belgelerine göre [DOĞRULANACAKTIR]. Onaylayana kadar, V4-Flash modelinden başlayın: `reasoning_effort` artı `extra_body` aracılığıyla iletilen bir `thinking` nesnesi:
response = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "Redis kümemiz yük altında SET'lerin %2'sini düşürüyor. Araştırmayı planla."}],
reasoning_effort="high",
extra_body={"thinking": {"type": "enabled"}},
)
Model kartından önerilen örnekleme ayarları: `temperature` 1.0, `top_p` 0.95 veya 1.0 ve uzun muhakeme izleri için 256K veya daha fazla `max_tokens`. Maksimum çıktı 384K tokendir.
Pratik bir ayrım: otomatik tamamlama, sınıflandırma ve kullanıcının beklediği her şey için düşünme kapalı; ajan döngüleri, çok dosyalı refaktörler ve hata ayıklama için yüksek çabayla düşünme açık. Sonra ölçün. Çıktıda göremediğiniz çaba, yine de ödediğiniz çabadır.
Adım 4: Bir Görsel Gönderin
V4.1-Flash doğal olarak çok modludur, sıfırdan eğitilmiş bir DeepSeek-ViT kodlayıcı ile 45T-token'lık çok modlu bir korpus üzerinde eğitilmiştir. İstek formatı V4-Flash-Vision-Exp'ten devralınmıştır: görseller, kullanıcı mesajı `content` dizisinin parçalarıdır.
response = client.chat.completions.create(
model="deepseek-flash",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Bu makbuzdaki her bir satır öğesini ve toplamı JSON olarak çıkar."},
{"type": "image_url", "image_url": {"url": "https://cdn.example-shop.com/receipts/48213.png"}},
],
}],
)
Yerel bir dosya için, onu base64 veri URL'si olarak kodlayın:
import base64
with open("receipt.png", "rb") as f:
data_url = "data:image/png;base64," + base64.b64encode(f.read()).decode()
# sonra image_url kısmında {"url": data_url} olarak iletin
Sınırlar: 32 MiB'ye kadar base64 veri URL'leri, 8,192 karaktere kadar harici URL'ler veya bir dosya kimliği. İsteğe bağlı bir `detail` alanı kabul edilir. DeepSeek, yukarıdaki belge okuma durumu olan DocVQA 95.6'yı rapor eder. Görsel API kılavuzu çoklu görsel istemlerini, detay seviyelerini ve görsellerin istek başına maliyetini kapsar.
Adım 5: Yanıtı Yayınlayın (Stream Edin)
`stream=True` olarak ayarlayın ve uç nokta sunucu tarafından gönderilen olayları döndürür. Muhakeme içeriği ve yanıt içeriği ayrı delta olarak gelir; bu, bir kullanıcı arayüzünde "düşünme" durumunu işlerken önemlidir.
stream = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "Idempotency anahtarlarını bir paragrafta açıkla."}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta
if delta.content:
print(delta.content, end="", flush=True)
Eğer SSE sizin için yeniyse, sunucu tarafından gönderilen olayları kullanarak LLM yanıtlarını yayınlama tel formatını ve yeniden bağlantı kenar durumlarını açıklar.
Fiyatlandırmaya Bir Bakış
Resmi fiyatlandırma sayfasından, 10 Eylül 2026 TSİ 04:00'ten itibaren, 1M token başına USD olarak:
| deepseek-flash yoğun olmayan saatler | deepseek-flash yoğun saatler | |
|---|---|---|
| Girdi, önbellek isabeti | 0,003 $ | 0,006 $ |
| Girdi, önbellek kaçırma | 0,15 $ | 0,30 $ |
| Çıktı | 0,60 $ | 1,20 $ |
Bilmeniz gereken üç şey:
- Yoğun saatler Pazartesi'den Cuma'ya, TSİ 01:00 - 04:00 ve 06:00 - 10:00 (Pekin saatiyle 9:00 - 12:00 ve 14:00 - 18:00). Yoğun olmayan saatler yarı fiyatınadır. Bekleyebilecek toplu işler beklemelidir.
- Önbellek isabetleri otomatiktir. Bir isabet, bir kaçırmadan 50 kat daha az maliyetlidir, bu nedenle her isteğin başında istikrarlı bir sistem istemi mevcut en ucuz optimizasyondur. İstem önbellekleme nedir, önek eşleşmesinin nasıl çalıştığını açıklar.
- V4-Flash'a kıyasla, önbellek isabetli girişte yaklaşık %57, önbellek kaçıran girişte %32 ve çıktıda %9 kesinti var. 14 Eylül'de yönlendirilen bir V4-Pro iş yükü, yoğun saatlerde 1M önbellek kaçıran girdi başına 1,32 $ yerine 0,30 $ ve çıktı için 3,96 $ yerine 1,20 $ öder.
API'yi Apidog'da Test Edin
İlk çağrı çalıştıktan sonra, soru bunun çalışmaya devam edip etmeyeceğidir. `deepseek-flash` bir sürüm taşımadığından, bir sonraki yükseltme sessiz olacaktır. İşte bunu yakalayan bir Apidog iş akışı:
- Uç noktayı ekleyin. `POST https://api.deepseek.com/chat/completions` oluşturun veya her rotanın bir kerede gelmesi için OpenAI uyumlu bir OpenAPI spesifikasyonu içe aktarın.
- Anahtarı bir ortam değişkeni olarak saklayın. `DEEPSEEK_API_KEY` değerini bir Apidog ortamına koyun ve başlığı `Bearer {{DEEPSEEK_API_KEY}}` olarak ayarlayın. Kişisel bir anahtar ile üretim anahtarı arasında geçiş bir açılır menü haline gelir.
- Çaba seviyesi başına bir istek kaydedin. Temel isteği varyantlara kopyalayın: düşünme kapalı, düşük çabayla düşünme açık, yüksek çabayla düşünme açık. Aynı istem, farklı parametreler. Üçünü de gönderin ve token kullanımını ve gecikmeyi yan yana karşılaştırın.
- Yayını izleyin. `stream: true` için Apidog, SSE olaylarını geldikleri gibi işler, böylece muhakeme deltaları ve içerik deltaları, bir `data:` önekleri duvarı yerine ayrı satırlar olarak görünür.
- Varyantları bir test senaryosuna dönüştürün. Durum kodu, ikinci çalıştırmada `usage` içindeki önbellek isabet sayısının sıfırdan büyük olması ve yanıtın uygulamanızın ayrıştırdığı alanları içermesi üzerine iddialar ekleyin. Her model güncellemesinden sonra ve V4-Pro yönlendirmesi 14 Eylül'de canlıya geçtiğinde senaryoyu tekrar çalıştırın.
- CI'da çalıştırın. `apidog-cli` aynı senaryoyu bir işlem hattından yürütür, böylece sessiz bir model değişikliği, bir müşteri yerine bir derlemenin başarısız olmasına neden olur.
Apidog'u indirin ve tüm kurulum yaklaşık on dakika sürer.
Sıkça Sorulan Sorular
`deepseek-v4-flash` adını `deepseek-flash` olarak yeniden adlandırmak zorunda mıyım? Bugün değil. Eski ad hala V4.1-Flash'a yönlendiriliyor. Ancak V4-Flash'ın kendisi kullanımdan kaldırıldı ve DeepSeek takma adın ne zaman kaldırılacağını söylemedi. Bir sonraki dağıtımınızda yeniden adlandırın.
14 Eylül'de V4-Pro koduma ne olacak? Hiçbir şey bozulmaz. `deepseek-v4-pro`'ya yapılan istekler V4.1-Flash tarafından yanıtlanacak ve TSİ 04:00'ten itibaren Flash fiyatlarından faturalandırılacak. Ancak çıktılarınız değişebilir, bu yüzden o tarihten önce değerlendirme setinizi çalıştırın. Geçiş kılavuzunda bir kontrol listesi bulunmaktadır.
Anthropic uyumlu uç nokta yeni modeli destekliyor mu? Evet. `https://api.deepseek.com/anthropic` değişmedi; orada da model adı olarak `deepseek-flash` kullanın.
Ücretsiz bir katman var mı? API, kalıcı ücretsiz bir katman olmaksızın kullandıkça öde esasına göre çalışır. Kendi kendine barındırmak isterseniz ağırlıklar Hugging Face'de MIT lisanslıdır. Mevcut seçenekler DeepSeek V4 API'sini ücretsiz kullanma konusunda toplanmıştır.
Ne kadar hızlı? DeepSeek, saniyedeki token sayısını yayınlamadı. Bir X kullanıcısı video testlerinde "neredeyse 400 t/s" bildirdi, bu bir anekdot, bir özellik değil. Yoğun bir pencerede kendi istemleriniz üzerinde ölçüm yapın.
Yeniden Yönlendirmeden Önce
API yüzeyi neredeyse hiç değişmedi: aynı temel URL'ler, aynı istek formatı, bir yeni model kimliği. Değişen şey fiyat ve 14 Eylül'de her V4-Pro çağrısının yönlendirilmesi. `deepseek-v4-flash` adını `deepseek-flash` olarak yeniden adlandırın, uç nokta başına bir çaba seviyesi seçin ve DeepSeek sizin için yapmadan önce istemlerinizi yeni modelden geçirin.
Bu arada bu istemleri test olarak kaydedin. Apidog bunları tek tıklamayla yeniden çalıştırır ve bir sonraki sessiz Flash yükseltmesi, bir destek bileti yerine başarısız bir onaylama olarak ortaya çıkar.