DeepSeek API anahtarı: neyi nereye yapıştırmalı ve ilk çağrı

Bir DeepSeek API anahtarı, API'ye isteği kimin gönderdiğini söyleyen gizli bir dizedir. Ancak bir araç asla yalnızca anahtara ihtiyaç duymaz: birlikte üç değere ihtiyaç duyar — anahtar, temel URL ve model kimliği. Bu üçünü ayarlayın, ilk çağrı çalışır.

Bunu muhtemelen bir form sizden "DeepSeek API anahtarınızı" istediği için arattınız: bir betik, bir editör eklentisi, bir n8n düğümü. Sorun değil. Her alanın ne istediğine bakalım, sonra gerçek bir istek gönderelim.

API anahtarı aslında nedir?#

Bir otel kart anahtarı düşünün. Kim olduğunuzu kelimelerle söylemez; sadece kapınızı açar ve resepsiyon odanızı faturalandırır. Bir API anahtarı da aynı işi yapar: sunucu onu istekte görür, hangi hesabın ücretlendirileceğini bilir ve çağrının geçmesine izin verir. Kartı kaybedin, herkes içeri girip odanızı faturalandırabilir — bu yüzden anahtar koddan ve sohbetlerden uzak tutulur. (Daha uzun hikâye API anahtarı nedir ve güvenle nasıl saklanır yazısında.)

DeepSeek'in kendi API belgeleri (4 Kasım 2026'da kontrol edildi) aynı alışkanlığı gösteriyor: herhangi bir örneği çalıştırmadan önce anahtar bir ortam değişkenine, DEEPSEEK_API_KEY içine konur ve API OpenAI formatını izler — api_key ve base_url değiştirildiğinde OpenAI SDK çalışır. Bütün hile bu ve bir anahtarın neden asla yalnız seyahat etmediğinin nedeni de bu.

İnsanları yanıltan bir ayrıntı: bir anahtar, onu veren hizmete aittir. Bir CheapTokens anahtarı CheapTokens adresiyle gider ve model kimliği CheapTokens'in listelediği kimliktir. Bir yerden gelen anahtarı başka bir yerin adresiyle karıştırırsanız yanıt değil, yetkilendirme hatası alırsınız.

Anahtarı bir ortam değişkenine koyun#

CheapTokens hesabınızda bir anahtar oluşturun (adımlar belgelerde) ve isteğin çekecek bir şeyi olması için bakiyeyi yüksek tutun. Sonra anahtarı bir dosyaya yapıştırmak yerine bir değişkende saklayın.

macOS veya Linux:

export CHEAPTOKENS_API_KEY='paste-your-key-here'

Windows PowerShell (yalnızca geçerli pencere):

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

paste-your-key-here kısmı bir yer tutucudur; gerçek anahtarınızı kendi terminalinizde oraya koyun, başka hiçbir yere değil. Bunun sabit kodlanmış bir anahtardan neden daha iyi olduğu ve bir anahtar sızarsa ne yapılacağı API anahtarını güvenle saklayın: ortam değişkeni, .gitignore, sızıntı düzeltmesi yazısında.

İlk istek#

Diyelim ki sadece çalıştığını görmek istiyorsunuz: modelden bir API anahtarını tek cümleyle açıklamasını isteyin. Aynı istek, iki yol — kullandığınız sekmeyi seçin.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

print(resp.choices[0].message.content)
print(resp.usage)

Python sürümü bir kez pip install openai gerektirir. OpenAI SDK için yazılmış bir betikle karşılaştırıldığında neyin değiştiğine bakın: api_key, base_url ve model — aynı üç değer. Geri kalan her şey olduğu gibi kalır.

Görmeniz gereken şey#

Yanıt JSON'dur. Cevabın metni choices[0].message.content içinde yer alır; Python betiğinin ilk yazdırdığı şey budur. Hemen yanında prompt_tokens, completion_tokens ve total_tokens içeren bir usage bloğu vardır — kaç token girdi, kaç token çıktı ve toplamı. Bir maliyet bu iki sayıdan hesaplanır, bu yüzden ilk çağrıda bile bir göz atmaya değerler (Girdi ve çıktı tokenları ayrımı açıklar).

Ölçek hakkında bir fikir edinmek için: bunun gibi bir çağrı çok küçüktür. 30 token girdi ve 200 token çıktı alın — örnekteki max_tokens üst sınırı, yani bu isteğin yapabileceği en pahalı çağrı. Maliyeti $0.00002. Bin tanesi şöyle görünür, yanında referans olarak OpenRouter ile:

Bu kimliğin arkasındaki model DeepSeek-V4-Flash: 380K token bağlam penceresi ve tek bir yanıtta 32.768 token'a kadar. Fiyat her saat aynıdır, yoğun saat ek ücreti yoktur ve tek bir bakiye her modeli kapsar. Toplamda — girdi ve çıktı birlikte — OpenRouter'dan daha ucuza gelir, yukarıdaki tablo da tam olarak bunu gösterir. Model hakkında daha fazlası: CheapTokens'te DeepSeek, güncel fiyatlar fiyatlandırma sayfasında.

Çalışmadığında#

Neredeyse her ilk çağrı hatası, üç değerden birinin yanlış olmasıdır. Belirtiyi suçluyla eşleştirin:

Bu hataların tam anlatımı API 401 veya 404 hatası: yanlış anahtar, temel URL veya model kimliği yazısında. Hangi kimliği kullanacağınızdan emin değilseniz, API'nin kendisine sorun: GET /v1/models ile modelleri listeleyin.

Aynı üç değer bundan sonra nereye gider#

Bunları bir kez öğrenmenin amacı taşınabilir olmalarıdır. OpenAI uyumlu bir API ile konuşan neredeyse her araç bu aynı değerleri bir biçimde ister: anahtar, adres ve model. Bir betikte (LangChain, LiteLLM) bunlar argümandır; bir uygulamada veya kod gerektirmeyen bir düğümde bunlar alan veya ayardır. Kod yazmadan da Postman içinde deneyebilirsiniz. Bu modelle akış ve uzun yanıtlar için DeepSeek-V4-Flash hızlı başlangıç ile devam edin.