DeepSeek V4-Flash-Vision API Nasıl Kullanılır (Görüntü Giriş Kılavuzu)

DeepSeek V4-Flash Vision Exp: Görsel API İsteklerini Üretimde Kullanma Rehberi

DeepSeek, 21 Ağustos 2026'da V4-Flash'ın görsel destekli sürümü olan deepseek-v4-flash-vision-exp modelini yayınladı. Model, üretim API'si üzerinden görsel kabul eder ve görseller girişte en fazla 384 token olarak ücretlendirilir; yani metin tabanlı V4-Flash ile aynı fiyatlandırmayı kullanır. Resmi sürüm notu, V4-Flash ile eşdeğer metin yeteneğinin yanında görsel anlama desteğini doğrular. Bu rehberde modeli çağırmayı, görsel yüklemeyi, sınırları yönetmeyi ve istekleri doğrulamalı şekilde test etmeyi göreceksiniz. Görsel istekler hızla büyüyebildiği için, ham JSON'ı terminalde elle düzenlemek yerine çağrıları Apidog içinde kaydetmek daha pratiktir.

Apidog'u bugün deneyin

deepseek-v4-flash-vision-exp nedir?

Model, görsel kodlayıcı eklenmiş V4-Flash-0731 sürümüdür. DeepSeek'e göre ajan iş yükleri, muhakeme ve dünya bilgisi dahil metin görevlerinde temel V4-Flash modeliyle eşleşir. Bu nedenle mevcut metin iş yüklerinizi kaybetmeden görsel destekli modele geçebilirsiniz.

OpenRouter listelemesi, modeli toplam 284B parametre ve 13B aktif parametreye sahip seyrek uzman karışımı (MoE) olarak tanımlar.

V4-Flash, DeepSeek'in bütçe odaklı serisidir. Metin modelini DeepSeek V4-Flash API rehberimizde ele almıştık; görsel desteği eklenmiş olsa da fiyatlandırma yaklaşımı değişmiyor. DeepSeek'in çok modlu ajan kıyaslamalarında Opus 4.8'e yakın olduğu iddiasını doğrudan üretim kararı olarak kabul etmeyin: geçiş öncesinde kendi belge, ekran görüntüsü ve görev setiniz üzerinde değerlendirme yapın.

exp etiketi olsa da model, normal üretim API uç noktalarında; diğer V4 modelleriyle aynı hız limitleri ve SLA çerçevesinde çalışır. Bekleme listesi veya özel erişim isteği gerekmez.

Fiyatlandırma: görseller Flash oranlarında

DeepSeek'in fiyatlandırma sayfasına göre model, metin tabanlı deepseek-v4-flash ile aynı token oranlarını kullanır:

	Off-peak / yoğun olmayan saatler	Peak / yoğun saatler
Giriş, cache hit — 1M token	$0.007	$0.014
Giriş, cache miss — 1M token	$0.22	$0.44
Çıkış — 1M token	$0.66	$1.32

Her görsel, faturalandırma açısından en fazla 384 giriş tokenına dönüştürülür. Yoğun saatlerde cache miss fiyatıyla tam maliyetli bir görsel yaklaşık $0.00017 tutar.

Maliyeti kontrol etmek için şu iki davranışı hesaba katın:

1. Toplu işleri yoğun saatlerin dışına planlayın. Yoğun saatler hafta içi 01:00–04:00 ve 06:00–10:00 UTC aralığıdır; bu pencerelerin dışında fiyat yaklaşık yarıya iner.
2. Sistem talimatlarını sabit tutun. Aynı uzun istemi farklı görsellerle tekrar kullanıyorsanız bağlam önbelleklemesi, metin giriş maliyetini azaltabilir.

V4 serisi için listelenen bağlam penceresi 1M tokendir; pratikte çıkış sınırı bunun çok altındadır.

Görsel göndermenin üç yolu

Model, standart Chat Completions uç noktası üzerinden çalışır:

https://api.deepseek.com/chat/completions

Görselleri bir user mesajının content dizisine ekleyin. Üç seçeneğiniz vardır.

1. Base64 veri URL'si

Tek kullanımlık dosyalar için uygundur. Görseli Base64 olarak kodlayıp veri URL'si şeklinde gönderin. Görsel başına sınır 32 MiB'dir.

import base64
from openai import OpenAI

client = OpenAI(
    [REDACTED CREDENTIAL]_DEEPSEEK_KEY",
    base_url="https://api.deepseek.com",
)

