Upload Image Files

Upload a new image to a dataset.

Image Requirements:

• Recommended minimum resolution: 1024x1024 pixels for best quality
  • By default, smaller images (down to 256x256) will be automatically upscaled (increase_resolution=true)
  • To strictly enforce the 1024x1024 minimum, set increase_resolution=false
• Supported formats: jpg, jpeg, png, webp
• Preferably use original high-quality assets

Dataset Guidelines:

• Recommended: 5-50 images for optimal results
• Maximum supported: 200 images
• Ensure consistency in style, structure, and visual elements
• Balance diversity in content while maintaining consistency in key elements

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

Constraints:

• Can only be used by "basic" upload type datasets. Use images/bulk for advanced datasets.
• Dataset must have at least 5 images
• Dataset cannot exceed 200 images
• Cannot upload to a completed dataset

This API endpoint supports content moderation via an optional parameter.