v1

latestOpenAPI 3.0.02026-07-13650400.5 KB
Tailored Generation

Upload Image

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
post/tailored-gen/datasets/{dataset_id}/images

Path parameters

dataset_idstring required

Dataset ID

Headers

api_tokenstring required

Request body

filestring binary

Image file to upload (required if image_url not provided)

image_urlstring

URL of image to upload (required if file not provided)

image_namestring

Custom name for the image (optional)

Response

Image successfully uploaded

idinteger

Unique identifier for the image

dataset_idinteger

ID of the dataset this image belongs to

captionstring

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_namestring

Name of the image

filestring

file of the original image file in base64 format. Either file or image_url should be provided, not both.

image_urlstring

URL of the original image file.

thumbnail_urlstring

URL of the image thumbnail

created_atstring date-time

Timestamp when the image was created

updated_atstring date-time

Timestamp when the image was last updated