#ī¸âŖItems and Characteristics endpoints
The Items & Characteristics endpoints surface the items and characteristics detected in an image or video, including sound and speech. Each item or characteristic has a prevalence score which represents the extent to which it is present in a given piece of content. Unitary can also analyse the text that is shared alongside the image or video.
You can use these scores in mappings or models to implement safety policies, for example setting a numerical threshold for automated flagging of content or in a linear regression model (read more in the guide for selecting thresholds).
Unitary output's over 50 different classes you can find onList of Item and Characteristics
This guide assumes to have your API key already setup. If this is not the case, please email at support@unitary.ai
1. Authenticate
Please follow the API Authentication instructions first in order to authenticate with the API. This will generate a token that is valid for 24 hours and must be used in subsequent API requests.
2. Sending your first request
Depending on your use case, pick an image or a video and then use one of the following POST
endpoints to send your first request.
POST endpoint reference
Example code
Content supplied as a binary file upload:
Content supplied as a resource URL:
3. Get results back via the GET endpoint
Using the GET endpoint may be inadequate for large scale! The recommendation is using the "callback_url
" parameter instead. Please check the Integrating Webhooks guide for more information.
GET endpoint reference
Example code
Depending on the processing status of the job at the time of request, you can get any of the following as the response from the GET endpoints:
4. Thresholding
Please follow our thresholding guide: How to select thresholds
5. Webhooks
(optional but encouraged)
In order to have a scalable end-to-end integration, the last step is to set up the receiving of webhooks as described in the following guide: Integrating Webhooks
Last updated