AI model adları nasıl okunur: takma ad ile sabitlenmiş sürüm

Herhangi bir AI API sayfasını açtığınızda deepseek-flash, deepseek-v4-pro veya DeepSeek-V4-Flash-0731 gibi adlarla karşılaşırsınız. Etiket gibi görünürler, ancak model alanına koyduğunuz dize hangi modelin yanıt vereceğini ve ne kadar faturalandırılacağınızı belirler. Bu kılavuz, bu adların nasıl okunacağını, aynı adın sizin altınızdan neden değişebileceğini ve kodunuza bir kimlik yapıştırmadan önce neleri kontrol etmeniz gerektiğini gösterir.

Bir model adının anatomisi#

DeepSeek-V4-Flash-0731 alın ve parçalara ayırın:

İki uyarı. Sonek bir kuraldır, kanun değil: 1017, DeepSeek-V4.1-Flash-1017'nin (17 Ekim 2026) yayın tarihine uyar, ancak tahmin etmek yerine her zaman modelin sayfasında doğrulayın. Ve bir doküman sayfasında yazılan ad (DeepSeek-V4-Flash) her zaman API'nin kabul ettiği dize (deepseek-v4-flash-0731) değildir: görünen ad insanlar içindir, kimlik kod içindir.

Flash ve Pro#

Geliştiriciler genellikle bir neslin birkaç kademesini sunar. Flash normalde daha hızlı, daha hafif kademedir ve yüksek hacimli işler için tasarlanmıştır: sohbet, çıkarım, ajan döngüleri. Pro normalde daha zor görevler için daha büyük kademedir. Bu kelimeler geliştiricinin kendi pazarlama terimleridir, bu nedenle aileler arasında karşılaştırılamazlar: bir şirketin Flash'ı başka bir şirketin Flash'ıyla aynı boyutta değildir. Önemli olan deepseek-flash ve deepseek-v4-pro'nın iki farklı model adı olmasıdır, bu nedenle hangisini kullanırsanız kullanın fiyat tablosunu kontrol edin. Kademeyi değiştirirseniz fiyat tablosunu yeniden kontrol edin.

Takma ad ile sabitlenmiş sürüm#

İki tür kimlik vardır ve aralarındaki fark bu makaledeki en önemli şeydir.

• Takma ad — sağlayıcının bir modele işaret ettiği ve daha sonra yeniden işaret edebileceği bir ad. deepseek-flash bir takma addır: 22 Ekim 2026 itibarıyla DeepSeek'in dokümanları bunun DeepSeek-V4.1-Flash-1017 tarafından sunulduğunu ve çağırma şeklinizin değişmediğini söylüyor. Yarın aynı dize daha yeni bir derlemeye yol açabilir.
• Sabitlenmiş sürüm — derlemeyi içeren bir kimlik, örneğin deepseek-v4-flash-0731. Belirli bir derlemeyi adlandırır, bu nedenle dün test ettiğiniz yanıtlar bugün aynı derlemeden gelmelidir.

Takma ad kullanışlıdır: kodunuzu düzenlemeden iyileştirmeler alırsınız. Sabitlenmiş kimlik öngörülebilirdir: testler, değerlendirmeler, raporlar ve davranış değişikliğinin sizi şaşırtacağı her şey için iyidir. Hiçbiri "daha iyi" değildir; bilinçli seçin.

Aynı ad sizin altınızdan değişebilir#

Ekim 2026'daki DeepSeek değişikliği canlı bir örnektir. 22 Ekim 2026'da kontrol edilen DeepSeek dokümanlarına göre:

• deepseek-flash şu anda DeepSeek-V4.1-Flash-1017 tarafından sunulmaktadır;
• eski adlar deepseek-v4-flash ve deepseek-v4-flash-vision-exp hâlâ kabul edilir, ancak bu modeller kullanımdan kaldırılmıştır, bu nedenle istekler DeepSeek-V4.1-Flash-1017'ye gider ve Flash fiyatından faturalandırılır;
• deepseek-v4-pro ayrı, güncel bir model adıdır.

Yani eski kodunuz çalışmaya devam edebilir ve yine de yazdığınızdan farklı bir model çalıştırabilir. En son sürümü istiyorsanız bu sorun değil, sonuçları haftalar arasında karşılaştırdıysanız bir tuzaktır. Doküman sayfasında yayın tarihi yok, bu nedenle eşlemeyi yukarıdaki tarih için doğru kabul edin ve önemli olduğunda yeniden okuyun. Modelin kendisinde neyin değiştiği DeepSeek-V4.1-Flash-1017 is out sayfasında ele alınmıştır.

Kodunuza bir kimlik koymadan önce neleri kontrol etmelisiniz#

