/parse/sync, /parse/async, and /parse/async_check. You can reuse the sync calls and async polling flow when you switch services. For base URLs, authentication, and upload limits, see the SoMark API overview and OXR Free API.
Request parameters
Both APIs return Markdown and JSON by default. For the full parameter lists, see SoMark sync parsing and OXR Free sync parsing.
Response fields and error codes
- The JSON output labels title and text blocks
titleandtextin SoMark, andTitleandTextin OXR Free. Account for case when filtering by type. - OXR Free omits
record_idfrom async results. Use thetask_idfrom task submission to check the result. - Both APIs use
code: 0to indicate request success. OXR Free uses1133for parameter errors and returns details inmessage. For SoMark errors, see the error code reference.
CLI, SDK, and self-hosting
To call OXR Free from the SoMark CLI or SDK, set the base URL tohttps://free-oxr.somark.ai/api/v1. With the CLI, you can set --api-key to dummy. To run the model in your own environment, see the OXR self-hosting guide.
