Skip to main content
The SoMark API and OXR Free API share /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 title and text in SoMark, and Title and Text in OXR Free. Account for case when filtering by type.
  • OXR Free omits record_id from async results. Use the task_id from task submission to check the result.
  • Both APIs use code: 0 to indicate request success. OXR Free uses 1133 for parameter errors and returns details in message. 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 to https://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.