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. Formats: "all", "1-5", "1,3,7", "2-4,8". Maximum 16 pages per request. For larger documents, make multiple calls with different page ranges.

enable_antilooping
boolean
default:true

When enabled, detects repetitive generation loops and gradually increases the sampling temperature to break out of them.

temperature
number<double> | null
default:0.2

Controls the randomness of the model output. 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