Q: What images do I need to provide?

You need two images : A selfie or user photo showing a single person with the face fully visible (head‑to‑chest recommended). A hat image — either a product image or a photo of a model wearing a hat. Both can be uploaded via the File API or supplied as public URLs.

Q: What are the image requirements?

Selfie / user image: Minimum: 512×512 px Face must be clearly visible and unobstructed One person only, from head to chest (half‑body preferred) Hat image: Product images: min 512×512 Worn images: min 800×800 Must feature one hat clearly covering the intended head area Supported formats include jpg, jpeg, png, and heic , with input size limits under 10MB.

Q: How is user data and uploaded images handled?

All images uploaded to the AI Hat API are processed securely and used only for task generation . Images are temporarily stored for the duration of the task and automatically deleted afterwards. No user data is shared with third parties, ensuring privacy compliance for e-commerce, apps, and in-store implementations. You can also combine this with your Terms of Service / Privacy Policy to reassure end users.

Q: When are units consumed?

Units are consumed only when the task succeeds and a result image is generated. If the task fails, no units are deducted .

Question 1

What images do I need to provide?

Accepted Answer

You need two images:

A selfie or user photo showing a single person with the face fully visible (head‑to‑chest recommended).
A hat image — either a product image or a photo of a model wearing a hat. Both can be uploaded via the File API or supplied as public URLs.

Question 2

What are the image requirements?

Accepted Answer

Selfie / user image:

Minimum: 512×512 px
Face must be clearly visible and unobstructed
One person only, from head to chest (half‑body preferred)

Hat image:

Product images: min 512×512
Worn images: min 800×800
Must feature one hat clearly covering the intended head area

Supported formats include jpg, jpeg, png, and heic, with input size limits under 10MB.

Question 3

How is user data and uploaded images handled?

Accepted Answer

All images uploaded to the AI Hat API are processed securely and used only for task generation. Images are temporarily stored for the duration of the task and automatically deleted afterwards. No user data is shared with third parties, ensuring privacy compliance for e-commerce, apps, and in-store implementations.

You can also combine this with your Terms of Service / Privacy Policy to reassure end users.

Question 4

When are units consumed?

Accepted Answer

Units are consumed only when the task succeeds and a result image is generated.
If the task fails, no units are deducted.

AI Hat Virtual Try-On API

Hyper-realistic virtual try-on for hats and headbands with our Generative AI API. Built for fashion, retail, and eCommerce, delivering precise fit and lifelike visualization.

Hyper-Realistic Gen AI API Technology

AI Hat Virtual Try-On That Surpasses Every AI Tool

Flexible Image Input, Consistent Try-On Results

Preset Headwear to Select

Generate the Best Outfits and Backgrounds that Meet the Headwear

How Does Our AI Hat Virtual Try-On API Work

Initialize Request & Payload

Select Headwear and Configure Parameters

AI Returns Results

Explore Our Interactive API Playground

Benefits for Developers