Guides
Vi Dashboard
  1. Datasets
  2. Upload Data
  3. Upload Assets

Upload Images

Add images to a Datature Vi dataset using the browser or Vi SDK. Covers supported formats, file size limits, and how to handle common upload issues.

Prepare Data
Train a Model
Deploy & Integrate
Manage Workspace

Images are the primary asset type for computer vision tasks in Datature Vi. This guide covers the upload steps, supported formats, file limits, and what to do when something goes wrong.

Before You Start
  • A dataset created in Datature Vi. Create one now if you haven't yet.
  • Images in a supported format (see the table below).
1

Open your dataset's Explorer tab

Open your dataset's Explorer tab

Open your dataset and click the Explorer tab. This is where your uploaded images will appear.

You should see
Dataset Explorer showing a grid of uploaded image thumbnails with a total asset count in the header

Your images are uploaded when they appear as thumbnails in the Explorer and the asset count in the header matches what you uploaded.

Supported image formats

Supported image formats

Format
Extensions
Notes
JPEG
.jpg, .jpeg, .jfif
Recommended for photos
PNG
.png
Recommended for images with transparency or sharp edges
TIFF
.tiff, .tif
First subfile only
BMP
.bmp
WebP
.webp
First frame only
HEIF
.heif, .heic
AVIF
.avif
First frame only
JPEG 2000
.jp2, .j2k
GIF
.gif
First frame only

For formats that support multiple frames (GIF, AVIF, WebP, TIFF), Datature Vi imports only the first frame.

RAW formats (CR2, NEF, ARW) are not supported. Convert to JPEG, PNG, or TIFF before uploading.

File size limits

  • Maximum: 256 MB per image
  • Recommended: Under 10 MB for faster uploads and processing

Images are stored at original quality. No automatic compression or resizing is applied.

Troubleshooting

Check your internet connection first. Then try:

  • Upload in smaller batches (10–20 images at a time)
  • Check that each image is under 256 MB
  • Close unused browser tabs to free memory
  • Try the Vi SDK for large uploads

Wait a few minutes for background processing to finish, then refresh the Explorer tab. Check the notification icon for upload status. If images are still missing, verify the upload completed without errors and re-upload if needed.

Verify the file extension is in the supported list above. Open the image in an editor to confirm it is valid. Convert unsupported formats before uploading.

Datature Vi may not apply EXIF orientation tags automatically. Open the image in an editor, rotate it, save with the rotation applied to the actual pixels, then re-upload.

Do this with the Vi SDK

import vi

client = vi.Client(
    secret_key="your-secret-key",
    organization_id="your-organization-id"
)

result = client.assets.upload(
    dataset_id="your-dataset-id",
    paths="./images/",
    wait_until_done=True
)
print(f"Uploaded: {result.total_succeeded} assets")

For more details, see the full SDK reference.

Next steps

Upload Annotations

Import existing labels from COCO, YOLO, Pascal VOC, CSV, or Vi JSONL.

Annotate Data

Create or edit annotations in the visual annotator.

Train A Model

Fine-tune a vision-language model once your dataset has annotations.

Updated about 1 month ago