Entegrasyon rehberleri · 2026-09-22
Pixtral 12B ile görsel + function calling: yapılandırılmış veri çıkarma
Pixtral 12B'nin görsel girdi ve fonksiyon çağırma desteğini birlikte kullanarak bir fiş, form veya ekran görüntüsünden yapılandırılmış JSON çıkarma akışını anlatır.
İki yetenek ayrı ayrı bilinir, birlikte az kullanılır
Pixtral 12B modelinin katalog sayfasında görsel girdi ve fonksiyon çağırma iki ayrı yetenek olarak listelenir, ama çoğu entegrasyon bunları ayrı ayrı kullanır: ya görseli tanımlatıp serbest metin alır ya da yalnızca metin isteklerinde fonksiyon çağırır. İkisini aynı istekte birleştirmek, modelin gördüğü bir görseli doğrudan sizin tanımladığınız bir şemaya uyan yapılandırılmış bir nesneye dönüştürmesini sağlar.
Bu, özellikle bir fiş, form veya ekran görüntüsü gibi yarı yapılandırılmış belgelerden veri çıkarmak isteyen ekipler için serbest metin özetten daha kullanışlı bir çıktı biçimidir; serbest metni ayrıca ayrıştırmanız gerekmez.
İstek nasıl kurulur
İsteğe hem görseli (mesaj içeriğinde görsel parçası olarak) hem de çıkarmak istediğiniz alanları tanımlayan bir `tools` şemasını (örneğin tutar, tarih, satıcı adı alanlarını içeren bir fonksiyon) aynı anda eklersiniz. `tool_choice: "required"` göndermek, modelin serbest metinle yanıt vermesini engelleyip doğrudan fonksiyon çağrısı üretmesini zorlar; bu, çıktının her zaman yapılandırılmış biçimde gelmesini garanti eder.
Şema tasarlarken her alanı olabildiğince dar tanımlamak (örneğin tarihi serbest metin yerine `YYYY-MM-DD` biçiminde bir string olarak istemek) modelin döndürdüğü değerlerin tutarlılığını artırır.
- Görseli mesaj içeriğine, çıkarılacak alanları `tools` şemasına ekleyin.
- `tool_choice: "required"` ile serbest metin yanıtını engelleyin.
- Alan biçimlerini şemada dar tanımlayın (sabit tarih/sayı biçimi gibi).
Görsel biçimi ve boyut sınırlarını model sayfasından doğrulayın
Desteklenen dosya biçimleri, azami görsel boyutu veya çözünürlük gibi ayrıntılar sağlayıcı tarafında değişebilir; üretime almadan önce bu sınırları Pixtral 12B'nin model sayfasından veya güncel API dokümantasyonundan doğrulayın, özellikle taranmış belge gibi yüksek çözünürlüklü girdilerle çalışıyorsanız.
Sık sorulan sorular
Pixtral 12B her zaman yapılandırılmış JSON mı döndürür?
Yalnızca isteğe bir `tools` şeması eklediğinizde ve tercihen `tool_choice: "required"` gönderdiğinizde. Şema olmadan gönderilen bir görsel isteği serbest metin yanıt üretir.
Aynı istekte birden fazla görsel gönderebilir miyim?
Bu, isteğin toplam token bütçesine ve sağlayıcının güncel sınırlarına bağlıdır; birden fazla görsel göndermeden önce model sayfasındaki bağlam penceresi bilgisini kontrol edin.