Skip to main content
POST
Parse a document to Markdown via VLM

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

file
string<uri>
required

The document to parse.

model
string | null

technical_name of an enabled parser model. Falls back to platform default.

pages
string
default:all

Page range to parse. Accepted formats: "all" (default), a single page "3", a range "1-5", comma-separated pages "1,3,7", or mixed "2-4,8". Duplicates are ignored. Maximum 16 pages per request — using "all" on a document exceeding this limit returns 400. For larger documents, paginate with sequential range calls.

enable_antilooping
boolean
default:true

Detect repetitive generation loops and retry the page with progressively higher temperatures (above temperature) until the output is non-looping. Disable to get a single VLM call at the exact temperature requested.

temperature
number<double> | null
default:0.2

Sampling temperature for the VLM. Lower values (e.g. 0.1) produce more deterministic results; higher values (e.g. 1.0) increase variety. Range: 0.0–2.0.

Required range: 0 <= x <= 2
max_tokens
integer | null
default:5000

Maximum number of tokens the model can generate per page. Higher values allow longer outputs but increase processing time. Range: 1–16384.

Required range: 1 <= x <= 16384
repetition_penalty
number<double> | null
default:1

Penalizes repeated tokens to reduce redundant output. A value of 1.0 applies no penalty; higher values (e.g. 1.2) discourage repetition more strongly. Range: 1.0–2.0.

Required range: 1 <= x <= 2

Response

Document parsed successfully.

model
string
required
total_pages
integer
required
pages_parsed
integer[]
required
processing_time_ms
integer
required
enable_antilooping
boolean
required
sampling_params
object
required
pages
object[]
required