---
title: "XI Parallax"
description: "Register images with the XI Parallax engine so they can be found again, and look images up to learn whether they are already registered."
published: 2026-09-21T23:43:23.801945+00:00
updated: 2026-09-21T23:43:23.801945+00:00
url: https://xiobjects.com/docs/xio/parallax
source: XI Objects
---

<!-- xion:doctype xion+markdown -->
<!-- xion:metadata
{
  "version": "1.0",
  "content_type": "application/xion\u002Bmarkdown",
  "source_type": "xi-content/doc",
  "generator": "xio-content-publisher/1.0.0",
  "generated": "2026-09-21T23:42:08.3489329\u002B00:00",
  "encoding": "utf-8",
  "render_intent": "markdown",
  "title": "XI Parallax",
  "slug": "xio/parallax",
  "copyright": "\u00A9 2026 XI Objects Inc"
}
-->

# XI Parallax

XI Parallax registers images so they can be found again. You send an image and, optionally, the manifests you want kept with it. Parallax derives what the engine needs, discards your pixels, and records the registration. Later, anyone can send an image to the look-up surface and learn whether it is registered. If the match is yours, you get your registration id and the manifests you registered with it back.

The API is a private beta. An operator mints an API token for your account and gives it to you. Every route except the health check requires that token.

Base URL: `https://api.parallax.xiobjects.com`

## How to read this collection

Start with [Getting Started](/docs/xio/parallax/getting-started). It covers the token, the health check, the error shape, and a full first pass: register an image, look it up, take it down.

After that, pick the page for the job you are doing. The guides explain the order of calls and what each answer means. The [REST API reference](/docs/xio/parallax/api/rest) lists every endpoint with its request fields, response shapes and statuses.

## Pages

