Upload Multiple Images

API Endpoint

POST https://api.genaifactory.ai/v1/upload_images

Headers

Name	Type	Required	Description
formalcloud-api-key	string	Yes	API key for authentication

Request Parameters

Name	Type	Required	Description
images	file[]	Yes	List of images (max 10 files, max 5MB per file)

• The uploaded images must be in one of the allowed formats:

  • PNG, JPG, JPEG, GIF, BMP, WEBP, SVG

• The maximum file size per image is 5MB.

• A maximum of 10 images can be uploaded at once.

Example Request

curl -X POST "https://api.genaifactory.ai/v1/upload_images" \
-H "Content-Type: multipart/form-data" \
-F "images=@image1.jpg" \
-F "images=@image2.png" \
-F "images=@image3.webp"

Response

Success Response (200 OK)

{
  "image_urls": [
    "https://storage.example.com/images/image1.jpg",
    "https://storage.example.com/images/image2.png"
  ]
}

Error Responses

1. No images provided (400 Bad Request)

{
  "error": "No images found"
}

2. Too many files (400 Bad Request)

{
  "error": "Maximum 10 images are allowed"
}

3. Invalid file type (400 Bad Request)

{
  "error": "example.txt File type not allowed. Allowed types: png,jpg,jpeg,gif,bmp,webp,svg"
}

4. File exceeds max size (400 Bad Request)

{
  "error": "image.jpg exceeds maximum file size of 5MB. File size: 6.2MB"
}

5. Failed to determine image format (400 Bad Request)

{
  "error": "Failed to determine the image format: image.unknown"
}

6. Failed to process image (400 Bad Request)

{
  "error": "Failed to process image file image.jpg: [Error Details]"
}

---