---
title: "Upload Images to S3"
method: POST
path: "/api/v1/ai-videos/upload-images"
tags: ["aiVideos"]
---

# Upload Images to S3

`POST /api/v1/ai-videos/upload-images`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/ai-videos/upload-images`
- Auth: HTTP bearer

Upload multiple image files to S3 in parallel.

**Options:**
1. **Upload individual files**: Add multiple file inputs using "Add string item" button
2. **Upload zip folder**: Upload a zip file containing images - all images will be extracted and uploaded

**Swagger UI Instructions:**
- For individual files: Click "Add string item", change type to "file", select files
- For zip folder: Select a zip file containing images

**Request (multipart/form-data):**
- `files` (optional): Multiple individual image files
- `zip_file` (optional): Zip file containing images
- `domain_id` (optional): Domain ID for organizing assets

**Note:** Provide either `files` OR `zip_file` (at least one is required).

**Example with curl (individual files):**
```bash
curl -X POST "/api/v1/ai-videos/upload-images" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "files=@image1.jpg" \
  -F "files=@image2.png"
```

**Example with curl (zip folder):**
```bash
curl -X POST "/api/v1/ai-videos/upload-images" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "zip_file=@images_folder.zip"
```

**Response:**
- `s3_urls`: List of uploaded S3 URLs
- `total`: Total images uploaded
- `uploaded`: Successfully uploaded count
- `failed`: Failed upload count
- `errors`: List of errors if any

## Request body `application/x-www-form-urlencoded`

- BodyUploadImagesApiV1AiVideosUploadImagesPost
  - `domain_id` string, nullable: Domain ID for organizing assets

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)