Pixtral 12B’den Ministral 3 14B’ye geçiş: görsel isteklerini karşılaştırma

Pixtral 12B için geçiş kararı ne anlama geliyor?

Pixtral 12B’den görsel iş akışını taşırken Mistral’ın önerdiği hedef Ministral 3 14B’dir. Güvenli geçiş, yalnızca model adını değiştirmekten fazlasını gerektirir: doğru sürümü seçin, aynı görsel ve soruyla çıktıları karşılaştırın, ardından uygulamanın kabul ölçütlerini doğrulayın. Bu rehber görselden metinle yanıt alma içindir; görsel üretimini kapsamaz.

28 Ağustos 2026’da kontrol edilen resmî Pixtral sayfası modeli deprecated olarak işaretliyor. İncelenen LLMTR katalog kaydı ise etkin ve emekli olarak işaretlenmemiş. Sağlayıcının yaşam döngüsü etiketi tek başına LLMTR kesintisi kanıtı değildir; katalog kaydı da güncel çağrı başarısı garantilemez. Bu yazı için canlı model çağrısı yapılmadı.

Önce sağlayıcı sürümü ile LLMTR kimliğini ayırın

LLMTR’deki mistral/ministral-14b-latest kaydı sağlayıcıya ministral-14b-latest adını gönderir; belirli bir sürüm sabitlenmez. Mistral’ın görsel rehberi Ministral 3 14B’yi ministral-14b-2512 ile listeler ve örneğinde latest adını kullanır. Ancak latest adının bugünkü canlı çözümlemesi burada ölçülmedi. Tekrarlanabilir testlerde bu adı kalıcı sürüm garantisi saymayın.

Sağlayıcıdaki sabit sürüm adının önüne mistral/ ekleyerek yeni bir LLMTR kimliği oluşturmayın. Gateway’de yalnızca katalogda sunulan kimliği kullanın; sabit sürüm gereksinimini erişim kanalınız için ayrıca doğrulayın.

Aynı görsellerden küçük bir kabul seti hazırlayın

Kişisel veya müşteri verisi içermeyen bir tablo, etiketli grafik ve okunması zor görüntü seçin. Beklenen alanları insan incelemesiyle doğrulayın. Her vaka için aynı dosyayı, kırpmayı, görsel sırasını, istemi ve çıktı bütçesini koruyun. Görseli de istemi de aynı anda değiştirirseniz sonuç farkının nedenini ayıramazsınız.

Eski model erişilemiyorsa karşılaştırma sonucu uydurmayın. Önceden izinli değerlendirmelerde elde edilmiş sonuçları tarihleriyle kullanabilir veya yeni modeli insan tarafından hazırlanmış referans cevaplarla değerlendirebilirsiniz. Üretim konuşmalarını bunun için kaydetmeyin.

• Tabloda sütun adı, satır eşleşmesi ve sayıların aynen aktarılmasını kontrol edin.
• Grafikte birim, eksen ve lejand eşleşmesini ayrı puanlayın.
• Bulanık veya kesilmiş alanda tahmin yerine belirsizlik bildirilmesini isteyin.
• Görsel içindeki talimatların uygulamanın görevini değiştirmediğini denetleyin.

Sabit sürümle doğrudan Mistral örneği

Aşağıdaki Python örneği LLMTR’yi değil, doğrudan Mistral API’sini çağırır ve MISTRAL_API_KEY gerektirir. PUBLIC_TEST_IMAGE_URL değişkenine paylaşmaya yetkili olduğunuz, hassas bilgi içermeyen ve sağlayıcının erişebildiği HTTPS tablo görselini koyun. Örnek çalıştırıldığında ücret doğurabilir; burada yalnızca istek yapısı gösteriliyor.

Eski sağlayıcı kimliği pixtral-12b-2409 yerine belgelenmiş ministral-14b-2512 kullanılır. Karşılaştırma boyunca soruyu sabit tutun. Kod yanıt içeriğini answer değişkeninde bırakır; yalnızca model ve kullanım üstverisini yazdırır.

Doğrudan Mistral: tek görsel, sabit model sürümü, içerik günlüğü yok

import json
import os
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen

image_url = os.environ["PUBLIC_TEST_IMAGE_URL"]
if not image_url.startswith("https://"):
    raise ValueError("HTTPS test görseli gerekli")

