Leest wat er staat
Haalt tekst uit documenten en scans met OCR. Herkent tabelstructuur en kan Qwen inzetten om tekst en relevante afbeeldingen te interpreteren.
VAN DOCUMENT NAAR BRUIKBARE INFORMATIEGeef je applicatie
Geef je applicatie
zicht op documenten.
Een PDF, scan of foto aanleveren. Tekst, tabellen en beeldinformatie terugkrijgen. DocLens doet het voorbereidende werk, zodat jouw app verder kan.
Zelfstandig inzetbaar voor iedere applicatie.
PDFSCANFOTO
↓
DocLensLezen · ordenen · verwijzen
↓
Klaar voor jouw applicatieTekst & tabellenBeeldinterpretatieBronnen & controlepunten
Eén dossier. Alle onderdelen verbonden.
Houdt het bij elkaar
Verdeelt lange documenten in kleinere stukken. Bestanden, pagina’s en bronverwijzingen blijven gekoppeld aan het juiste dossier.
Maakt twijfel zichtbaar
Onderscheidt broninformatie van AI-interpretatie. Onduidelijke inhoud en ontbrekende onderdelen blijven zichtbaar voor controle.
Een hulpmiddel voor verwerking, met menselijke controle.
Een technisch geslaagde verwerking is geen garantie dat alle informatie inhoudelijk klopt. Je applicatie bepaalt hoe resultaten gecontroleerd en gebruikt worden.
EEN DUIDELIJKE TAAKVERDELING
Zo sluit je aan →DocLens leest. Jouw app handelt.
DocLens levert de documentlaag
Ontvangt bestanden, bewaart samenhang, verwerkt in een wachtrij en levert gestructureerde resultaten via de API.
Jouw app bepaalt het vervolg
Bijvoorbeeld vragen beantwoorden, dossiers vergelijken of gegevens verwerken in een bedrijfsproces. DocLens neemt die beslissingen niet over.
Documenten verwerken.
Lever één of meer bestanden aan als één dossier. Volg de verwerking en bekijk de bronlezing, controlepunten en het tokenverbruik.
1. Bestanden aanleveren
2. Voortgang
Nog geen verwerking gestart.
Bij verbindingsverlies blijft een geaccepteerde job op de server doorlopen. Bewaar het job-ID. De laatst gestarte job wordt in dit tabblad onthouden, zonder sleutel of documentinhoud.
Bestaande job volgen
3. Resultaat & controle
Controle blijft nodig.
Technisch volledig betekent niet inhoudelijk goedgekeurd. Gebruik de bronlezing en de oorspronkelijke documenten; modellezingen zijn aanvullende informatie. DocLens classificeert dit resultaat niet automatisch als order.
Tokenverbruik van deze job
Controlepunten en hersteladvies
Bronlezing per document en pagina
Niet-toegewezen fragmenten
Tweede lezingen
In acht stappen aangesloten.
Je app levert een dossier aan en volgt de verwerking op de achtergrond. Gebruik voor iedere app een eigen DocLens API-sleutel. Die maak je als beheerder aan bij Instellingen → API-sleutels per app.
Bewaar je app-sleutel op je server.
Stuur hem mee als Authorization: Bearer <app-key>. Dit is een andere sleutel dan de gateway- of beheersleutel. De voorbeelden hieronder voeren niets uit en bevatten geen echte credentials.
Een dossier verwerken
Voorbeelden aanpassen →Benodigd: curl en jq. De voorbeelden gebruiken je app-sleutel in DOCLENS_APP_KEY. Het resultaat wordt opgeslagen in RESULT_FILE; de laatste stappen tonen controlepunten, bronregels, losse fragmenten, tweede lezingen en tokenverbruik.
Veilig herhalen
Gebruik een unieke Idempotency-Key per aanmaakactie, upload en job. Bij een verloren antwoord herhaal je exact dezelfde aanvraag met dezelfde sleutel. Dat voorkomt dubbele verwerking.
Eerst alle bestanden uploaden
Na de jobstart is de documentset verzegeld. Nieuwe of gewijzigde bestanden horen in een nieuw dossier. Zonder use_gateway: true wordt alleen lokaal geëxtraheerd.
Swagger-aanvragen maken echte dossiers en jobs aan. AI-gebruik kan gatewaykosten veroorzaken.
Weet wat je terugkrijgt.
Een resultaat verbindt de oorspronkelijke bestanden met hun pagina’s, tekstfragmenten en interpretaties. Je kunt altijd terug naar de bron.
Broninformatie
Gebruik source_reading.pages voor brontekst per document en pagina. lines bewaart native PDF-regels of lokale extractiefragmenten, met bronverwijzingen. Dit zijn geen automatisch goedgekeurde orderregels.
AI-interpretatie
Qwen 3.8 leest tekst en Qwen-VL leest afbeeldingen, als AI is ingeschakeld. Afwijkende transcripties worden uit de effectieve tekstbevindingen geweerd. Ruwe visual_evidence.transcription blijft diagnostiek, geen importbron.
Controlepunten
Inhoudelijke controle blijft nodig bij quality_status: requires_human_review, ook als de job technisch geslaagd is. Bekijk issues, quality_issues, de paginastatus, supplemental_extraction en unplaced_fragments. Ontbreekt source_reading, controleer dan het oorspronkelijke document.
Niet-toegewezen tekst blijft beschikbaar.
source_reading.unplaced_fragments bevat tekst die niet betrouwbaar aan één verwerkte pagina is toe te wijzen, bijvoorbeeld bij bronposities op verschillende pagina’s. Bekijk de tekst, het document-ID, alle sources en het controlepunt LOCAL_FRAGMENT_PAGE_UNRESOLVED met de bijbehorende quality_issues. Splits of koppel deze tekst niet automatisch.
Een ontbrekend veld in een ouder resultaat betekent dat deze controle onbekend is, niet dat er geen losse fragmenten zijn. extraction_coverage bevestigt behoud van reeds geëxtraheerde fragmenten; het bewijst niet dat OCR alles correct heeft gelezen. Het fragmentregister en de native regels zijn alternatieve bewijsweergaven: importeer dezelfde tekst niet dubbel.
Gerichte tweede lezing
second_reading bevat aanvullende Qwen-VL-lezingen van velden en rijen bij verschillen, waar betrouwbare native PDF-geometrie beschikbaar is. Bron en eerste lezing blijven behouden. Bekijk views, deferred en unsupported_pages. Een uitsnede is geen extra pagina. Overeenkomst betekent geen inhoudelijke goedkeuring.
Tokenverbruik per model
token_usage bevat het verbruik per job/dossierrun en per Qwen-model, inclusief retries en afgewezen antwoorden. Bij complete: false is het volledige totaal onbekend; known_tokens toont alleen het bekende deel. Voor eerdere herverwerkingen tel je de afzonderlijke jobs mee.
Huidig resultaatcontract: 0.8.0. Maximaal 1000 gatewaypogingen per verwerking van een dossier, inclusief retries en tweede lezingen. De gedeelde gelijktijdigheid is instelbaar in beveiligd beheer; de huidige gatewaycapaciteit is 2. Lokale extractie, modelanalyse en aanvullende lezingen kosten elk tijd. De API geeft geen garantie dat een dossier een order is of correct in SAP wordt verwerkt.
De status vertelt hoe ver de verwerking is
queuedHet dossier wacht op een worker.
runningVerwerking loopt; de job bevat fase en voortgang.
succeededTechnisch volledig. Inhoudelijke controle blijft nodig.
partialGedeeltelijk resultaat. Controleer welke onderdelen ontbreken.
failed / interruptedMislukt of onderbroken. Lees de foutcode voordat je opnieuw start.
Bij een gatewaystoring blijft onvolledigheid zichtbaar.
DocLens probeert bepaalde tijdelijke fouten begrensd opnieuw en gebruikt een gezamenlijke afkoelperiode. Een gedeeltelijke job start niet vanzelf opnieuw. Lees recovery.retry: gebruik alleen bij allowed: true de retry-route. Bij follow_existing_job volg je de bestaande vervolgjob. Bij replace_input_new_dossier lever je verbeterde bestanden aan. Een onbekende uitkomst vereist controle; herhalen kan opnieuw kosten veroorzaken.
Drie verschillende limieten
Standaardwaarden; actuele limieten worden opgehaald…
Paginalimieten en het Qwen-budget gelden vanaf het aanmaken van een nieuwe job. Een bestaande job houdt haar vastgelegde limieten. Bekijk processing_limits in de jobstatus of het resultaat.
1. Pagina’s en bestanden
Maximaal 50 pagina’s per PDF en 100 pagina’s per dossier. Daarnaast gelden de grenzen voor het aantal bestanden en de bestandsgrootte hieronder.
Dit bepaalt hoeveel bronmateriaal DocLens in één dossier kan verwerken.
2. Verkeer naar de DocLens-API
Maximaal 120 API-requests per minuut per app. Dossiers aanmaken, bestanden uploaden, jobs starten en status of resultaten ophalen tellen mee. Ook iedere voortgangscontrole (polling) is een request.
Dit is geen limiet op het aantal pagina’s of Qwen-aanvragen. Bij HTTP 429 wacht je volgens Retry-After.
3. Aanvragen aan Qwen
Maximaal 1000 Qwen-aanvragen per verwerking van een dossier, inclusief retries en tweede lezingen. Eén pagina kan meerdere aanvragen veroorzaken, bijvoorbeeld voor tekst, beeld en gerichte uitsneden.
De gedeelde capaciteit staat op maximaal 2 Qwen-requests tegelijk, voor alle apps en workers samen. Dit is apart instelbaar in beveiligd beheer. Deze limiet is een verwerkingsbudget, geen paginalimiet en geen limiet per minuut.
Upload geslaagd? Controleer ook de verwerking.
Paginalimieten worden pas tijdens de verwerking gecontroleerd. Een bestand kan dus succesvol zijn geüpload, terwijl de job daarna een paginalimietfout meldt. De HTTP-status van de upload zegt alleen of het bestand is ontvangen.
Volg de job tot een eindstatus en controleer status, recovery en de controlepunten in het resultaat. Een gedeeltelijk of mislukt resultaat mag niet als volledig verwerkt worden gebruikt. Lees het hersteladvies voordat je opnieuw aanbiedt.
Ondersteund in deze versie
- Bestanden
- PDF, PNG, JPG/JPEG en UTF-8 TXT
- Per bestand
- Maximaal 25 MiB; PDF maximaal 50 pagina’s
- Per dossier
- 20 bestanden, 100 MiB en 100 pagina’s
- API-verkeer
- 120 API-requests per minuut per app, inclusief polling
- Voortgang
- Polling; nog geen webhooks
Veelvoorkomende API-fouten
- 401 / 404
- Sleutel ongeldig of geen toegang tot dit object.
- 409
- Conflict, verzegeld dossier of resultaat nog niet gereed.
- 413 / 415
- Bestand te groot, leeg of niet ondersteund.
- 429
- Wacht volgens de Retry-After-header.
- 503
- Tijdelijk niet beschikbaar of nieuwe verwerking door beheer uitgezet. Lees de foutcode.
Instellingen.
Beheer API-sleutels, nieuwe verwerkingen en de gedeelde Qwen-capaciteit.
Verwerking & gateway
Deze instellingen gelden voor alle apps die DocLens gebruiken. Gebruik de aparte DocLens-beheersleutel.
APP-TOEGANG
API-sleutels per app
Iedere app heeft een eigen identiteit en ziet uitsluitend haar eigen dossiers. Je kunt meerdere sleutels voor dezelfde app uitgeven. Een nieuwe sleutel voor een bestaande app houdt toegang tot haar bestaande dossiers.
Sla deze sleutel nu veilig op
Dit is de enige keer dat je deze sleutel kunt kopiëren. DocLens bewaart alleen een hash. Gebruik de sleutel op de server van je app; deel hem niet in screenshots of chat.
Intrekken blokkeert nieuwe API-aanvragen met die sleutel. Lopende aanvragen en jobs kunnen nog afronden. Dossiers en andere sleutels blijven behouden. Een ingetrokken sleutel kan niet opnieuw worden geactiveerd.
Vaste verwerkingsafspraken
- Tekstmodel
- Qwen 3.8
qwen3.8 - Visionmodel
- Qwen-VL
qwen-vl - Gatewaycapaciteit
- Instelbaar in beveiligd beheer; standaard 2, gedeeld door alle workers.
- Gatewaycredentials
- Uitsluitend in de beveiligde serverconfiguratie.
Modelkeuze en credentials zijn niet via deze pagina te wijzigen.