Use this method to classify a set of videos based on the entities or actions shown in those videos. Note that this endpoint returns the first page or results. To retrieve the rest of the pages, you must call the GET method of the /classify/{page_token} endpoint passing it the token that identifies the page you want to retrieve.


  • This method has a rate limit of 1 call per second for each API key. If the limit is reached, the platform returns an HTTP 429 - Too many requests error response.
  • The total number of the prompts you specify in a request must not exceed 100.
  • The total duration of the videos you classify in a request must not exceed 10 hours.
  • The Playground is a sandbox environment that allows you to try out the features of the Twelve Labs Video Understanding Platform through an intuitive web page. To classify a video that has been created in the Playground, you must append p to the base URL, as follows: Everything else remains the same.
Make a classification request
Open Recipe
Click Try It! to start a request and see the response here!