Help Center

Welcome to Everypixel Labs

The Everypixel API offers a suite of advanced AI-driven services. The API is built around a simple idea: you submit input data (an image, video, audio or text) to a service and it returns predictions or modifies the data.

Getting Started

Before you start working with the Everypixel API, you need to register an account. After, you get your Client ID and Secret keys by logging into your Everypixel API account and going to API Keys.

Your Client ID and Secret authenticate your API requests so that other people cannot use them. Remember that your Client ID and Secret must always be kept secret.

You can also use OAuth 2.0 authentication to improve security.

Support and Assistance

You can learn more about our algorithms and get guidance for seamless integration with our services in our API documentation. If you have any questions or need any assistance, please contact us at api@everypixel.com

Image Keywording

AI to recognize objects, people, places and actions in images and turn them into keywords.

For detailed information on how to use the API and integrate it into your application, please refer to the API documentation.

Pricing

Processing Speed

You can submit simultaneously no more than 30 requests per second. If you exceed this limit, you will see error 502. The maximum number of words that the algorithm can produce is 50.

The size of the transferred images affects the API speed. Therefore, we recommend pre-compressing images to 300px on the short side.

Image Requirements

Formats: .png and .jpg.

When processing an image, the algorithm compresses it to 300x300px. This resolution allows to keep recognition accuracy and API speed high. If you upload images in a higher resolution, this will not affect the number or relevance of keywords, but it will slow down the API speed.

The algorithm is trained on images with real objects or those that have the outlines of real ones. Therefore, it can poorly recognize objects that do not exist in our world. For example, fantasy-style images: the algorithm may not recognize some magical creatures like a unicorn or dragon, and will most likely describe the image only with general keywords such as "illustration", "fantastic plot", etc. But the algorithm successfully recognizes illustrations if the details on them have the outlines of real objects.

Stock Photography Scoring

Before you start working with the Everypixel API, you need to register an account. After, you get your Client ID and Secret by logging into your Everypixel API account and going to Profile.

Your Client ID and Secret authenticate your API requests so that other people cannot use them. Remember that your Client ID and Secret must always be kept secret.

You can also use OAuth 2.0 authentication to improve security.

UGC Photography Scoring

The model gives a score to user-generated photographs based on their technical parameters and attractiveness.

This model is designed to evaluate user photos taken both by a professional camera and by a camera of a smartphone. This model does not assess the content or aesthetic appeal of the photo but only its technical quality. It is not designed for scoring historical photos, illustrations, or 3D visualizations.

For detailed information on how to use the API and integrate it into your application, please refer to the API documentation.

Pricing

Processing Speed

You can submit simultaneously no more than 30 requests per second. If you exceed this limit, you will see error 502.

Image Requirements

Formats: .png and .jpg.

Age Recognition

This model understands how old someone looks. It extracts facial features from a photo and gives an accurate estimation of the age. Also you will get confidence score of face recognition.

For detailed information on how to use the API and integrate it into your application, please refer to the API documentation.

Pricing

Processing Speed

You can submit simultaneously no more than 10 requests per second. If you exceed this limit, you will see error 502.

Image Requirements

Formats: .png and .jpg.

Text-to-speech

This model makes it easy to convert text to speech and integrate it with business, sales, or customer support processes, as well as with applications in various technical environments.

For detailed information on how to use the API and integrate it into your application, please refer to the API documentation.

Pricing

Processing Speed

The Text-to-speech algorithm processes 1 minute of content in approximately 10 minutes. It's important to note that processing is done sequentially, meaning that if you upload multiple videos at once, they will be queued and processed one after another.

Lip Sync

By blending a video source and voiceover, this model accurately reproduces a person's lip movements in a video with speech in multiple languages.

For detailed information on how to use the API and integrate it into your application, please refer to the API documentation.

Pricing

Processing Speed

The Lip Sync algorithm processes 1 minute of content in approximately 10 minutes. It's important to note that processing is done sequentially, meaning that if you upload multiple videos at once, they will be queued and processed one after another.

File Requirements

Audio:

• Formats: .mp3 and .wav.
• No music: Ensure no music is included.
• Minimal background noise: Aim for clear, noise-free recordings.
• Clear voice recordings: The clearer the voice, the better the LipSync quality.

Video:

• Formats: .mp4 or .mov.
• Resolution: Select videos in HD or higher.
• Stability: Opt for videos with minimal camera movement.
• Head movement: Prefer videos where the head is mostly stationary, with turns under 40 degrees.
• Mouth visibility: Ensure the mouth isn't covered for extended periods in the video.
• Lighting: Pick videos where the face is evenly and fully lit.
• Eye contact: Videos with minimal eye squinting are ideal.

Image Captioning

The model generates bulk image descriptions tailored for blog posts, social media, marketplaces, and multimodal applications.

For detailed information on how to use the API and integrate it into your application, please refer to the API documentation.

Pricing

Processing Speed

You can submit simultaneously no more than 30 requests per second.

Image Requirements

Formats: .png and .jpg.

Video Keywording

keyword – the keyword that the algorithm has determined for your image.