1. Kimliği gerçekten çağırdığınız sağlayıcının dokümanlarından kopyalayın. Farklı sağlayıcılar aynı aileyi farklı adlandırır, bu nedenle CheapTokens'ı çağırdığınızda kimliği CheapTokens dokümanlarından, DeepSeek'i çağırdığınızda DeepSeek dokümanlarından alın. Bunları karıştırmayın.
2. Karar verin: takma ad mı, sabitlenmiş mi? Dizede tarih veya derleme soneki yoksa, taşınabileceğini varsayın.
3. Temel URL'yi ve API stilini kontrol edin. CheapTokens, https://api.cheaptokens.dev/v1 adresinde OpenAI Chat Completions ve Anthropic Messages formatlarını konuşur; DeepSeek'in kendi API'si https://api.deepseek.com (OpenAI tarzı) ve https://api.deepseek.com/anthropic (Anthropic tarzı) kullanır. Yanlış temel URL'de doğru bir kimlik bir hatadır.
4. Tam olarak o kimlik için fiyat tablosunu açın ve tarihi not edin. Fiyatlar bir modele aittir, bir aileye değil.
5. Kimliği tek bir yerde tutun (bir yapılandırma dosyası veya ortam değişkeni), kod boyunca dağıtmayın.
6. Yanıt veren modeli günlüğe kaydedin. OpenAI tarzı yanıtlar bir model alanı taşır; bunu sonuçlarınızın yanına kaydedin.

import os
from openai import OpenAI

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

# Take the exact id from the CheapTokens docs; this one is an example.
MODEL_ID = os.environ.get("MODEL_ID", "minimax-m2.7")

response = client.chat.completions.create(
    model=MODEL_ID,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)

print("asked for:", MODEL_ID)
print("answered by:", response.model)
print(response.choices[0].message.content)

Yazdırılan iki satır, edinmeye değer alışkanlıktır: ne istediğiniz ve neyin yanıt verdiği. Anahtarı asla sabit kodlamayın; bkz. What is an API key and how to store it safely. Bu ilk çağrınızsa, Your first API request with CheapTokens ile başlayın.

Fiyatları ve sonuçları sürüm sürüm karşılaştırın#

Çoğu karışıklık yanlış şeyleri karşılaştırmaktan kaynaklanır. İki fiyatı veya iki yanıtı karşılaştırmadan önce her iki taraf için şunları yazın: tam kimlik, sağlayıcı ve tarih. Her ikisi de "Flash" diyen ancak farklı nesil veya derleme soneki taşıyan iki kimlik, farklı yayın tarihlerine sahip farklı modellerdir. Bir haber gönderisindeki kıyaslamalar için de aynısı geçerlidir: gönderide adı geçen derlemeye aittirler ve başka herhangi bir kimlik hakkında bir vaat değildirler.

Tersi de geçerlidir. Bir modeli kendi istemlerinizle test ettiğinizde, istem kümesini sabit tutun ve her seferinde tek bir şeyi değiştirin: kimliği veya istemi, ikisini birden değil. Karşılaştırma için token mı sayıyorsunuz? What is a token sayıların nasıl ölçüldüğünü açıklar.

Alıştırma yapmak için örnek kimlikler#

CheapTokens tüm modeller için tek bir bakiye tutar, böylece aynı anahtarla kimlikleri değiştirebilirsiniz:

• MiniMax-M2.7 (minimax-m2.7, ağ geçidi kimliği MiniMaxAI/MiniMax-M2.7): 180K bağlam, 8.192'ye kadar çıktı token'ı, her saatte tek fiyat. 1M token başına giriş $0.05 ve çıktı $0.15, her ikisi de OpenRouter'ın referansının altında.

Aşağıdaki tablo, 100.000 giriş ve 20.000 çıktı token'ından oluşan küçük bir iş için canlı olarak yeniden hesaplanır ve referans olarak bir OpenRouter sütunu içerir:

Her satırın belirli bir kimlik olduğunu unutmayın. minimax-m2.7'yi başka bir kimlikle değiştirirseniz, hem modeli hem de fiyatı değiştirirsiniz.

Hızlı özet#

• model dizesi hangi modelin yanıt vereceğini ve ne kadar maliyetli olacağını belirler.
• Derleme soneki olmayan bir kimlik muhtemelen bir takma addır ve yeniden işaret edilebilir; derleme içeren bir kimlik sabitlenmiştir.
• Eski adlar, 22 Ekim 2026'da DeepSeek'in dokümanlarındaki deepseek-v4-flash örneğinde olduğu gibi, sessizce daha yeni bir model çalıştırırken çalışmaya devam edebilir.
• Flash ve Pro bir aile içindeki kademelerdir, evrensel boyutlar değildir.
• Kimliği her zaman çağırdığınız sağlayıcının dokümanlarından kopyalayın ve hangi modelin yanıt verdiğini günlüğe kaydedin.

Denemeye hazır mısınız? Bir anahtar alın, bakiyeyi yükleyin ve yukarıdaki kod parçacığını CheapTokens dokümanlarından bir model kimliğiyle gönderin.