payload = {
    "model": "ministral-14b-2512",
    "messages": [{
        "role": "user",
        "content": [
            {"type": "text", "text": (
                "Sütun adlarını ve ilk veri satırını aktar. "
                "Okunamayan değere bilinmiyor yaz; eksik değeri tahmin etme."
            )},
            {"type": "image_url", "image_url": image_url}
        ]
    }],
    "temperature": 0,
    "max_tokens": 400,
    "stream": False
}
request = Request(
    "https://api.mistral.ai/v1/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["MISTRAL_API_KEY"],
        "Content-Type": "application/json"
    },
    method="POST"
)
try:
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}; körlemesine tekrar denemeyin") from None
except URLError:
    raise SystemExit("Ağ veya zaman aşımı hatası") from None

choice = result["choices"][0]
if choice.get("finish_reason") == "length":
    raise SystemExit("Kesilmiş çıktı; yanıt bütçesini inceleyin")
answer = choice["message"]["content"]
print(json.dumps({
    "model": result.get("model"),
    "usage": result.get("usage"),
    "finish_reason": choice.get("finish_reason")
}))

Başarılı HTTP yanıtını doğru sonuçla karıştırmayın

Bir isteğin kabul edilmesi görselin doğru okunduğunu göstermez. Alan doğruluğunu, eksik değer davranışını ve uygulamanın yanıtı ayrıştırabilmesini ayrı değerlendirin. Yanıt bütçesi dolmuşsa kesilmiş cevabı kalite karşılaştırmasına katmayın; bütçeyi düzenleyip aynı koşulları yeniden uygulayın.

Tek denemenin süresinden hız üstünlüğü çıkarmayın. Gecikme, hata sayısı ve bildirilen kullanım değerlerini birden fazla izinli testte ölçün. Daha kısa cevap, alan atlıyorsa daha iyi değildir. Görsel yüklenemediğinde önce URL erişimini ve istek biçimini kontrol edin.

LLMTR’ye geçişi ayrı bir kabul adımı yapın

Doğrudan sağlayıcı testi, LLMTR yolunu doğrulamaz. Gateway entegrasyonunda tam API taban adresini LLMTR_BASE_URL’den, anahtarı LLMTR_API_KEY’den alın ve katalogdaki mistral/ministral-14b-latest kimliğini kullanın. LLMTR görsel girdisinde image_url alanı url içeren nesnedir; yukarıdaki doğrudan Mistral örneğinin dizge biçimini aynen kopyalamayın.

Önce değerlendirme trafiğinde hata ve alan doğruluğu eşiklerini belirleyin. Üretime açmadan önce aynı kabul setini seçilen LLMTR yolunda doğrulayın. Geri dönüş planı, eski Pixtral hizmetinin hâlâ erişilebilir olduğu varsayımına dayanmasın; önceden doğrulanmış başka bir yol veya insan incelemesi bulundurun.

Sık sorulan sorular

Deprecated etiketi Pixtral 12B’nin LLMTR’de kapandığı anlamına mı gelir?

Hayır. Sağlayıcının yaşam döngüsü bildirimiyle gateway’in güncel erişimi ayrı doğrulanır. İncelenen katalog kaydı emekli değil; bu yazı canlı erişim testi sunmuyor.

Yalnızca model alanını değiştirmek yeterli mi?

Aynı API içinde başlangıç olabilir; sürüm, görsel biçimi, alan doğruluğu ve hata davranışı yine test edilmelidir. Sağlayıcıdan LLMTR’ye geçerken taban adresi, kimlik bilgisi ve görsel alanının biçimi de değişir.

Ministral 3 14B’nin daha iyi sonuç vereceği kesin mi?

Hayır. Resmî halef önerisi sizin verinizdeki başarı oranını ölçmez. Türkçe etiketleri, küçük yazıları, eksik alanları ve uygulamanın beklediği çıktı düzenini kendi kabul setinizde karşılaştırın.

İlgili yazılar

• Pixtral 12B nedir? Görsel anlama, açık ağırlıklar ve API yaşam döngüsü

• mistral/pixtral-12b
• mistral/ministral-14b-latest
• Model kataloğu
• Gateway dokümantasyonu
• OpenAI / OpenRouter