# Advanced image upload

Efficiently upload a large volume of images (up to 5000) from a ZIP file to an advanced dataset.

This operation is asynchronous and status can be retrived by using the  endpoint.

 This endpoint is only supported for datasets with an  upload type. 
The dataset must be empty.


* Supported formats: , , , .
* Minimum dimensions: 1024 x 1024 pixels.
* Total size limit: 5 GB zip file.


* : The system automatically generates captions for all images.
* : Each image must have a corresponding  file with the same name (e.g.,  and ) containing the plaintext caption.


* This endpoint is for  and does not support the  parameter.
* Images that fail validation (e.g., unsupported format, wrong dimensions, missing captions) will be skipped and included in the failure report.
* If the dataset is not empty, if another bulk upload is in progress, or if any previous bulk upload attemp took place, the request will fail.


Endpoint: POST /tailored-gen/datasets/{dataset_id}/images/bulk-upload

## Path parameters:

  - `dataset_id` (string, required)
    The ID of the dataset to upload images to. Must be an 'advanced' dataset.

## Header parameters:

  - `api_token` (string, required)

## Request fields (application/json):

  - `zip_url` (string)
    The publicly accessible URL of the ZIP file to upload.

  - `automatic_captioning` (boolean)
    When , captions are automatically generated. When , a corresponding  caption file must exist for each image.

  - `content_moderation` (boolean)
    When enabled, applies content moderation to input visuals.

## Response 400 fields (application/json):

  - `message` (string)