DeepSeek API nasıl kullanılır? Anahtar, ilk istek ve maliyet kaydı

DeepSeek API'ye ilk istek nasıl gönderilir? Adım adım

DeepSeek API’ye ilk istek altı adımda gönderilir: hesap ve bakiye, API anahtarı, ortam değişkeni, istek, yanıt kaydı ve maliyet hesabı. DeepSeek’in belgelerine göre API, OpenAI ve Anthropic biçimleriyle uyumlu olduğu için bu iki şirketin SDK’ları yalnız adres ve anahtar değiştirilerek kullanılabiliyor.

1. Hesap ve bakiye: platform.deepseek.com’da hesap açın. DeepSeek SSS’sine göre bakiye “Top Up” sayfasından PayPal, banka kartı, Alipay ya da WeChat Pay ile yükleniyor; yüklenen bakiyenin süresi dolmuyor ve kullanılmayan tutar iade edilebiliyor.
2. API anahtarı: Platformdaki API keys sayfasından anahtar oluşturun. SSS, anahtarı kimseyle paylaşmamayı ve tarayıcıda ya da istemci tarafı kodda açıkta bırakmamayı öneriyor.
3. Ortam değişkeni: Anahtarı koda yazmak yerine DEEPSEEK_API_KEY adlı ortam değişkenine koyun.
4. İstek: Adres https://api.deepseek.com, model deepseek-flash.
5. Yanıt kaydı: Cevap metniyle birlikte usage alanını saklayın.
6. Maliyet hesabı: Token sayılarını birim fiyatlarla çarpın (aşağıdaki şablon).

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": "Türkçe yaz. Notlarda olmayan bilgiyi ekleme."},
      {"role": "user", "content": "Bu ürün notlarından kısa bir ürün açıklaması yaz: ..."}
    ],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high",
    "stream": false
  }'

Aynı istek OpenAI’ın Python SDK’sıyla:

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["DEEPSEEK_API_KEY"], base_url="https://api.deepseek.com")
yanit = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Türkçe yaz. Notlarda olmayan bilgiyi ekleme."},
        {"role": "user", "content": "Ürün notları: ..."},
    ],
    reasoning_effort="high",
    extra_body={"thinking": {"type": "enabled"}},
)
print(yanit.choices[0].message.content)
print(yanit.usage)  # prompt_cache_hit_tokens, prompt_cache_miss_tokens, completion_tokens

Benzer bir anahtar alma ve koruma akışını OpenAI için OpenAI API anahtarı nasıl alınır yazısında anlattık.

DeepSeek API'de hangi model adı hangi iş için kullanılır?

DeepSeek API’de 18 Ekim 2026’da iki model adı geçerli: görsel girdi de alan deepseek-flash ve yalnız metinle çalışan deepseek-v4-pro. İkisi de 1 milyon token bağlamı ve “thinking” (düşünme) modunu destekliyor; düşünme varsayılan olarak açık.

Özellik	deepseek-flash	deepseek-v4-pro
Model sürümü	DeepSeek-V4.1-Flash-1017	DeepSeek-V4-Pro-0813
Görsel girdi	Var	Yok
Hesap başına eşzamanlı istek sınırı	2.500	500
JSON çıktı, araç çağrısı, Responses API, Anthropic API	Var	Var
FIM (ortadan doldurma) tamamlama	Yalnız düşünmesiz modda (beta)	Yalnız düşünmesiz modda (beta)

Düşünme yoğunluğu low, high ve max olarak seçiliyor; DeepSeek’in 13 Ağustos 2026 notu basit işler için low, günlük ajan işleri için high, karmaşık senaryolar için max öneriyor. Eski deepseek-v4-flash ve deepseek-v4-flash-vision-exp adlarına gelen istekler V4.1-Flash-1017’ye yönlendiriliyor ve Flash fiyatından ücretleniyor. Modellerin ürün tarafındaki karşılığı DeepSeek nedir yazısında.

DeepSeek API maliyet kaydı nasıl tutulur?

DeepSeek API maliyeti, önbellek isabeti, önbellek ıskası ve çıktı token’larının ayrı birim fiyatlarla çarpılıp toplanmasıyla bulunur; birim fiyat ayrıca isteğin yoğun saatte mi, sakin saatte mi geldiğine göre değişir. Formül:

Maliyet (dolar) = (isabet token × isabet fiyatı + ıska token × ıska fiyatı + çıktı token × çıktı fiyatı) ÷ 1.000.000

Fiyat belgesine göre yoğun saatler hafta içi 01:00–04:00 ve 06:00–10:00 UTC’dir (Çin resmî tatilleri hariç); bu, Türkiye saatiyle 04:00–07:00 ve 09:00–13:00 demektir. Sakin saat fiyatları yoğun saat fiyatlarının yarısıdır. Güncel birim fiyatların tamamı DeepSeek fiyatlandırması yazısında.

Tarih ve saat (UTC)	Model	Yoğun saat mi?	İsabet token	Iska token	Çıktı token	Hesaplanan maliyet
(yanıt zamanı)	deepseek-flash	Evet / Hayır	(usage)	(usage)	(usage)	(formül)

