AI Compute API

You need an API token to make requests to Image Processing API.

Instructions are available in the Obtaining an API Key section.

Introduction

This reference is your key to a comprehensive understanding of the Image Processing API.

Conventions

The base URL to send all API requests is https://processing.studio.liftdata.ai.

HTTPS is required for all API requests.

Pagination

By default, API returns ten items per call. If the number of items in a response from a support endpoint exceeds the default, then an integration can use pagination to request a specific set of the results and/or to limit the number of returned items.

Request Limits

To ensure a consistent developer experience for all API users, the API is rate limited and basic size limits apply to request parameters.

Rate Limits

Rate-limited requests will return a "rate_limited" error code (HTTP response status 429). The rate limit for incoming requests is set to 1000 requests per account. Rate limit is only applied to Create image processing request endpoint.

In the future, we plan to adjust rate limits to balance for demand and reliability. If you want to increase your rate limit please contact LIFT’s support team.

Status Codes

HTTP response codes are used to indicate general classes of success and error.

Success Code

HTTP Status Code

Description

200

Successfully processed request.

201

Successfully processed request.

Error Codes

Error responses contain more detail about the error in the response body, in the "detail" property.

HTTP Status Code

detail

401

Not authenticated

404

Resource is not found

422

Will contain information about exactly which fields are missing in the request body

429

Too many requests

Endpoints

Endpoint
Method
URL
Description

POST

/requests

Creates a processing request for an image send in the request body

GET

/requests/models/%model_id%

Returns a paginated list of data extracted from the images

Obtaining an API Key

To obtain an API key:

  1. Visit the Studio at https://studio.liftdata.ai

  2. Navigate to the API Key section

  3. Click on the New Key button and name your key

  4. Copy and save your API key as you won’t be able to see it once the pop-up is closed

Last updated