Skip to content

API Calls and Credits

Ximilar billing is based on the number of API method calls. To differentiate between different complexity of the methods, every api call corresponds to a certain number of credits. New Ximilar users have some free monthly credits to be used for testing. Then, there are several pricing plans with different amount of available credits and other limits. You can see the number of credits you have used in current month in the Ximilar app dashboard.

Credits in general

In general, each API call that sends (uploads) an image to Ximilar API endpoint costs one credit. All other methods are for free and some special complex methods that combine several functions can cost more than one credit.

Every record counts!

Some methods allow to send more than one image at once via records field. For the purpose of billing, every record counts as single request (typically as one credit). However processing batch (multiple) records in one request is faster than sending multiple requests with one record.

Credits in detail

Here is a list of all API methods and their credit value. We show only methods that are not for free (all other are).

Ximilar Custom Recognition (Vize.ai)

Path Description Number of credits
/recognition/v2/classify Classifying images by a custom recognition task 1.0
/recognition/v2/training-image Uploading a training image to custom recognition 1.0

Generic & Fashion Tagging

Path Description Number of credits
/tagging/generic/v2/tags Get tags for a generic photo 1.0
/tagging/fashion/v2/tags Get category and tags for product photo with apparel, footwear, bags, etc. 2.0

Photo & Product Similarity

Prefixes

https://api.ximilar.com/similarity/photos/v2/<method> https://api.ximilar.com/similarity/products/v2/<method> https://api.ximilar.com/<your_private_cloud_service>/v2/<method>

Path Description Number of credits
/*/v2/insert Insert an image into your collection 1.0
/*/v2/visualKNN Find visually similar images to a given image from the collection 0.25 or 1.0
/*/v2/visualTagsKNN Find images that are similar based on combination of visual and tags similarity 0.25 or 1.0
/*/v2/visualKNNMulti Find visually similar images from the collection to a given list of images 0.25 or 1.0
/*/v2/visualTagsKNNMulti Find images that are similar to a given list of images based on combination of visual and tags similarity 0.25 or 1.0
/*/v2/nearDuplicates finds those images in the collection that are the same or very similar to the query image 0.25 or 1.0
/*/v2/range find visually similar images to a given image from the collection up to a certain query radius 0.25 or 1.0

The credit price of all the search queries is * 0.25 in case the query object(s) is specified by field _id; this means that the query object is already in the index and it's just read from the, * 1.0 in case the query is external - specified by _url or _base64; in this case, the image must be preprocessed on GPU, which is more costly.

Path Description Number of credits
/smart/v2/product/search Detect products on real photo, get product tags & find similar products 10.0
/smart/v2/product/detect Detect products on real photo and return product tags 8.0
/smart/v2/product/search_by_object Search similar products on photo with an already detected object 2.0
/smart/v2/product/insert Insert a product image into your collection 5.0

Ximilar Custom Object Detection

Path Description Number of credits
/detection/v2/detect Detect custom objects on an image 4.0