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ğil | Lisansınızı OCR özelliğini içeren bir lisansla güncelleyin |
| OCR modelleri bu kurulumda yok | Sistem yöneticisi modelleri kurulum imajına eklemelidir |
| Kişisel veri maskeleme lisansınızda açık değil | Lisansınızı güncelleyin |
| Kişisel veri maskelemeyi açın | Kişisel veri korumasını açın |
| Kişisel veri modu rapor olmamalı | Maskeleme modunu seçin |
| Ad tespitini açın ve ad modelini seçin | Ad tespitini açın, ad modelini seçin |
| Ad modeli bu kurulumda yok | Sistem yöneticisi ad modelini kurulum imajına eklemelidir |
Desteklenen yerler
| Yer | Okunan içerik |
|---|---|
| Bilgi Kataloğu | PNG, JPG, WebP, taranmış PDF, PDF ve Word içindeki görseller |
| /api/v1/chat/completions, /api/v1/responses | İstekteki görseller |
| /api/v1/messages | Görseller, PDF belgeleri ve araç sonucundaki görseller |
| /api/v1/messages/count_tokens | Aynı 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
| OCR | Görseller | Sonuç |
|---|---|---|
| Açık | Açık ya da kapalı | Görsel okunur, modele maskeli metin gider. Görsel modele gitmez |
| Kapalı | Açık | Görsel modele olduğu gibi gider, içi taranmaz |
| Kapalı | Kapalı | Görsel içeren istek reddedilir |
Hata kodları
| Hata kodu | HTTP | Anlamı |
|---|---|---|
| ocr_not_ready | 503 | OCR açık ama bir şart eksik. Kişisel veri ayarlarını ve OCR kartını kontrol edin |
| ocr_source_not_supported | 400 | Görsel link ya da dosya kimliği ile geldi. Base64 gönderin |
| ocr_no_text | 422 | Görselde yazı bulunamadı |
| ocr_failed | 422 | Dosya okunamadı. Dosyanın bozuk olmadığını kontrol edin |
| ocr_too_many_pages | 422 | Belgede 300'den çok sayfa ya da görsel var |
| ocr_busy | 429 | Sıra dolu. İsteği kısa süre sonra tekrar gönderin |
| ocr_unavailable | 503 | OCR ş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.