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

# API

> Our on-prem container's API mimics Datalab's API.

Our cloud-hosted API documentation can be found [here](https://documentation.datalab.to/docs/welcome/api). With caveats and exceptions detailed below, the container image shares the same API.

<Info>
  The on-prem container currently uses `/api/v1/marker`. The new dedicated endpoints (`/convert`, `/extract`, `/segment`) will be available in a future container release.
</Info>

# Supported endpoints

The container currently supports:

* `/api/v1/marker` documented [here](https://documentation.datalab.to/docs/welcome/api#marker).  This uses both the Marker and Chandra models.
* `/api/v1/ocr` documented [here](https://documentation.datalab.to/docs/welcome/api#ocr).
* `/api/v1/usage` documented [here](/docs/on-prem/usage-analytics) — provides usage analytics and performance metrics for your on-prem deployment.

# Authentication

API authentication is not supported in the container. We assume customers will be running our image on their own infrastructure in private networks.

You may send the `X-API-Key` header detailed [here](https://documentation.datalab.to/docs/welcome/api#authentication), but it will be ignored and any value works.

# PDFs and images are supported, document conversion not yet supported

Datalab's API supports [many file types](https://documentation.datalab.to/docs/common/supportedfiletypes).

The container currently supports PDFs and image file types. Other file types are not yet supported, but will be supported in an upcoming release.

## Feature Parity

| Feature                                       | Cloud API | On-Premises                   |
| --------------------------------------------- | --------- | ----------------------------- |
| Document conversion (`/marker`)               | Yes       | Yes                           |
| OCR (`/ocr`)                                  | Yes       | Yes                           |
| Output formats (markdown, html, json, chunks) | Yes       | Yes                           |
| Parse quality scoring                         | Yes       | Yes                           |
| Chart understanding                           | Yes       | Yes (Chandra containers only) |
| Page range selection                          | Yes       | Yes                           |
| Block IDs                                     | Yes       | Yes                           |
| Token-efficient markdown                      | Yes       | Yes                           |
| Form filling (`/fill`)                        | Yes       | **No**                        |
| Create document (`/create-document`)          | Yes       | **No**                        |
| Thumbnails                                    | Yes       | **No**                        |
| Accurate mode                                 | Yes       | **No**                        |
| Fast mode                                     | Yes       | **No**                        |
| Link extraction                               | Yes       | **No**                        |
| Checkpoints                                   | Yes       | **No**                        |
| File URL download                             | Yes       | **No**                        |
| Structured extraction                         | Yes       | **No**                        |
| Document segmentation                         | Yes       | **No**                        |

<Info>
  On-premises containers do not require API key authentication. Implement access control at the network or reverse proxy level.
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Usage Analytics" icon="chart-line" href="/docs/on-prem/usage-analytics">
    Monitor request volumes, performance metrics, and system status.
  </Card>

  <Card title="Running the Container" icon="server" href="/docs/on-prem/running-the-container">
    Get the on-prem container up and running in minutes.
  </Card>

  <Card title="Cloud API Reference" icon="book" href="/docs/welcome/api">
    Full REST API reference that the on-prem container mirrors.
  </Card>

  <Card title="On-Prem Overview" icon="building" href="/docs/on-prem/overview">
    Compare open-source and paid on-prem options.
  </Card>
</CardGroup>