- [Getting Started](/docs/xio/parallax/getting-started): the token, the health check, the OpenAPI document, the error shape, and a first end to end pass.
- [Register a single image](/docs/xio/parallax/register-single-image): one image in one request, and what each refusal means.
- [Register in batches](/docs/xio/parallax/register-in-batches): the slot conversation, upload, resume, commit, progress.
- [Look up a single image](/docs/xio/parallax/look-up-single-image): one image in, one verdict out.
- [Look up in batches](/docs/xio/parallax/look-up-in-batches): the look-up slot conversation and its results.
- [Manifests](/docs/xio/parallax/manifests): what a manifest is here, how to state one, and what comes back.
- [Take down a registration](/docs/xio/parallax/take-down): stop an image matching.
- [Quotas and stats](/docs/xio/parallax/quotas-and-stats): what you are granted, what spends it, and how to read your usage.
- [Custody and privacy](/docs/xio/parallax/custody-and-privacy): what happens to your pixels, what is stored, and what another account can learn.
- [Errors and refusals](/docs/xio/parallax/errors-and-refusals): every status and every refusal reason, with what to do about each.
- [REST API reference](/docs/xio/parallax/api/rest): the endpoint by endpoint contract.
- [Changelog](/docs/xio/parallax/changelog): what changed and when.
<!-- xion:trust
{
  "v": 1,
  "canon_v": 1,
  "ctx": "xiobjects.com/content",
  "hash_blake3_hex": "9df85078ca10674a43eaa43e140b1bc49ce26278d8ff8a9435c06a3df442bf77",
  "hash_sha256_hex": null,
  "sig_alg": "ed25519",
  "sig_b64": "_77w7K4GNwLzqlzk2dqJakOKEBgxFjFqkOYn4Ws1nOHUrwH_ddQZrzrGZ7lL6Dc84pFgMoIUKZU3Bpr3iKP3DQ",
  "pubkey_b64": "VrV0rqYGnIqutEwPTr11jfrjH9wmtkOlL68wL0W6ed0",
  "x509_chain_pem": [
    "-----BEGIN CERTIFICATE-----\nMIIB9DCCAaagAwIBAgIQbmGqXUijS3XuRUHDuVME8jAFBgMrZXAwLjEsMCoGA1UE\nAwwjWEkgT2JqZWN0cyBJbmMgQ29udHJvbCBJbnRlcm1lZGlhdGUwHhcNMjYwOTIx\nMjMzNjU1WhcNMjYxMDIxMjMzNjU1WjBLMR4wHAYDVQQDDBV4aW8tY29udGVudC1w\ndWJsaXNoZXIxFzAVBgNVBAoMDlhJIE9iamVjdHMgSW5jMRAwDgYDVQQLDAdDb250\nZW50MCowBQYDK2VwAyEAVrV0rqYGnIqutEwPTr11jfrjH9wmtkOlL68wL0W6ed2j\ngbwwgbkwDAYDVR0TAQH/BAIwADAOBgNVHQ8BAf8EBAMCB4AwEwYDVR0lBAwwCgYI\nKwYBBQUHAyQwZQYDVR0jBF4wXIAUOym3mFmw/qs1fgKrujCkxhrTk7KhLqQsMCox\nKDAmBgNVBAMMH0luc3RpdHV0ZSBvZiBQcm92ZW5hbmNlIFJvb3QgQ0GCFFJgN/ix\nQn72H6h3T5lEr9f8lJQFMB0GA1UdDgQWBBTnptRqwN8T\u002B5J0zUSRl65iscaPUzAF\nBgMrZXADQQBTzG1wSuUk70ymEN3Mj6XxsS1c5egjDoy\u002BW/V2kko5c2a1Cs7c/kiD\n6H2y9z1DNSH5qjzLZcm9JKPN0mjCy8MO\n-----END CERTIFICATE-----\n",
    "-----BEGIN CERTIFICATE-----\nMIIByDCCAXqgAwIBAgIUUmA3\u002BLFCfvYfqHdPmUSv1/yUlAUwBQYDK2VwMCoxKDAm\nBgNVBAMMH0luc3RpdHV0ZSBvZiBQcm92ZW5hbmNlIFJvb3QgQ0EwHhcNMjUxMTAy\nMDMxNzEyWhcNMzAxMTAxMDMxNzEyWjAuMSwwKgYDVQQDDCNYSSBPYmplY3RzIElu\nYyBDb250cm9sIEludGVybWVkaWF0ZTAqMAUGAytlcAMhAFSS/pggSRmTcAMko7uc\nATH8OHgxVymd5mBFlPXbJkgio4GtMIGqMBIGA1UdEwEB/wQIMAYBAf8CAQAwDgYD\nVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBQ7KbeYWbD\u002BqzV\u002BAqu6MKTGGtOTsjBlBgNV\nHSMEXjBcgBQAZRTDswSVORu\u002BkUOKX6WvrOvmQKEupCwwKjEoMCYGA1UEAwwfSW5z\ndGl0dXRlIG9mIFByb3ZlbmFuY2UgUm9vdCBDQYIUJqoJlpiSFg\u002B7W5IJLMrLttgR\nQp4wBQYDK2VwA0EA5FOht7YOsVRPp/FOKMQ\u002B3Mo9JxrvGR3ylKWAWNm6OUV7N3DB\nI9cD62wU5I0d0EKDBy0CX9DnoqUyxv5yguraAA==\n-----END CERTIFICATE-----\n",
    "-----BEGIN CERTIFICATE-----\nMIIBaTCCARugAwIBAgIUJqoJlpiSFg\u002B7W5IJLMrLttgRQp4wBQYDK2VwMCoxKDAm\nBgNVBAMMH0luc3RpdHV0ZSBvZiBQcm92ZW5hbmNlIFJvb3QgQ0EwHhcNMjUxMTAy\nMDMwNTEyWhcNMzUxMDMxMDMwNTEyWjAqMSgwJgYDVQQDDB9JbnN0aXR1dGUgb2Yg\nUHJvdmVuYW5jZSBSb290IENBMCowBQYDK2VwAyEAEWNZl\u002Br3IC7\u002BgBh90Yo1kWk1\npZCVzVuFdFT7qBBU8W2jUzBRMB0GA1UdDgQWBBQAZRTDswSVORu\u002BkUOKX6WvrOvm\nQDAfBgNVHSMEGDAWgBQAZRTDswSVORu\u002BkUOKX6WvrOvmQDAPBgNVHRMBAf8EBTAD\nAQH/MAUGAytlcANBAO6QeydOFNrN75qNyftggYudsxMyl4w9qWkSdZ6hlhrRcbSr\niG9Si0kbrIJOwYB/LTBU0RM4Rl\u002Bo9PM3Qp0mPwo=\n-----END CERTIFICATE-----\n"
  ],
  "key_id": "_A4EpsXvfBfVEGu5deK65yN4EjBJsUpgkdoS25zPEFk",
  "created_at": "2026-09-21T23:42:08Z"
}
-->