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

NameTypeDetails
reference_imagesrequiredarray 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_ratiostring

Default: match_input_image

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

seednumber

Random seed. Set for reproducible generation

output_formatstring

Default: png

One of: jpg, png

genderstring

Default: none

One of: none, male, female

hair_colorstring

Default: No change

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

haircutstring

Default: No change

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