Attach URLs

You can import items by linking them from external storages. The linked items are displayed in SuperAnnotate, but they aren't stored on our local servers.

Attach images URLs

You can attach image URLs to Image Projects and Image (Legacy) Projects only.

Follow the steps below to learn how to attach image URLs. We've also prepared recipes to walk you through attaching image URLs from different types of cloud storage.

Method 1

Step 1: Create a CSV file containing the image URLs

To attach image URLs, first create a CSV file that contains the URLs. Use this template CSV file as a reference.

KeyRequired/OptionalValue
urlRequiredImage URL
nameOptionalImage name

📘

If the image name field is empty, a name ID will be generated based on the row ID and a random UUID.

Step 2: Attach image URLs via Python SDK

Link the images to your project with this SDK command.

sa.attach_items(
    project = "Project Name", 
    attachments = "./images.csv",
    annotation_status = "QualityCheck")
superannotatecli attach-image-urls --project <project_name/folder_name> --attachments <csv_path> [--annotation_status <annotation_status>]

Method 2

You can attach items via a list of URLs.

sa.attach_items(
    project = "Cars",
    attachments = [
        { "name": "16797.jpg", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/0.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=oNlHqhZHiK5GzgWZi%2F46dIoQ%2B%2BA%3D&Expires=1651063405" },
        { "name": "16798.jpg", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/1.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=bYWiGrW8ET56pUcTCrlqhF5EX%2BY%3D&Expires=1651063405" },
        { "name": "16799.jpg", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/10.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=OXtzqrgAlEViDbTM5RHeOA%2BGBLk%3D&Expires=1651063405" }
    ],
    annotation_status="NotStarted"
)

External storage project

After attaching image URLs, the projects will be considered as an external storage project.

In an external storage project, you can't:

  • Run smart segmentation and smart prediction.
  • Run model training.

Limitations

There is no image size or resolution limit. Note that large or high-resolution images may impact the performance of the platform.

Recipes

Attach video or audio URLs

You can attach video or audio URLs to Video or Audio Projects only.

Method 1

Step 1: Create a CSV file containing the video or audio URLs

To attach video or audio URLs, first create a CSV file that contains the URLs. Use this template CSV file as a reference.

KeyRequired/OptionalValue
urlRequiredVideo or audio URL
nameOptionalVideo or audio name

📘

If the name field is empty, a name ID will be generated based on the row ID and a random UUID.

Step 2: Attach video or audio URLs via Python SDK

Link the videos or audios to your project with this SDK command.

sa.attach_items(
    project = "Project Name", 
    attachments = "./videos.csv",
    annotation_status = "QualityCheck")
superannotatecli attach-video-urls --project “Project Name/Folder Name” --attachments “./videos.csv” --annotation_status “QualityCheck”

Method 2

sa.attach_items(
    project = "Cars",
    attachments = [
        { "name": "16797.mp4", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/0.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=oNlHqhZHiK5GzgWZi%2F46dIoQ%2B%2BA%3D&Expires=1651063405" },
        { "name": "16798.mp4", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/1.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=bYWiGrW8ET56pUcTCrlqhF5EX%2BY%3D&Expires=1651063405" },
        { "name": "16799.mp4", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/10.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=OXtzqrgAlEViDbTM5RHeOA%2BGBLk%3D&Expires=1651063405" }
    ],
    annotation_status="NotStarted"
)

Supported video file formats

SuperAnnotate supports the following video file formats that HTML5 supports: OGG, WEBM, and MP4. Learn more about browser compatibility.

Supported audio file formats

SuperAnnotate supports the following audio file formats: MP3, WAV, and OGG.

Attach document URLs

Step 1: Enable CORS in your storage

Make sure to enable cross-origin resource sharing (CORS) for the storages you'll be using.

Amazon S3 bucket

  1. In your bucket, go to Permissions.
  2. Turn off Block all public access.
  3. Insert this configuration in the CORS section.
[
    {
        "AllowedHeaders": [],
        "AllowedMethods": [
            "GET"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": []
    }
]
  1. Click Save changes.

Step 2: Create a CSV file containing the document URLs

To attach document URLs, create a CSV file that contains the URLs. Use this template CSV file as a reference.

KeyRequired/OptionalValue
urlRequiredDocument URL
nameOptionalDocument name

📘

If the document name field is empty, a name ID will be generated based on the row ID and a random UUID.

Step 3: Attach the document URLs via Python SDK

Link your documents to the project with this SDK command.

sa.attach_items(
    project = "Project Name", 
    attachments = "./documents.csv",
    annotation_status = "QualityCheck")
superannotatecli attach-document-urls --project “Project Name/Folder Name” --attachments “./documents.csv” --annotation_status “QualityCheck”

You can also attach items via a list of URLs:

sa.attach_items(
    project = "Cars",
    attachments = [
        { "name": "16797.txt", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/0.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=oNlHqhZHiK5GzgWZi%2F46dIoQ%2B%2BA%3D&Expires=1651063405" },
        { "name": "16798.txt", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/1.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=bYWiGrW8ET56pUcTCrlqhF5EX%2BY%3D&Expires=1651063405" },
        { "name": "16799.txt", 
          "url": "https://test-1212.s3.amazonaws.com/50k2sep/10.jpg?AWSAccessKeyId=AKIA5BP2G2NHEPGBCUX2&Signature=OXtzqrgAlEViDbTM5RHeOA%2BGBLk%3D&Expires=1651063405" }
    ],
    annotation_status="NotStarted"
)