🔃Add-on: synchronous endpoints

We offer an add-on for Unitary Premium that allows access to synchronous API endpoints. When you send a request to one of these endpoints, the Policy classification results will be returned in the API response. Therefore, these endpoints do not require the integration of webhooks.

Please get in contact ([e-mail]) to discuss pricing if you are interested.

POST endpoint reference

Submit an image for immediate Policy classification

This endpoint predicts the policy categories of a single image.

The request must contain a url form field (a string containing a URL to download the image file from).

Example CURL:

curl --location --request POST "https://api.unitary.ai/v1/classify/policy/image/now" --header "Authorization: Bearer {API_TOKEN}" --header "Content-Type: multipart/form-data" --form "url={RESOURCE_URL}"

POST/classify/policy/image/now

Authorization

JWTBearer

Body

application/x-www-form-urlencoded

callback_urlWebhooks callback URL

captionCaption

urlUrl

Response

200404422

Successful Response

Body

application/json

urlUrl

policy_categories*Policy Categories

array of PolicyCategoryFullarray of PolicyCategoryRiskLevelsarray of PolicyCategoryScores

Request

JavaScriptCurl

const response = await fetch('/classify/policy/image/now', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/x-www-form-urlencoded"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "url": "https://example.com",
  "policy_categories": [
    {
      "name": "ARMS_AMMO",
      "description": "<p>Arms &#x26; Ammunition</p>",
      "risk_level": "high",
      "score": 0.8,
      "__$markdownParsed": true
    }
  ]
}

Submit a video for immediate Policy classification

This endpoint predicts the policy categories of a single video.

The request must contain a url form field (a string containing a URL to download the video file from).

Example CURL:

curl --location --request POST "https://api.unitary.ai/v1/classify/policy/video/now" --header "Authorization: Bearer {API_TOKEN}" --header "Content-Type: multipart/form-data" --form "url={RESOURCE_URL}"

POST/classify/policy/video/now

Authorization

JWTBearer

Body

application/x-www-form-urlencoded

callback_urlWebhooks callback URL

captionCaption

urlUrl

Response

200404422

Successful Response

Body

application/json

urlUrl

policy_categories*Policy Categories

array of PolicyCategoryFullarray of PolicyCategoryRiskLevelsarray of PolicyCategoryScores

metadataVideoMetadata

Request

JavaScriptCurl

const response = await fetch('/classify/policy/video/now', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/x-www-form-urlencoded"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "url": "https://example.com",
  "policy_categories": [
    {
      "name": "ARMS_AMMO",
      "description": "<p>Arms &#x26; Ammunition</p>",
      "risk_level": "high",
      "score": 0.8,
      "__$markdownParsed": true
    }
  ],
  "metadata": {
    "fps": 0,
    "duration": 0,
    "seconds_processed": 0
  }
}