with open("invoice.png", "rb") as image_file:
    image_b64 = base64.b64encode(image_file.read()).decode()

response = client.chat.completions.create(
    model="deepseek-v4-flash-vision-exp",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Extract the line items and totals as JSON.",
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/png;base64,{image_b64}",
                    },
                },
            ],
        },
    ],
)

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

2. Harici görsel URL'si

Görselleriniz zaten herkese açık bir CDN veya dosya sunucusunda bulunuyorsa URL kullanın. URL uzunluğu en fazla 8.192 karakter olabilir.

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/chart.png"
  }
}

3. Dosyalar API'si referansı

Aynı görseli birden çok istekte kullanacaksanız dosyayı bir kez yükleyip file_id ile tekrar kullanın. DeepSeek Dosyalar API'si ücretsiz görsel yüklemelerini kabul eder ve dosya başına 64 MiB sınırı sunar.

{
  "type": "file",
  "file": {
    "file_id": "file-api-xxxxxxxxxxxxxxxx"
  }
}

Seçim kuralı basittir:

• Tek seferlik çağrılar: Base64
• CDN'de bulunan görseller: harici URL
• Tekrar kullanılan görseller: Dosyalar API'si ve file_id

detail parametresini görev türüne göre seçin

Her görsel için kullanılabilen detail alanı, ön işlemeyi kontrol eder:

• "low": Görseli 512×512'ye küçültür. Sınıflandırma, nesne tespiti veya hızlı kontrol senaryoları için uygundur.
• "high" / "original": Orijinal boyutları korur. Yoğun belgeler, küçük yazılar, fişler ve gösterge tabloları için tercih edilir.
• "auto": Seçimi API'ye bırakır.

Görseller, token hesabı için kabaca 800×800'e normalleştirilir; bu da görsel başına 384 tokenlık üst sınırı korur.

OCR'ye yakın doğruluk gerektiren işleriniz varsa, kendi veri setinizde "low" ve "high" değerlerini karşılaştırın. Bu fiyat seviyesinde maliyet farkı sınırlı olabilir; ancak küçük metinler ve tablo alanlarında doğruluk farkı önemli olabilir.

Üretime geçmeden önce sınırları doğrulayın

Kısıtlama	Değer
İstek başına maksimum görsel	600
Base64 görsel boyutu	32 MiB
Dosyalar API'si görsel boyutu	64 MiB
Toplam istek gövdesi	48 MiB
Görsel boyutları	Kenar başına 8.192 px; 15'ten fazla görsel içeren isteklerde 4.096 px
Harici URL uzunluğu	8.192 karakter
Görsel yerleşimi	Yalnızca user mesajları

Son satır özellikle önemlidir: system veya assistant mesajları içine görsel eklemek 400 hatası üretir.

Birden fazla görseli aynı istekte kullanabilir ve görsel bloklarını metin bloklarıyla serbestçe sıralayabilirsiniz. Bu yapı, ekran görüntüsü alan, akıl yürüten ve araç çağırarak işlem yapan ajan döngüleri için uygundur.

DeepSeek, modelle aynı gün DeepSeek Harness 0.1.1 içinde yerel destek de yayınladı. Bu yaklaşım için DeepSeek Harness genel bakışımıza bakabilirsiniz. Araç çağırma da görsel yetenekle birlikte çalışır; metin tabanlı akış için fonksiyon çağırma rehberimiz aynı tasarım prensiplerini açıklar.

Exp etiketiyle üretimde çalışma stratejisi

Exp, ücretli bir özellik veya erişim duvarı değil; modelin kısa sürede revize edilebileceğini belirten bir etikettir. Bu nedenle aşağıdaki önlemleri uygulayın:

1. Model kimliğini tek bir yapılandırma noktasında tutun.

   DEEPSEEK_VISION_MODEL=deepseek-v4-flash-vision-exp

Model adını uygulamanın farklı yerlerine sabit kodlamayın.

1. Metin için geri dönüş yolunu koruyun.
   
   Görsel içermeyen trafik için deepseek-v4-flash kullanabilecek bir fallback tanımlayın.

2. Değerlendirme verinizi sürümleyin.
   
   Belge çıkarma, grafik okuma veya ekran görüntüsü anlama testlerinizi kaydedin. Yeni bir model sürümü çıktığında satıcı kıyaslaması yerine kendi önce/sonra sonuçlarınızı karşılaştırın.

Maliyet örneği: aylık fatura işleme boru hattı

Ayda 50.000 taranmış fatura işlediğinizi varsayalım:

