---
title: "Upload Image"
method: POST
path: "/tailored-gen/datasets/{dataset_id}/images"
tags: ["Tailored Generation"]
---

# Upload Image

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

## Request

- Base URL: `https://engine.prod.bria-api.com/v1`
- URL: `https://engine.prod.bria-api.com/v1/tailored-gen/datasets/{dataset_id}/images`
- Auth: none declared. Required headers: `api_token`

Upload new image to a dataset. 

Image Requirements:
- Minimum resolution: 1024x1024 pixels
- Supported formats: jpg, jpeg, png, webp
- Preferably use original high-quality assets
- For best results, use 1:1 aspect ratio or ensure main content is centered

Dataset Guidelines:
- Recommended: 5-50 images for optimal results when using Max training version, 15-100 for optimal results when using Light training version
- Maximum supported: 200 images
- Ensure consistency in style, structure, and visual elements
- Balance diversity in content (poses, scenes, objects) while maintaining consistency in key elements (style, colors, theme)
- Note: Larger datasets may introduce more variety, which can reduce overall consistency

For optimal training (especially for characters/objects):
- Subject should occupy most of the image area
- Minimize unnecessary margins around the subject
- Transparent backgrounds will be converted to black
- For character datasets: include diverse poses, environments, attires, and interactions

Captions and Generation:
- Each image receives an automatic caption that continues from the dataset's caption prefix
- Default caption prefix is recommended for initial training
- Captions can be modified to include domain-specific terms
- Both captions and prefix influence training and future generations
- Focus on essential elements rather than extensive details

Constraints:
- Dataset must have at least 1 image
- Dataset cannot exceed 200 images
- Cannot upload to a completed dataset

## Path parameters

- `dataset_id` string, required

## Headers

- `api_token` string, required

## Request body

- object
  - `file` string, binary: Image file to upload (required if image_url not provided)
  - `image_url` string: URL of image to upload (required if file not provided)
  - `image_name` string: Custom name for the image (optional)

## Response `201`

Image successfully uploaded

- object
  - `id` integer: Unique identifier for the image
  - `dataset_id` integer: ID of the dataset this image belongs to
  - `caption` string: Once an image is uploaded, a caption is generated automatically. The caption is a natural continuation of the caption_prefix.
  - `caption_source` 'automatic' | 'manual': Source of the caption
  - `image_name` string: Name of the image
  - `file` string: file of the original image file in base64 format. Either file or image_url should be provided, not both.
  - `image_url` string: URL of the original image file.
  - `thumbnail_url` string: URL of the image thumbnail
  - `created_at` string, date-time: Timestamp when the image was created
  - `updated_at` string, date-time: Timestamp when the image was last updated

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Dataset not found
- `409`: Conflict error
- `412`: Precondition Failed.
- `415`: Unsupported Media Type.
- `422`: Unprocessable Entity.
- `429`: Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later.
- `500`: Internal server error

## Changes

- **2026-07-13** `2768230345a5`: 1 info
  - endpoint added
- **2021-07-29** `817f5bbbd013`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/bria-ai/apis/the-bria-api/changes/tailored-gen/datasets/:dataset_id/images/post.md)

---

[API](https://skmtc.dev/bria-ai/apis/the-bria-api.md) · [All operations](https://skmtc.dev/bria-ai/apis/the-bria-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bria-ai/apis/the-bria-api/revisions/2768230345a5?raw)