Hire WorkforcePython SDKRequest Demo

Videos

Suggest Edits

You can upload videos to Video Projects and Image (Vector) Projects, each with their own functionality. Read on below to find out more about it.

Upload methods

Video projects

You can upload videos for Video Projects in two ways: Integrations or Attach URL.

Integration

You can add videos to your Video Projects from your integrated cloud storage. SuperAnnotate will have read-only access to your data; your items are stored in your cloud storage and are only displayed in SuperAnnotate.

Learn how to create integrations:

To add videos from your integrated cloud storage to SuperAnnotate:

  1. In Data, click Add.
  2. Select Upload Videos.
  3. In the Integrations tab, choose an integration from the drop-down list.
  4. Type a folder path (optional).
  5. Click Upload.
  6. Refresh the page to see your added videos.

The bucket’s folder structure will be replicated in SuperAnnotate’s two-level folder structure.

📘

What is a folder path?

A folder path indicates the folder that contains the items and subfolders you want to add to SuperAnnotate. So, if you type Folder A / Folder B, it means that the items will be added from Folder B, which is a sub-folder of Folder A. If you don’t type a folder path, the bucket’s items and folders (and the items inside) will be added from the root.

Attach URL

You can import videos to Video Projects by linking them from external storages. The linked videos are displayed in SuperAnnotate, but they aren't stored in our local servers. Learn more.

Image Projects

You can upload videos for Image Projects in two ways: Upload from computer or CLI upload.

Upload from computer

To upload videos from your computer:

  1. In Data, click Add.
  2. Select Upload Video (with frames).
  3. Drag and drop or choose video files from your computer.
  4. Type a frame rate.
  5. Click Done.

📘

Frame rate

Frame rate (fps) is the number of frames that appear per second. Under Frame rate (fps), type a number to break your videos into several frames or images. The higher the frame rate, the more images will appear per second, and vice versa. The default frame rate is 1.

CLI upload

The CLI upload function is ideal for downloading a large batch of videos. Learn more.

Import with SDK

To import your files through an integration with SDK:

sa.attach_items_from_integrated_storage(
    project = "my_project_name",
    integration = "my_integration_name",
    folder_path = "data/folder_1"
)

Upload Specifications

Here are all the specifications you need to know about regarding uploading Video or Audio files.

🚧

Character Limitation

  • Please limit your item name to 120 characters. Uploading any items whose names exceed this limitation will result in their names cropped. This can be an issue if you have any pre-annotations or JSONs relying on the original filenames.
  • An item name can't contain the following characters: / \ : * ? " < > |

Upload quantity

Here are some things to keep in mind regarding the upload quantity:

  • You can upload up to 2,000 videos at a time. We recommend you upload up to 1,000 videos at a time for a faster and smoother performance.
  • You can't upload more than 50,000 videos, whether it's in a root folder or a folder. The remaining videos will be skipped.
  • If you want to upload more than 50,000 videos to your project, you can do so by creating multiple folders. For example, if you need to upload 100,000 videos, you can create two folders and upload 50,000 videos to each folder.

Supported file formats

You can find all the supported file formats here.

Maximum video file size

The maximum file size for Video or Audio files is 5GB. This limitation does not apply to attaching files with URLs. There are no resolution limitations.

File skipped

A video or audio has the Skipped status if:

  • It has an existing name.
  • Its size exceeds 5GB Video or Audio Projects and Image (Vector) Projects.

File failed

A video or audio has the Failed status if SuperAnnotate doesn't support its file format.

Updated 5 months ago