• Her faturada bir görsel
• İstek başına 200 tokenlık talimat
• Çağrı başına yaklaşık 400 tokenlık JSON çıktısı

Yoğun saatlerde cache miss oranlarıyla yaklaşık maliyet:

• Görsel girişi: 50.000 × 384 = 19,2M token → yaklaşık $8.45
• Metin girişi: 50.000 × 200 = 10M token → yaklaşık $4.40 Sabit talimat bloğunda bağlam önbelleklemesi kullanılırsa bunun büyük kısmı cache hit oranına düşebilir: yaklaşık $0.14
• Çıkış: 50.000 × 400 = 20M token → yaklaşık $26.40

Toplam maliyet yoğun saatlerde ayda yaklaşık $35–$40 olur. İşleri hafta içi 01:00–10:00 UTC dışında çalıştırmak, toplamı yaklaşık yarıya indirebilir.

Buradaki önemli optimizasyon dersi şudur: maliyeti çoğunlukla görseller değil, çıkış tokenları belirler. Görseller zaten ucuz olduğu için belge boru hattını optimize ederken görseli küçültmek yerine daha sıkı bir yanıt şeması kullanın. Uzun açıklamalar yerine kompakt JSON isteyin.

Apidog'da çok modlu istekleri test etme

Base64 dizileri ham JSON gövdesini okunaksızlaştırır; detail seviyelerini elle karşılaştırmak da benzer istekleri karıştırmaya açıktır. Daha tekrarlanabilir bir test döngüsü kurun:

1. İsteği bir kez Apidog projesine kaydedin.
   
   {{model_id}}, {{detail}} ve görsel yükünü değişken yapın.

2. Base64 kodlamayı otomatikleştirin.
   
   Ön istek betiği ile görseli okuyup Base64 değerini gövdeye enjekte edin; görünür JSON temiz kalır.

3. Çıktıyı şemaya göre doğrulayın.
   
   Satır öğeleri, toplamlar, sınırlayıcı notlar veya grafik değerleri bekliyorsanız yanıtı ayrıştıran ve alanları kontrol eden assertion'lar ekleyin.

4. Ön yüz geliştirmesi sırasında yanıtı taklit edin.
   
   İstem ve model davranışını ayarlarken API çağrısı yapmadan şemayı kullanmak için Apidog'un akıllı taklidinden yararlanın.

Apidog'u ücretsiz indirin, isteğinizi kaydedin ve model revize edildiğinde aynı test setini yeniden çalıştırın.

SSS

deepseek-v4-flash-vision-exp ücretsiz mi?

Hayır; ancak Flash fiyatlandırmasıyla ücretlendirilir. Her görsel en fazla 384 giriş tokenı olarak hesaplanır. Dosyalar API'sinde görsel depolama ücretsizdir; ücret yalnızca görsel bir isteğe girdiğinde oluşur.

deepseek-v4-flash modelinin yerini alıyor mu?

Hayır. Metin modeli kararlı kimlik olarak kalır. Görsel sürüm metin görevlerinde onunla eşleşir; ancak daha muhafazakâr yaklaşım, yalnızca görsel içeren trafiği deepseek-v4-flash-vision-exp modeline yönlendirmektir.

Anthropic tarzı API biçimiyle kullanabilir miyim?

Evet. DeepSeek V4 uç noktaları Chat Completions, Messages biçimi ve Responses biçimi çağrılarını kabul eder. Böylece mevcut istemci yaklaşımınızı değiştirmeden görsel blokları ekleyebilirsiniz. V4 Pro API detaylı incelememiz, aile genelinde ortak olan uç nokta mekaniklerini gösterir.

Fiyatlandırma GPT veya Claude vision ile nasıl karşılaştırılır?

Milyon giriş tokenı başına $0.22–$0.44 ve görsel başına en fazla 384 token ile, amiral gemisi çok modlu model oranlarının önemli ölçüde altındadır. Asıl karar noktası, modelin sizin iş yükünüzdeki doğruluğudur; bunu kendi değerlendirme senaryolarınızla ölçün.

Sonuç

deepseek-v4-flash-vision-exp, üretim API uç noktalarında düşük maliyetli görsel anlama sağlar. Base64, harici URL ve Dosyalar API'si olmak üzere üç giriş yöntemi; ayrıca tasarım sırasında dikkate alınması gereken net sınırlar sunar.

İsteği bir kez Apidog içinde oluşturun, yanıt doğrulamalarını kaydedin ve hem mevcut Exp sürümünü hem de gelecekteki haleflerini aynı değerlendirme setiyle test edin.