API docs / Image models
change-haircut API
Quickly change someone's hair style and hair color, powered by FLUX.1 Kontext [pro]
- Model id
flux-kontext-apps/change-haircut- Provider
- flux-kontext-apps
- Output
- Image
- Price
- From 14 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "flux-kontext-apps/change-haircut". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "flux-kontext-apps/change-haircut",
"input": {
"reference_images": [
"https://example.com/input.png"
]
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
reference_imagesrequired | array of URLs | Image of the person's haircut you want to edit. Must be jpeg, png, gif, or webp. Up to 1 files · Accepts image/* |
aspect_ratio | string | Default: One of: match_input_image, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2 |
seed | number | Random seed. Set for reproducible generation |
output_format | string | Default: One of: jpg, png |
gender | string | Default: One of: none, male, female |
hair_color | string | Default: One of: No change, Random, Blonde, Brunette, Black, Dark Brown, Medium Brown, Light Brown, Auburn, Copper, Red, Strawberry Blonde, Platinum Blonde, Silver, White, Blue, Purple, Pink, Green, Blue-Black, Golden Blonde, Honey Blonde, Caramel, Chestnut, Mahogany, Burgundy, Jet Black, Ash Brown, Ash Blonde, Titanium, Rose Gold |
haircut | string | Default: One of: No change, Random, Straight, Wavy, Curly, Bob, Pixie Cut, Layered, Messy Bun, High Ponytail, Low Ponytail, Braided Ponytail, French Braid, Dutch Braid, Fishtail Braid, Space Buns, Top Knot, Undercut, Mohawk, Crew Cut, Faux Hawk, Slicked Back, Side-Parted, Center-Parted, Blunt Bangs, Side-Swept Bangs, Shag, Lob, Angled Bob, A-Line Bob, Asymmetrical Bob, Graduated Bob, Inverted Bob, Layered Shag, Choppy Layers, Razor Cut, Perm, Ombré, Straightened, Soft Waves, Glamorous Waves, Hollywood Waves, Finger Waves, Tousled, Feathered, Pageboy, Pigtails, Pin Curls, Rollerset, Twist Out, Bantu Knots, Dreadlocks, Cornrows, Box Braids, Crochet Braids, Double Dutch Braids, French Fishtail Braid, Waterfall Braid, Rope Braid, Heart Braid, Halo Braid, Crown Braid, Braided Crown, Bubble Braid, Bubble Ponytail, Ballerina Braids, Milkmaid Braids, Bohemian Braids, Flat Twist, Crown Twist, Twisted Bun, Twisted Half-Updo, Twist and Pin Updo, Chignon, Simple Chignon, Messy Chignon, French Twist, French Twist Updo, French Roll, Updo, Messy Updo, Knotted Updo, Ballerina Bun, Banana Clip Updo, Beehive, Bouffant, Hair Bow, Half-Up Top Knot, Half-Up, Half-Down, Messy Bun with a Headband, Messy Bun with a Scarf, Messy Fishtail Braid, Sideswept Pixie, Mohawk Fade, Zig-Zag Part, Victory Rolls |