Kontrol

Görsel ve belge okuma (OCR)

OCR, görsel ve taranmış belgelerdeki yazıyı kurum içinde okur. Görsel ve belge dosyası dış servise gitmez. Yazı önce maskelenir, modele yalnız maskeli metin gider.

Nasıl çalışır

OCR proje bazında açılır. OCR açık projede akış şöyledir:

1. BaseLLM görseli sunucu içinde okur. 2. BaseLLM metindeki Türkçe harf hatalarını düzeltir. 3. Kişisel veri koruması metni maskeler. 4. Prompt injection koruması metni tarar ve sonucu kaydeder. 5. Model yalnız maskeli metni alır.

OCR metin çıkaramazsa istek modele gitmez. Uygulama açık bir hata kodu alır.

OCR'ı açma

1. Proje ayarlarında Kişisel veri bölümünü açın. 2. Kişisel veri korumasını açın ve maskeleme modunu seçin. Rapor modu OCR için yetmez. 3. Ad tespitini açın ve ad modelini seçin. 4. OCR kartından OCR'ı açın.

Bir şart eksikse kart, OCR için eksikler başlığı altında eksiği gösterir.

Karttaki uyarıYapılacak iş
OCR lisansınızda açık değilLisansınızı OCR özelliğini içeren bir lisansla güncelleyin
OCR modelleri bu kurulumda yokSistem yöneticisi modelleri kurulum imajına eklemelidir
Kişisel veri maskeleme lisansınızda açık değilLisansınızı güncelleyin
Kişisel veri maskelemeyi açınKişisel veri korumasını açın
Kişisel veri modu rapor olmamalıMaskeleme modunu seçin
Ad tespitini açın ve ad modelini seçinAd tespitini açın, ad modelini seçin
Ad modeli bu kurulumda yokSistem yöneticisi ad modelini kurulum imajına eklemelidir

Desteklenen yerler

YerOkunan içerik
Bilgi KataloğuPNG, JPG, WebP, taranmış PDF, PDF ve Word içindeki görseller
/api/v1/chat/completions, /api/v1/responsesİstekteki görseller
/api/v1/messagesGörseller, PDF belgeleri ve araç sonucundaki görseller
/api/v1/messages/count_tokensAynı içerik; sayım maskeli metin üzerinden yapılır

Bilgi Kataloğu en çok 20 MB dosya kabul eder. Bir belgede en çok 300 sayfa ya da görsel okunur.

Görseli isteğin içinde base64 olarak gönderin. OCR açık projede link ve dosya kimliği ile verilen görseller reddedilir. Aynı görsel 10 dakika içinde yeniden gelirse sonuç önbellekten alınır.

Görseller ayarıyla ilişkisi

OCRGörsellerSonuç
AçıkAçık ya da kapalıGörsel okunur, modele maskeli metin gider. Görsel modele gitmez
KapalıAçıkGörsel modele olduğu gibi gider, içi taranmaz
KapalıKapalıGörsel içeren istek reddedilir

Hata kodları

Hata koduHTTPAnlamı
ocr_not_ready503OCR açık ama bir şart eksik. Kişisel veri ayarlarını ve OCR kartını kontrol edin
ocr_source_not_supported400Görsel link ya da dosya kimliği ile geldi. Base64 gönderin
ocr_no_text422Görselde yazı bulunamadı
ocr_failed422Dosya okunamadı. Dosyanın bozuk olmadığını kontrol edin
ocr_too_many_pages422Belgede 300'den çok sayfa ya da görsel var
ocr_busy429Sıra dolu. İsteği kısa süre sonra tekrar gönderin
ocr_unavailable503OCR şu anda çalışmıyor. Sistem yöneticisine haber verin

Lisans ve kurulum

OCR ayrı bir lisans özelliğidir. Kurumsal ve deneme lisansında açıktır, bireysel lisansta kapalıdır. OCR ekran kartı istemez, işlemcide çalışır. Bellek ve süreç ayarları kurulum belgesindedir.