Skip to content

PDF Parser Options

Use the parsers option to control PDF parsing behavior.

parsers: [{ type: 'pdf' }]

You can also use the shorthand form:

parsers: ['pdf']
FieldMeaning
typeParser type. PDFs use pdf.
modeParsing mode: fast / auto / ocr.
maxPagesMax pages to process. A direct cost/time guardrail.
  • parsers includes PDF parsing by default (PDF → Markdown)
  • PDFs are billed per page (1 credit / page)
  • Passing an empty array parsers: [] skips PDF parsing and returns the PDF as base64 (flat 1 credit per PDF)
  • Unknown PDFs: { type: 'pdf', mode: 'auto' }
  • Text-native PDFs: { type: 'pdf', mode: 'fast' }
  • Scans/photos: { type: 'pdf', mode: 'ocr' }

Related: