Mistral Parser

Use Mistral's OCR API to extract text and page structure from a PDF uploaded to Sim or supplied by URL. The current parser returns page Markdown, image metadata, the model, and usage information. Specific Pages accepts zero-based indices such as 0,1,2; leave it empty to process all pages. The block offers Markdown, plain-text, and JSON format values, but its current result uses the structured page output documented below. Base64 image data is a hidden tool input and has no block control.

Use the block

Extract text from uploaded PDF documents, or from a URL.

Actions

Mistral PDF Parser

Parse PDF documents using Mistral OCR API

Inputs and outputs

Input

ParameterTypeRequiredDescription
filefileYesNormalized UserFile from file upload or file reference
resultTypestringNoLegacy parser output format (markdown, text, or json; default markdown). Versions 2 and 3 return structured OCR pages regardless of this value.
pagesarrayNoSpecific pages to process (array of page numbers, starting from 0)
apiKeystringYesMistral API key (MISTRAL_API_KEY)

Output

ParameterTypeDescription
pagesarrayArray of page objects from Mistral OCR
↳ indexnumberPage index (zero-based)
↳ markdownstringExtracted markdown content
↳ imagesarrayImages extracted from this page with bounding boxes
↳ idstringImage identifier (e.g., img-0.jpeg)
↳ top_left_xnumberTop-left X coordinate in pixels
↳ top_left_ynumberTop-left Y coordinate in pixels
↳ bottom_right_xnumberBottom-right X coordinate in pixels
↳ bottom_right_ynumberBottom-right Y coordinate in pixels
↳ image_base64stringBase64-encoded image data; returned only when the hidden includeImageBase64 input is enabled
↳ dimensionsobjectPage dimensions
↳ dpinumberDots per inch
↳ heightnumberPage height in pixels
↳ widthnumberPage width in pixels
↳ tablesarraySeparate table objects, referenced from the markdown via placeholders like [tbl-0.html]. Mistral populates these only when table_format is "markdown" or "html"; Sim never sets it, so tables stay inline in the markdown and this list is empty
↳ hyperlinksarrayArray of URL strings detected in the page (e.g., ["https://...", "mailto:..."])
↳ headerstringPage header content. Mistral returns it only when extract_header is true (it defaults to false); Sim never sets it, so this is not returned
↳ footerstringPage footer content. Mistral returns it only when extract_footer is true (it defaults to false); Sim never sets it, so this is not returned
modelstringMistral OCR model identifier (e.g., mistral-ocr-latest)
usage_infoobjectUsage and processing statistics
↳ pages_processednumberTotal number of pages processed
↳ doc_size_bytesnumberDocument file size in bytes
document_annotationstringStructured annotation data as JSON string (when applicable)