The Kimera Technologies API is a set of AI Computer Vision solutions available as a web service that allows you to automate the process of analyzing, organizing and searching through large databases of unstructured visual content.
\nOur SaaS (software as a service) is hosted within our cloud infrastructure and is available on a subscription basis, making it easily accessible, flexible and scalable. Accessing our platform is fast and easy, simply Sign Up and start sending requests to our REST API.
\nLet's get started.
\nThe first thing you should do to start enjoying the potential of Kimera's tools is to register in our website kimeratechnologies.com or via API (see SignUp below). The process will take 5 minutes from your time to set everything up! After that we will send you a message and you are ready to go!
\nCurrently the supported method for authentication is via Basic Auth with credentials (username and password) generated during your sign up. You can find them in your Kimera dashboard or in your registration email being.the username your UserID generated by us and the password you provided. You should not share this with anyone from outside your organisation as it is the entrance to your profile, data and features.
\nDespite the unlimited potential and use you could make from our API you will be limited to specific features and data based on your subscription plan. You can find more information here.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"Start","slug":"start"},{"content":"Authentication","slug":"authentication"},{"content":"Rate limit","slug":"rate-limit"}],"owner":"19208630","collectionId":"f47d0561-ed83-4187-a178-9c6449cbd9a2","publishedId":"UVyuSFRg","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-04-05T10:39:39.000Z"},"item":[{"name":"User configuration","item":[{"name":"SignUp","id":"d792eb78-8ed0-40b2-8b13-0c1cfc8d169c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"email","value":"postman@mail.com","description":"Your email to which you want to associate the account
\n","type":"text"},{"key":"name","value":"postman","description":"Your name so we can address to you properly
\n","type":"text"},{"key":"password","value":"postman","description":"A secure password
\n","type":"text"},{"key":"company","value":"postman","description":"Your company's name
\n","type":"text"}]},"url":"https://api.kimeratechnologies.com/signup","description":"As mentioned above, the first thing to do is to sign up and start becoming part of our community! For this process we will only need basic information as your name (so we can address you properly), your email, a password for your account, and if applicable, your company name, so we can work to provide the best products to your industry! (if you do not have one just write \"None\")
\n","urlObject":{"protocol":"https","path":["signup"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d792eb78-8ed0-40b2-8b13-0c1cfc8d169c"},{"name":"Reset Password","id":"1982c5bb-cb83-4b8d-bad3-260a5c904249","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"email","value":"postman@mail.com","description":"Your email to which you want us to send the recovery link
\n","type":"text"}]},"url":"https://api.kimeratechnologies.com/change_password_send_link","description":"Everyone forgets things, even the important ones. If you forget your password, we can help you. We will send a unique link to your email address which will expire in 15 minutes. By clicking the link you will be redirected to our website where you will be able to set a new password and access your profile.
\n","urlObject":{"protocol":"https","path":["change_password_send_link"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1982c5bb-cb83-4b8d-bad3-260a5c904249"},{"name":"Activate API","id":"c031af0c-5eae-496a-8bd3-0998702c9e37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"For your convenience and safety, the API needs to be activated every session (or after 1h of inactivity). In this process we will get everything ready for you!
\n","urlObject":{"protocol":"https","path":["activate"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c031af0c-5eae-496a-8bd3-0998702c9e37"},{"name":"Deactivate API","id":"64b5a7e4-b85f-4746-a475-6da49de9f449","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"If you are done and you want to close the door to your data, you can deactivate the API. However, this process will be undertaken automatically after 1 hour of inactivity (for safety purposes in case you forget).
\n","urlObject":{"protocol":"https","path":["deactivate"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"64b5a7e4-b85f-4746-a475-6da49de9f449"},{"name":"Status","id":"1b42087f-5042-4673-8db0-6dd3453536d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Once you are logged in, you can check the status of your account, the iid, the name, the number of processed files and more.
\n","urlObject":{"protocol":"https","path":["status"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1b42087f-5042-4673-8db0-6dd3453536d1"}],"id":"2053c4f8-c8e8-4565-bb35-e122174d0738","description":"Let's start from the begining. The first steps will be to set up everything in your account. From creating it to activating your API and checking it's status. Here is where you will find all endpoints for the API configuration and user managment
\n","_postman_id":"2053c4f8-c8e8-4565-bb35-e122174d0738"},{"name":"Text Tagger","item":[{"name":"Create Text Dictionaries","id":"bd72d653-0e79-4e59-898d-293c6923ffb7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"With this endpoint you will be able to update the dictionaries applied to your data base. In Kimera we work with dictionaries that contain tags, so you can have everything well organized. Sometimes you want to apply a set of tags or others, here you create dictionaries providing a name and the list of tags it contains.
\n","urlObject":{"protocol":"https","path":["tagger","text","create_dictionary"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"Give your dictionary a name so you remember which tags it contains. If the name is the same than a previous dictionary, it will be updated to this new list of tags. If it matches the name of one of our general dictionaries, we will ask you to set a different one.
\n","type":"text/plain"},"key":"dictionary","value":"person"},{"description":{"content":"Give as a list of the tags you want for your dictionary so we can find them in your content. Tags should be separated by a \",\" without spaces.
\n","type":"text/plain"},"key":"tags","value":"girl,boy,man,woman,group"}],"variable":[]}},"response":[],"_postman_id":"bd72d653-0e79-4e59-898d-293c6923ffb7"},{"name":"Load Text Dictionaries","id":"0f8a1294-ded4-4683-9627-fbb2c85db5ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Before using any tags, you need to let us know which dictionary from your entire library you want to use, so we can load it!
\n","urlObject":{"protocol":"https","path":["tagger","text","load_dictionary"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"Provide us the name of the dictionary you want to load before you start tagging your content.
\n","type":"text/plain"},"key":"dictionary","value":"person"}],"variable":[]}},"response":[],"_postman_id":"0f8a1294-ded4-4683-9627-fbb2c85db5ce"},{"name":"Delete Text Dictionaries","id":"2720a89b-1cd0-4887-bf18-5e76254392bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"As many things in life, dictionaries are not forever. With this endpoint you will be able to delete the dictionaries that you no longer need. But be sure about it, as this action cannot be undone.
\n","urlObject":{"protocol":"https","path":["tagger","text","delete_dictionary"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"Provide us the name of the dictionary you want to delete.
\n","type":"text/plain"},"key":"dictionary","value":"person"}],"variable":[]}},"response":[],"_postman_id":"2720a89b-1cd0-4887-bf18-5e76254392bc"},{"name":"Check Text Dictionaries","id":"11b1c603-f350-4904-a41c-14a150e0fdca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"As you use Kimera, you will start to create a large list of dictionaries for all the possibilities you want to exploit. You might end up forgetting how many you have and their names, but have no fear, you can check them every time you need.
\n","urlObject":{"protocol":"https","path":["tagger","text","check_dictionaries"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"11b1c603-f350-4904-a41c-14a150e0fdca"},{"name":"Check Active Tags","id":"becc29de-5311-4b76-bde9-1cd86f4b3f41","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Now you know the dictionaries you have and you can activate one of them. Still having difficulties to remember the tags in a dictionary? No problem, we will help you remember this too. We can let you know which tags are currently active in the dictionary you last loaded. These tags will be the ones applied to your content.
\n","urlObject":{"protocol":"https","path":["tagger","text","get_active_tags"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"becc29de-5311-4b76-bde9-1cd86f4b3f41"},{"name":"Tag Image","id":"fac322eb-7f6b-48b6-9007-af9471717909","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Here is where the magic begins. Now we are all set for you to start enjoying the powerful AI tools of Kimera. From now on, you have your account active, your dictionary loaded and the tags you want to discover in your images. The only remaining part is the most important one! Provide your content and we will tag it for you in milliseconds. No more manual tagging, everything in a single click!
\n","urlObject":{"protocol":"https","path":["tagger","text","tag_image"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"Here you should give us the image url so we can take a quick look at it and understand what it is.
\n","type":"text/plain"},"key":"image_id","value":"https://kimeratechnologies.com/wp-content/uploads/2022/03/kimera-colors-pequena.jpg"},{"description":{"content":"Sometimes images might not have what you are looking for. However, you can set a minimum amount of tags to all images. If you chose 0, the images that do not reach our high standards will not be tagged. If you set 1, all images will have at least one tag. 2 will mean that all images will have at least two tags, and so on.
\n","type":"text/plain"},"key":"min_tags","value":"1"},{"description":{"content":"We are very confident about what we say, but we cannot be absolutely certain at all times, nobody can. Therefore, here you can set your desired confidence level (from 0 to 1) for our algorithm to decide if the tag is applied or not. Tags below the confidence range will not be applied unless it hasn't reached the minimum tags for an image yet.
\n","type":"text/plain"},"key":"confidence","value":"0.2"}],"variable":[]}},"response":[],"_postman_id":"fac322eb-7f6b-48b6-9007-af9471717909"}],"id":"614a453b-0150-4372-873e-463c987379ef","description":"The first of Kimera Technologies' tool: Text Tagger. This solution allows you to freely define a dictionary of tags and apply it in your data base. You will be able to tag all your multimedia content with the tags you need, not the ones set by us, not the ones set by big companies or scientifics, the ones set by the most important person here, you! You know what you need to find in your content and we are here to help you.
\n","_postman_id":"614a453b-0150-4372-873e-463c987379ef"},{"name":"Visual Tagger","item":[{"name":"Update Visual Dictionaries","id":"2db04222-d8c5-4764-9169-35036d960fef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"The first thing is to create the visual tags you want to use. For each tag we need you to provide a group of reference images that will be the ones that define the tag. As you provide more pictures, we will have more information about how that \"tag\" looks, hence achieving better performance. We want to become experts, so show us as many examples as you wish.
\n","urlObject":{"protocol":"https","path":["tagger","visual","add_image_to_tag"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"Provide us the name of the dictionary you want to load before you start tagging your content.
\n","type":"text/plain"},"key":"img_url","value":"http://kimeratechnologies.com/wp-content/uploads/2022/04/Alvaro.jpg"},{"description":{"content":"The tag this image is related to. You can accumulate several reference images under the same tag. The more images you provide to describe the tag, the better. If the tag does not already exist we will create it, if it does, we will group the pictures.
\n","type":"text/plain"},"key":"tag","value":"human"}],"variable":[]}},"response":[],"_postman_id":"2db04222-d8c5-4764-9169-35036d960fef"},{"name":"Check Active Tags","id":"fcbb85e2-1cbb-4b9e-a24d-25fdc1329e96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Now you know the dictionaries you have and you can activate one of them. Still having difficulties to remember the tags in a dictionary? No problem, we will help you remember this too. We can let you know which tags are currently active in the dictionary you last loaded. These tags will be the ones applied to your content.
\n","urlObject":{"protocol":"https","path":["tagger","visual","get_active_tags"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fcbb85e2-1cbb-4b9e-a24d-25fdc1329e96"},{"name":"Tag Image","id":"7d233783-1acc-42c4-86a0-4b14ff2a65a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Here is where the magic begins. Now we are all set for you to start enjoying the powerful AI tools of Kimera. From now on, you have your account active, your dictionary loaded and the tags you want to discover in your images. The only remaining part is the most important one! Provide your content and we will tag it for you in milliseconds. No more manual tagging, everything in a single click!
\n","urlObject":{"protocol":"https","path":["tagger","visual","tag_image"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"Here you should give us the image url so we can take a quick look at it and understand what it is
\n","type":"text/plain"},"key":"image_id","value":"https://kimeratechnologies.com/wp-content/uploads/2022/03/kimera-colors-pequena.jpg"},{"description":{"content":"We are very confident about what we say, but we cannot be absolutely certain at all times, nobody can. Therefore, here you can set your desired confidence level (from 0 to 1) for our algorithm to decide if the tag is applied or not. Tags below the confidence range will not be applied unless it hasn't reached the minimum tags for an image yet.
\n","type":"text/plain"},"key":"confidence","value":"0.3"}],"variable":[]}},"response":[],"_postman_id":"7d233783-1acc-42c4-86a0-4b14ff2a65a4"}],"id":"f9ee1dc1-aa67-4e90-b9e8-aff79ec5cd39","description":"The next generation of tagger tools: Visual Tagger. This solution allows you to tag content relating it to other pictures. Sometimes it is hard to describe a picture and easier to find it using a similar one, or maybe the valuable \"data\" is easier to determine visually than textually. For this task we built a visual tagger that allows you to define a group of pictures as the reference group and tag new pictures into the most similar group you have. Let us find the similarities for you!
\n","_postman_id":"f9ee1dc1-aa67-4e90-b9e8-aff79ec5cd39"},{"name":"Images Database","item":[{"name":"Upload csv file","id":"14c0aeb4-6057-4c6d-b286-015ec9b8bae9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"The .csv file that contains the URLs to all your content. Remember that we are a machine, therefore, we cannot understand what is going on inside your head. We kindly ask you to send an organized and structured .csv file. If there are errors in it, we won’t be able to know. So please double check so we can help you in the best possible way!
\n","type":"file","src":"ZW90Kwb1c/passporter_medias.csv"}]},"url":"https://api.kimeratechnologies.com/DB/build_from_csv?separator=,","description":"We cannot work without knowing your content. We try to give you the easiest way to upload your content. In this case you can upload it with a .csv file containing the following:
\nHow do you separate the elements in the csv file.
\n","type":"text/plain"},"key":"separator","value":","}],"variable":[]}},"response":[],"_postman_id":"14c0aeb4-6057-4c6d-b286-015ec9b8bae9"},{"name":"Check metadata fields","id":"cfadf7a0-4ab2-4ccf-9633-659a5f73f645","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"You might forget which metadata you have stored and in which order while uploading your .csv file. Here you can check which metadata is available for you to use it with our system! Feel free to check as many times as you need.
\n","urlObject":{"protocol":"https","path":["DB","get","metadata_fields"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"cfadf7a0-4ab2-4ccf-9633-659a5f73f645"},{"name":"Text search","id":"10264ecd-21a0-4019-a932-faba42942f46","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"We are all set, let’s go with the first tool: Image text search! Provide any text description (a sentence, a word, a description) and we will go through all your data in seconds, so you can find what you are looking for! We can even help you filter your content by the metadata you set while uploading the content. So don't hesitate, give us as much work as you need, we are not lazy!
\n","urlObject":{"protocol":"https","path":["DB","image_search"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"What are you looking for? Give us the text description and we will look for it. The better you describe it, the better the result it will deliver.
\n","type":"text/plain"},"key":"image_search","value":"Sunset with trees in the mountain"},{"description":{"content":"Do you need to filter the database through some metadata parameters? Here you can build filters and we will look for your description only in those images that match your filtering.
\n","type":"text/plain"},"key":"filter_query","value":"lat>11.25 & long<0"},{"description":{"content":"We will sort your items depending how they match with the description. Which is the first item you want to receive? Usually it will be the top scoring (init_item = 0) but who knows, more is not always better.
\n","type":"text/plain"},"key":"init_item","value":"0 "},{"description":{"content":"But what we do need from you is that you indicate us where to stop. How many extra items (in addition to the first one) you want us to return ordered by score? You probably don’t need infinite results, so the shorter the better, so we can perform faster, but give us enough room to find what you need.
\n","type":"text/plain"},"key":"last_item","value":"10"}],"variable":[]}},"response":[],"_postman_id":"10264ecd-21a0-4019-a932-faba42942f46"},{"name":"Visual search","id":"5fceb79f-4aa7-456b-9eb8-707545f4e846","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Here comes the second tool: Visual search! In this case we are looking for similar images. Sometimes describing what we are looking for becomes very hard, so why do not use an image that looks like what you want? We can find anything, even things that you do not know how to describe. And again, if you need to filter your database by metadata, no problem, we do not complain about extra work!
\n","urlObject":{"protocol":"https","path":["DB","visual_search"],"host":["api","kimeratechnologies","com"],"query":[{"description":{"content":"What are you looking for? Give us a similar image and we will look for it. If there is any image that resembles to this one, we will find it!
\n","type":"text/plain"},"key":"img_url","value":"https://www.urbanyouthhostel.com/wp-content/uploads/2017/07/best-beaches-in-valencia-1.jpg"},{"description":{"content":"Do you need to filter the database through some metadata parameters? Here you can build filters and we will look for your description only in those images that match your filtering.
\n","type":"text/plain"},"key":"filter_query","value":"lat>11.25 & long<0"},{"description":{"content":"We will sort your items depending how they match with the description. Which is the first item you want to receive? Usually it will be the top scoring (init_item = 0) but who knows, more is not always better.
\n","type":"text/plain"},"key":"init_item","value":"0 "},{"description":{"content":"But what we do need from you is that you indicate us where to stop. How many extra items (in addition to the first one) you want us to return ordered by score? You probably don’t need infinite results, so the shorter the better, so we can perform faster, but give us enough room to find what you need.
\n","type":"text/plain"},"key":"last_item","value":"10"}],"variable":[]}},"response":[],"_postman_id":"5fceb79f-4aa7-456b-9eb8-707545f4e846"}],"id":"23c721ab-f1bd-49b6-a9f4-9ed6676d3ced","description":"If you have an enormous amount of images and you want to access them easily and fast, we can help you. With our database structure you can undertake search queries (text or image based) to find whatever content you are looking for within your resources. It is enough to do what you do, no need to waste time finding the right piece of content.
\n","_postman_id":"23c721ab-f1bd-49b6-a9f4-9ed6676d3ced"},{"name":"Image Enhancement","item":[{"name":"Blur car plates","id":"e25785d3-dfa6-4001-af1e-056e8c4737b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Send us the image you want to edit. Upload the picture here so we can erase the plate and protect your privacy
\n","type":"file","src":"-tVbPhlEa/depositphotos_322932638-stock-photo-cars-parked-along-the-street.jpg"}]},"url":"https://api.kimeratechnologies.com/blurrer/car_plates","description":"Cars are everywhere, and it‘s impossible to take pictures without sometimes capturing number plates. Privacy is important for businesses and we do not want to get in trouble due to publishing pictures with private details. Here we offer you a solution to detect every picture containing a car. In milliseconds, we will create a new picture where number plates will be erased and ready for you to use!
\n","urlObject":{"protocol":"https","path":["blurrer","car_plates"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e25785d3-dfa6-4001-af1e-056e8c4737b6"},{"name":"Blur faces","id":"f799aefe-bde3-4fb6-8816-9706d77e2aa6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"Send us the image you want to edit. Upload the picture here so we can erase the plate and protect your privacy
\n","type":"file","src":"UEr2qmNP_/people-1.jpg"}]},"url":"https://api.kimeratechnologies.com/blurrer/faces","description":"As mentioned, cars are everywhere, but imagine when it comes to people! People don’t want their faces to appear in pictures. Needless to say when others are making profit from it. Therefore, businesses have to be very careful with what they publish and who appears in their content. With our tool, you will not have to deal with this anymore. All faces present in the images will be erased! Forget about editing and get it done instantly!
\n","urlObject":{"protocol":"https","path":["blurrer","faces"],"host":["api","kimeratechnologies","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f799aefe-bde3-4fb6-8816-9706d77e2aa6"}],"id":"28a44d21-43e1-45ca-bd00-48c451dccc67","description":"Images are becoming more and more important in our society, our business, our products, we have to look good! That's why in Kimera we implemented tools that will help you improve the quality of your content and edit it to exploit its full potential in a very simple way, without much effort.
\n","_postman_id":"28a44d21-43e1-45ca-bd00-48c451dccc67"}],"event":[{"listen":"prerequest","script":{"id":"4b43f84d-864c-49e6-a164-e7a7bde5155a","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"5bd9d9e9-3abc-401e-aec9-8dfe95a3b178","type":"text/javascript","exec":[""]}}]}