Each task represents a request to upload and index a video, and you can use this endpoint to manage your tasks. A task starts when you begin uploading your video by calling the POST method of the /tasks endpoint, and it can be in one of the following statuses:

  • Validating: Your video has finished uploading, and the API service is validating it by performing the following checks:
    • Resolution must be greater or equal than 360p and less than 1080p (FHD).
    • Duration must be between 10 seconds and 2 hours (7,200s).
    • Your video must contain an audio track.
    • Your video must not have missing frames.
  • Pending: The API is spawning a new worker server to process your video.
  • Indexing: The API is transforming the video you uploaded into vectors. A vector is like a compressed version of the video and contains all the information that Twelve Labs' deep-learning models need to perform fast, semantic, accurate, and scalable searches.
  • Ready: Your video is ready to be searched.
  • Failed: If an error occurs, the status is set to Failed.

๐Ÿ“˜

Note

When using this endpoint, you can set up webhooks to receive notifications. For details, see the Using webhooks section.

Related guide: Uploading Videos.