Segnali pagine PDF che richiedono OCR

Cosa significano le flag di livello testo e perché conta l'OCR per pagina

Gli strumenti a valle che chiamano API di estrazione testo ricevono stringhe vuote, la ricerca full-text salta la pagina, i lettori di accessibilità non annunciano nulla di utile e le pipeline di archiviazione che si aspettano testo nativo falliscono in silenzio. Invia quell'elenco ordinato di flag booleane; questo endpoint non apre il PDF. true significa che la pagina è ricercabile e non richiede OCR; false significa che è solo immagine (o senza livello testo) e va messa in coda per l'OCR. La risposta elenca needs_ocr_pages e searchable_pages come numeri di pagina a base uno, più needs_ocr_count, searchable_count, all_need_ocr, all_searchable, ocr_ratio come needs_ocr_count diviso per page_count, un array pages con has_text_layer e needs_ocr per pagina, e un summary leggibile per log e banner di interfaccia.

Contratto di ingresso, forma della risposta ed errori di elenco vuoto

Ogni voce dovrebbe essere booleana; il solver accetta anche i token numerici zero e uno e le stringhe comuni true, false, yes, no, y, n, zero e one, così export CSV o da moduli possono essere incollati senza un passo di conversione. Token non validi su una pagina specifica falliscono nominando l'indice di pagina a base uno, così può correggere la sonda che ha prodotto la mappa. Abbini questa uscita al Suo motore OCR o a un prodotto gemello di OCR PDF quando è pronto a elaborare solo le pagine elencate. Invii un corpo JSON con text_layer, un array non vuoto obbligatorio di flag di presenza per pagina nell'ordine del documento. Gli alias pages, flags e has_text sono accettati per lo stesso array. Un array vuoto, una stringa vuota, un campo mancante o un valore null falliscono con invalid_input e un messaggio che nomina text_layer e afferma che serve almeno una flag di pagina—quei fallimenti non vengono fatturati. In caso di successo il corpo restituisce page_count uguale alla lunghezza delle flag, needs_ocr_pages per ogni false, searchable_pages per ogni true, i due conteggi, all_need_ocr quando tutte le pagine richiedono OCR, all_searchable quando nessuna lo richiede, ocr_ratio arrotondato a dodici decimali per test stabili tra runtime, l'array dettagliato pages e summary. Esempio: flag true, false, true, false producono page_count quattro, needs_ocr_pages due e quattro, searchable_pages uno e tre, needs_ocr_count due, ocr_ratio zero virgola cinque, e un riepilogo che afferma che due pagine su quattro richiedono OCR.

Dove un'API di flag pagine che richiedono OCR rende

I banchi di digitalizzazione ricevono faldoni misti: export digitali nativi intercalati a scansioni a letto piano. I team di remediation dell'accessibilità necessitano di un elenco deterministico di pagine che falliscono i controlli di testo selezionabile, così i ticket si aprono pagina per pagina anziché a livello di documento. Mantenga le richieste piccole, fissi nei test gli elenchi ordinati di pagine e ottiene un cancello riproducibile tra inventario PDF e spesa OCR senza montare uno stack di IA documentale per una semplice scansione booleana. Un passo di preflight che ha già misurato la presenza del livello testo può chiamare questo endpoint per produrre un elenco di lavoro di numeri di pagina per la coda OCR senza riaprire file di centinaia di pagine. Le piattaforme di ricerca e e-discovery usano le stesse flag per decidere se un documento è pronto per l'indicizzazione o deve attendere l'OCR, e il campo ocr_ratio alimenta dashboard di qualità che tracciano quanto di ogni lotto in ingresso è ancora solo immagine. Poiché l'implementazione è parse di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita; la validazione fallita non consuma saldo.