> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SoMark and OXR integration differences

> Compare request parameters, response fields, and CLI configuration for the SoMark API and OXR Free API.

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](https://docs.somark.ai/en/api-reference/index.md) and [OXR Free API](https://docs.somark.ai/en/open-source-tools/oxr.md#oxr-free-api).

## Request parameters

| Parameter | SoMark API | OXR Free API |
| - | - | - |
| File submission | Upload `file` or provide `file_url` | Upload `file` directly |
| `output_formats` | Supports `markdown`, `json`, and `zip` | Supports `markdown` and `json`. Requesting `zip` returns a parameter error |
| `feature_config` | Supports options such as cross-page merging, title level recognition, and image understanding | Supports only `keep_header_footer`. If you enable the other listed options, OXR ignores them and adds a message to `warnings` |
| `element_formats.cs` | Returns chemical structures as images by default | Defaults to `smiles`. Set it to `image` to request images |

Both APIs return Markdown and JSON by default. For the full parameter lists, see [SoMark sync parsing](https://docs.somark.ai/en/api-reference/endpoint/sync.md) and [OXR Free sync parsing](https://docs.somark.ai/en/open-source-tools/oxr/sync.md).

## 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](https://docs.somark.ai/en/api-reference/errors.md).

## CLI, SDK, and self-hosting

To call OXR Free from the [SoMark CLI or SDK](https://docs.somark.ai/en/cli-sdk/index.md), 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](https://docs.somark.ai/en/open-source-tools/oxr/index.md#self-hosting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.