---
title: "Advanced Image Upload"
method: POST
path: "/tailored-gen/datasets/{dataset_id}/images/bulk-upload"
tags: ["Dataset"]
---

# Advanced Image Upload

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

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

**Upload without Schema:** You can initiate a bulk upload even if `visual_schema` is null. Images will be uploaded but caption generation will be skipped. You must call **Regenerate All Captions** after defining the schema.

**General:**
* Asynchronous operation; status can be retrieved via `{dataset_id}/bulk-upload/status`.
* Supported for 'advanced' upload type datasets only.
* If the dataset is not empty, if another bulk upload is in progress, or if any previous bulk upload attempt took place, the request will fail.

**Image Requirements:**
* Supported formats: `jpg`, `jpeg`, `png`, `webp`.
* Minimum dimensions: 1024 x 1024 pixels.
* Total size limit: 5 GB zip file.

## Path parameters

- `dataset_id` integer, required

## Headers

- `api_token` string, required

## Request body

- object
  - `zip_url` string, uri — The publicly accessible URL of the ZIP file to upload.
  - `content_moderation` boolean — When enabled, applies content moderation to input visuals.

## Response `202`

Bulk upload job started successfully.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found.
- `413` — Payload Too Large. The ZIP file exceeds the 5GB limit.
- `429` — Request limit exceeded.
- `500` — Internal server error.

---

[API](https://skmtc.net/bria-ai/apis/tailored-generation-api-reference.md) · [All operations](https://skmtc.net/bria-ai/apis/tailored-generation-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bria-ai/tailored-generation-api-reference/revisions/806c6d31631b/schema)