score – the degree of relevance of the keyword to your image. The higher the score, the more precisely the keyword is defined and the higher it is on the list.

Face Swap

When processing an image, the algorithm compresses it to 300x300px. This resolution allows to keep recognition accuracy and API speed high. If you upload images in a higher resolution, this will not affect the number or relevance of keywords, but it will slow down the API speed.

The algorithm is trained on images with real objects or those that have the outlines of real ones. Therefore, it can poorly recognize objects that do not exist in our world. For example, fantasy-style images: the algorithm may not recognize some magical creatures like a unicorn or dragon, and will most likely describe the image only with general keywords such as "illustration", "fantastic plot", etc. But the algorithm successfully recognizes illustrations if the details on them have the outlines of real objects.

Reenactment

If you use the GET method to submit an image, you have to encode its URL before. We recommend using the Urlencode function to separate the image URL from the request.

It is required when the image URL contains special characters like '&' or '?'. For example, your image has the following address:

https://images.unsplash.com/photo-1564219563357-e29c471253b6?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=MnwxMTI4NzN8MHwxfGFsbHwyMjI3Nzh8fHx8fH
wyfHwxNjgzMTg1MDY3&ixlib=rb-4.0.3&q=80&w=400.

This URL contains special characters '&' or '?'. And if you pass it as a parameter to

https://api.everypixel.com/v1/keywords?url=<url>, you′ll get an error.

The algorithm can process the image, if the URL is in URL encoded form:

https%3A%2F%http://2fimages.unsplash.com/%2Fphoto-1564219563357-e29c471253b6%3Fcrop%3Dentropy%26cs%3Dtinysrgb%26fit%3Dmax%26fm%3Djpg%26ixid%3DMnwxMTI4N
zN8MHwxfGFsbHwyMjI3Nzh8fHx8fHwyfHwxNjgzMTg1MDY3%26ixlib%3Drb-4.0.3%26q%3D80%26w%3D400

When the POST method is used, URL encoding is not required.

Balance

After registering your account, you will have free limits to test our algorithm. Each algorithm has its own limits.

Limits will not be renewed once used. This applies to both API access and the use of algorithms through the Everypixel Labs interface. Once the free limit is exceeded, any additional usage will require payment. To continue using Everypixel Labs algorithms, simply top up your balance through the Balance menu in your account by clicking the Top up balance button.

If your balance is low, we will send a warning email. You can determine the minimum balance limit in your profile on the Balance page to let us know when to send you a warning.

After exceeding the number of available requests from your plan, you will see error 429.

Auto-payment

To make sure your balance is always topped up, you may want to consider enabling Auto-payment.

Why enable Auto-payment:

• Automatically top up your balance without manual intervention.
• Set threshold, one-time payment amount, and monthly limits to suit your needs.
• As with manual balance top-ups, your payment details are kept secure, and you retain full control over your payments.

How to set up Auto-payment

Before setting up, make sure you have a Payment method and Billing info on file. To fill in these details, go to the right menu and select Billing.

1. Navigate to the Balance menu in your account.
2. Enter the following details in the Auto-payment block:
   Replenishment threshold: The balance amount at which auto-payment should be triggered.
   One-time payment: The amount to be automatically debited when the threshold is reached.
   Monthly limits: The maximum amount of auto-payments allowed per calendar month.
   
3. Click on the Save and activate button. An email notification will confirm that Auto-payment has been activated.

How to turn Auto-payment off

1. Navigate to the Balance menu in your account.
2. In the Auto-payment block click the Disable button. The button will revert to Save and activate, indicating that Auto-payment has been disabled.

How to update auto-payment details

1. Navigate to the Balance menu in your account.
2. In the Auto-payment block click the Disable button. The button will revert to Save and activate, indicating that Auto-payment has been disabled. This allows you to update your auto-payment details and then re-enable the option.
3. Adjust the replenishment threshold, one-time payment and monthly limits as needed.
4. Click Save and activate to apply the changes. You will receive an email notification confirming that Auto-payment has been activated.

Steps to take if an auto-payment fails

1. Review your billing history in the Billing menu and auto-payment details in the Balance menu. Ensure your monthly limit has not been exceeded.
2. Verify your payment method in the Billing menu. Make sure your payment method is on file, up to date and has sufficient funds.
3. Check your billing info in the Billing menu. Ensure that your billing address is on file and current.

If issues persist, please contact our support team at api@everypixel.com for further assistance.

Errors

Most of the errors returned by the API contain text in json format.

In addition, you may receive HTTP status codes with the following errors:

400: This error occurs when the request is incorrect, such as including the wrong type of argument.

401: This error occurs if the login credentials are incorrect or the access token has expired.

403: This error occurs if the account is not activated or access to the API endpoint is restricted for some reason.

415: This error occurs if the file cannot be opened due to being broken or in an unsupported format.

429: This error occurs if you have exceeded the number of available requests in your plan.

500: This error occurs due to an issue on our side. Please try again later.

502: This error occurs if you have reached the maximum number of concurrent requests or if the API is not functioning properly.

503: This error occurs if the service is temporarily unavailable.

If you encounter an error not listed here, please contact our support team via email at api@everypixel.com for assistance.