OCR ile bir görüntüden metin çıkarın, içindeki KKV ve güvensiz içeriği tespit edin ve görüntünün redakte edilmiş bir kopyasını geri alın.

Bir görüntü üzerinde OCR çalıştırın, çıkarılan metni tam tespit hattıyla tarayın ve bir tespit maskeleme gerektirdiğinde görüntünün redakte edilmiş bir kopyasını alın.

Warning

Her /image-analysis yolu yalnızca JWT koruyucusuyla korunur. Bir ağ geçidi API anahtarı (cid_key_…) bu uç noktaları çağıramaz — yalnızca /chat/*, /models ve /api/v1/guardrails/detect için kimlik doğrular.

Bir görüntüyü analiz etme

POST /image-analysis/analyze

İstek çok parçalı (multipart) değil, base64 taşıyan JSON'dur. Bu uç noktada dosya yükleme alanı yoktur.

Parametre	Tür	Gerekli	Açıklama
`imageBase64`	string	Evet	`data:image/…` ön eki olmadan base64 kodlanmış görüntü. Çözülmüş hâli en fazla 10 MB
`redactPii`	boolean	Hayır	Görüntüdeki tespit edilen KKV'yi redakte eder. Varsayılan `true`
`confidenceThreshold`	number	Hayır	Asgari tespit güveni, 0–1. Varsayılan `0.5`
`language`	string	Hayır	OCR dil ipucu, örneğin `en` veya `tr`. Varsayılan `auto`
`ocrEngine`	string	Hayır	`paddleocr` veya `tesseract`. Varsayılan `paddleocr`
`sessionId`	string	Hayır	Tespitleri bu oturuma kaydeder

Boyut sınırı, kodlanmış dize üzerinde uzunluk × 3 / 4 olarak denetlenir; dolayısıyla çözülmüş görüntüsü 10 MB'ı aşan bir istek, herhangi bir OCR çalışmadan önce doğrulama tarafından Image size exceeds maximum allowed size of 10MB ile reddedilir. Base64 bir yükü yaklaşık üçte bir oranında şişirir; bu yüzden 10 MB'lık bir görüntü yaklaşık 13,3 MB'lık JSON olarak gelir.

curl -X POST https://<appliance-fqdn>/image-analysis/analyze \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUg...",
    "language": "en"
  }'

Yanıt

{
  "success": true,
  "action": "mask",
  "extractedText": "Name: John Smith\nSSN: 123-45-6789",
  "piiDetections": [
    { "type": "PERSON_NAME", "value": "[PERSON_NAME]", "action": "mask", "confidence": 0.95 },
    { "type": "SSN", "value": "[SSN]", "action": "mask", "confidence": 0.95 }
  ],
  "safetyDetections": [],
  "summary": { "piiCount": 2, "safetyIssueCount": 0 },
  "wasRedacted": true,
  "redactedImageBase64": "iVBORw0KGgoAAAANSUhEUg...",
  "processingTimeMs": 1320
}

Alan	Tür	Açıklama
`success`	boolean	Analizin tamamlanıp tamamlanmadığı
`action`	string	`allow`, `mask`, `reject` veya `flag`
`extractedText`	string	Tespit motorlarının üzerinde çalıştığı OCR çıktısı
`piiDetections`	array	`{type, value, confidence, action, boundingBoxes?}`
`safetyDetections`	array	`{type, confidence, action}`
`summary`	object	`{piiCount, safetyIssueCount}`
`wasRedacted`	boolean	Redakte edilmiş bir görüntü üretilip üretilmediği
`redactedImageBase64`	string	Yalnızca `wasRedacted` doğru olduğunda bulunur
`processingTimeMs`	number	Tüm çağrının duvar saati süresi
`actionReason`, `rejectionReason`	string	Eylemin neden seçildiği, verilecek bir gerekçe olduğunda
`documentType`	object	Kural tabanlı belge sınıflandırıcısından `{type, confidence, signals}`
`mrzDetected`	boolean	Bir pasaport makine tarafından okunabilir bölgesinin ayrıştırılıp ayrıştırılmadığı
`ocrFailed`	boolean	OCR kullanılabilir bir çıktı üretmediğinde ayarlanır

Redaksiyon seçicidir ve her filtrenin kararlaştırdığı eylemi izler: mask olarak ayarlanan varlıklar görüntüden boyanarak kaldırılır, flag olarak ayarlananlar kaydedilir ama görünür bırakılır, bir reject ise görüntünün tamamını engeller. extractedText ve tespit dizileri her zaman döndürülür; redactedImageBase64 yalnızca gerçekten bir şey maskelendiğinde görünür.

Note

Görüntü yolu, metin yolunun çalıştırmadığı iki tespit motoru çalıştırır: bir ICAO 9303 MRZ ayrıştırıcısı (source: "mrz") ve bir kimlik belgesi yerleşim çıkarıcısı (source: "identity_layout"). Kimlik belgesi olarak sınıflandırılan bir görüntü jailbreak tespitini atlar.

OCR motorlarını listeleme

GET /image-analysis/ocr-engines

Dağıtımın kullanabileceği OCR motorlarını ve dil desteklerini döndürür. İstek gövdesi yoktur.

OCR motorlarını karşılaştırma

POST /image-analysis/compare-ocr

Çıkarma kalitesini karşılaştırabilmeniz için tek bir görüntüyü birkaç motordan geçirir.

Parametre	Tür	Gerekli	Açıklama
`imageBase64`	string	Evet	Base64 kodlanmış görüntü, aynı 10 MB sınırı
`language`	string	Hayır	Dil ipucu. Varsayılan `auto`
`engines`	string[]	Hayır	Karşılaştırılacak motorlar. Varsayılan: mevcut olanların tümü
`confidenceThreshold`	number	Hayır	0–1. Varsayılan `0.5`

İlgili sayfalar

Belge analizi — aynı hattın PDF, DOCX, TXT, CSV ve XLSX üzerinde çalışması.
KKV tespiti — OCR metninin hangi varlık türleri için tarandığı.
İçerik tespiti — bu yanıtların paylaştığı tespit sözleşmesi.

Görüntü analizi

Bir görüntüyü analiz etme

Yanıt

OCR motorlarını listeleme

OCR motorlarını karşılaştırma

İlgili sayfalar

Bu sayfada