Which image formats can I send?

Ocus AI currently accepts JPG, PNG and TIFF formats. If you need other formats, just ask!

Is there a maximum file size ?

To optimise our processing time, we reject images over 15 megabytes. We recommend you apply lossless compression to optimise their size before sending them. If your use-case requires a different approach, let us know.

How many files can I send at once?

For maximum efficiency, we recommend that you split the images to improve in small batches as much as possible.

We enforce a limit of 800 files per batch to ensure reasonable batch completion times. Multiple batches are handled concurrently, you can send several up to the limit fixed in your subscription.

New batch creation requests are limited to 10 per minute to ensure the infrastructure stability across all our customers.

Are there rate limits?

Standard read operations to the API are limited to 60 requests per minute to protect our infrastructure against faulty implementations. Let us know if your use-case requires more.

You can track at any given point your current remaining calls using shex-ratelimit-remainingHTTP header in the response.

Can OCUS access images behind authentication?

If your website requires authentication, let us know! We will leverage your oAuth or Bearer token authentication logic.

If you do require to authenticate to multiple servers, we handle this via separate dedicated batches. Please contact us if you want specific guidance here.

How long does it take to process the images?

Regardless of your workflow, we apply every image edition capability you need at once in a single API call.

We estimate a maximum average of 30s per image on multi-capabilities use cases for the end-to-end process to download, analyse, enhance, and upload the final file to our CDN.

This processing time varies with the number of files per batch and which capabilities are selected in your workflow.

A full 800 images batch may take up to 20 minutes.

When your Workflow implies a Human-in-the-loop, response time (and quality!) will change accordingly.

Do you support realtime, instant results for individual images ?

At the moment, OCUS doesn't provide a realtime API for individual images.
Our current pipeline is optimised for workflows that scale to hundreds of thousands of images per month, which is why our design prioritises asynchronous approaches.

This design approach allowed to scale our infrastructure to handle in parallel thousands of images across tens of customers in complex analyze + enhancement workflows.

If your use-case has specific realtime needs, please reach out to your account manager.

How long is the token duration?

The token duration is set to 3650 days (~10 years).

What does a score of X mean?

Your score is a unique combination of standard image quality criteria based on our deep expertise in pro photography, and your custom guidelines criteria according your own brand and positioning.

Thus, the score computed is unique for each use-case.
Reach out to your account manager if you need more explanation on your specific scenario.