Parameters

The only required parameter is files - the file you wish to process.

POST, PythonJavaScript/TypeScriptDescription
files (shared.Files)files (File, Blob, shared.Files)The file to process.
chunking_strategy (str)chunkingStrategy (string)Use one of the supported strategies to chunk the returned elements after partitioning. When no chunking strategy is specified, no chunking is performed and any other chunking parameters provided are ignored. Supported strategies: basic, by_title, by_page, and by_similarity. Learn more.
coordinates (bool)coordinates (boolean)True to return bounding box coordinates for each element extracted with OCR. Default: false. Learn more.
encoding (str)encoding (string)The encoding method used to decode the text input. Default: utf-8.
extract_image_block_types (List[str])extractImageBlockTypes (string[])The types of elements to extract, for use in extracting image blocks as Base64 encoded data stored in element metadata fields, for example: ["Image","Table"]. Supported filetypes are image and PDF. Learn more.
gz_uncompressed_content_type (str)gzUncompressedContentType (string)If file is gzipped, use this content type after unzipping. Example: application/pdf
hi_res_model_name (str)hiResModelName (string)The name of the inference model used when strategy is hi_res. Options are layout_v1.1.0 and yolox. Default: layout_v1.1.0. Learn more.
include_page_breaks (bool)includePageBreaks (boolean)True for the output to include page breaks if the filetype supports it. Default: false.
languages (List[str])languages (string[])The languages present in the document, for use in partitioning and OCR. View the list of available languages. Learn more.
output_format (str)outputFormat (string)The format of the response. Supported formats are application/json and text/csv. Default: application/json.
pdf_infer_table_structure (bool)pdfInferTableStructure (boolean)Deprecated! If true and strategy is hi_res, any Table elements extracted from a PDF will include an additional metadata field, text_as_html, where the value (string) is a just a transformation of the data into an HTML table.
skip_infer_table_types (List[str])skipInferTableTypes (string[])The document types that you want to skip table extraction for. Default: [].
starting_page_number (int)startingPageNumber (number)The page number to be be assigned to the first page in the document. This information will be included in elements’ metadata and can be be especially useful when partitioning a document that is part of a larger document.
strategy (str)strategy (string)The strategy to use for partitioning PDF and image files. Options are fast, hi_res, ocr_only, and auto. Default: auto. Learn more.
unique_element_ids (bool)uniqueElementIds (boolean)True to assign UUIDs to element IDs, which guarantees their uniqueness (useful when using them as primary keys in database). Otherwise a SHA-256 of the element’s text is used. Default: false.
xml_keep_tags (bool)xmlKeepTags (boolean)True to retain the XML tags in the output. Otherwise it will just extract the text from within the tags. Only applies to XML documents.

The following parameters only apply when a chunking strategy is specified. Otherwise, they are ignored. Learn more.

POST, PythonJavaScript/TypeScriptDescription
combine_under_n_chars (int)combineUnderNChars (number)Applies only when the chunking strategy is set to by_title. Use this parameter to combines small chunks until the combined chunk reaches a length of n characters. This can mitigate the appearance of small chunks created by short paragraphs, not intended as section headings, being identified as Title elements in certain documents. Default: the same value as max_characters.
include_orig_elements (bool)includeOrigElements (boolean)True (the default) to have the elements that are used to form a chunk appear in .metadata.orig_elements for that chunk.
max_characters (int)maxCharacters (number)Cut off new sections after reaching a length of n characters. (This is a hard maximum.) Default: 500.
multipage_sections (bool)multipageSections (boolean)Applies only when the chunking strategy is set to by_title. Determines if a chunk can include elements from more than one page. Default: true.
new_after_n_chars (int)newAfterNChars (number)Applies only when the chunking strategy is specified. Cuts off new sections after reaching a length of n characters. (This is a soft maximum.) Default: 1500.
overlap (int)overlap (number)A prefix of this many trailing characters from the prior text-split chunk is applied to second and later chunks formed from oversized elements by text-splitting. Default: none.
overlap_all (bool)overlapAll (boolean)True to have an overlap also applied to “normal” chunks formed by combining whole elements. Use with caution, as this can introduce noise into otherwise clean semantic units. Default: none.

The following parameters are specific to the Python and Javascript/TypeScript clients and are not sent to the server. Learn more.

POST, PythonJavaScript/TypeScriptDescription
split_pdf_page (bool)splitPdfPage (boolean)True to split the PDF file client-side. Learn more.
split_pdf_concurrency_level (int)splitPdfConcurrencyLevel (number)The number of split files to be sent concurrently. Default: 5. Maximum: 15.

Need help getting started? Check out the Examples page for some inspiration.