Bu yazıyı hazırlarken API’ye ücretli istek göndermedik; tablo boş bir şablondur ve sayfanın altındaki CSV dosyası olarak da indirilebilir. Aynı Türkçe görevi birkaç kez çalıştırıp kaydı tutmak, gerçek maliyetin denemelerle birlikte nasıl oluştuğunu gösterir. API ile toplu içerik üretiyorsanız bu içeriklerin aramadaki performansını SEO hizmeti kapsamında ölçebiliriz; toplu sayfaların kalite kontrolü için programatik SEO kalite kontrolü rehberine bakabilirsiniz.

DeepSeek API hata kodları ne anlama gelir?

DeepSeek API’de en sık görülen hata kodu 429’dur ve isteklerin çok hızlı gönderildiği ya da eşzamanlı istek sınırının aşıldığı anlamına gelir. Belgedeki kodların tamamı:

Kod	Anlamı	Ne yapılmalı?
400	İstek gövdesi biçimi geçersiz	Hata mesajındaki ipucuna göre gövdeyi düzeltin.
401	Kimlik doğrulama başarısız (yanlış anahtar)	API anahtarını kontrol edin.
402	Bakiye yetersiz	Bakiye yükleyin.
422	Geçersiz parametre	Parametreleri düzeltin.
429	Hız sınırına ulaşıldı	İstekleri yavaşlatın; eşzamanlı istek sınırına bakın.
500	Sunucu hatası	Kısa süre bekleyip tekrar deneyin; sürerse destekle iletişime geçin.
503	Sunucu aşırı yüklü	Kısa süre bekleyip tekrar deneyin.

Eşzamanlı istek sınırı hesap düzeyinde hesaplanıyor; deepseek-flash için 2.500, deepseek-v4-pro için 500. Daha yüksek sınır için ek ücretsiz kapasite talebi açılabiliyor. Yanıt beklerken bağlantı açık kalıyor ve sunucu boş satırlar ya da akışta : keep-alive yorumları gönderiyor; istek 10 dakika içinde çıkarıma başlamazsa bağlantı kapanıyor. Sohbet uygulamasındaki uyarıların karşılığı DeepSeek mesajlar çok sık uyarısı rehberinde.

Önbellek (context caching) DeepSeek API maliyetini nasıl düşürür?

DeepSeek API’de disk önbelleği bütün kullanıcılar için varsayılan olarak açıktır ve bir isteğin başı önceki bir isteğin kaydedilmiş başıyla birebir eşleşirse o kısım ucuz “isabet” fiyatından ücretlenir. Belgeye göre eşleşme tam bir önek birimi gerektiriyor: ilk istek A + B, ikinci istek A + B + C ise A + B önbellekten gelir; ikinci istek A + C ise ilk seferde isabet olmaz.

• Sabit sistem mesajını ve tekrar eden uzun içeriği (ürün kataloğu, marka rehberi) isteğin başına koyun.
• Değişen soruyu en sona yazın.
• İsabeti prompt_cache_hit_tokens, ıskayı prompt_cache_miss_tokens alanından takip edin.

Önbelleğe almanın sağlayıcılar arasındaki farkları prompt caching nedir yazısında karşılaştırılıyor.

DeepSeek API'de görsel ve arama özellikleri nasıl kullanılır?

DeepSeek API’de görsel okuma yalnız deepseek-flash modelinde, web araması ise ayrı Search ve Fetch API’leriyle yapılır. Görsel, mesaj içeriğine base64 veri adresi, herkese açık adres ya da Files API dosya kimliği olarak eklenir; JPEG, PNG, GIF ve WebP destekleniyor ve bir görsel en fazla 1.024 token sayılıyor. Görsel üretimi API’de yok; ayrıntılar DeepSeek görsel oluşturuyor mu yazısında.

Search ve Fetch API’leri 1.000 başarılı istek başına 0,75 dolardan ücretleniyor. Fiyat sayfasına göre DeepSeek Harness, Claude Code ya da Codex üzerinden yapılan sunucu tarafı arama çağrıları şimdilik ücretsiz; istek başı ücretlendirme 1 Kasım 2026, Pekin saatiyle 00:00’da başlıyor. DeepSeek’i bir kodlama ajanının arkasında kullanmak isteyenler için Claude Code nasıl kullanılır rehberi de yol gösterir.

DeepSeek API anahtarı sızarsa ne yapılır?

Sızan DeepSeek API anahtarı hemen iptal edilmeli ve yerine yenisi oluşturulmalıdır; DeepSeek SSS’si bu işlemin adımlarını şöyle veriyor:

1. Platforma giriş yapıp API keys sayfasını açın.
2. Sızan anahtarı listede bulup çöp kutusu simgesine tıklayın ve onaylayın; anahtar hemen geçersiz olur.
3. Yeni anahtar oluşturup uygulamanızdaki eski anahtarın yerine koyun.
4. Kullanım sayfasında (Usage) anahtar bazında harcamayı kontrol edin.

Anahtar güvenliği kadar, modele verdiğiniz içeriğin içine gizlenmiş talimatlar da risk oluşturur; bu konu prompt injection nedir yazısında. Diğer araç rehberleri blog sayfasında.

İndirilebilir dosyalar

• DeepSeek API maliyet kaydı şablonu (CSV)

Sık sorulan sorular