GET

/v1/schemas/fal/image/fal-ai/image-apps-v2/hair-change

Accept:

kind inputactivity imagehash 17c5bf7d…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `3e278d02893747fa950f7c9587e7961e31034420db25f9119e3aebd969468de0` { "fetchedAt": 1783329487, "extractorVersion": "1", "verifiedAt": null }

Request body

4 properties · 1 required · 1 $defs

property	type	description	constraints
image_url*	string	Portrait image URL for hair change
aspect_ratio	AspectRatio	Aspect ratio for 4K output (default: 3:4 for portraits)
target_hairstyle	enum		short_hair \| medium_long_hair \| long_hair \| curly_hair \| wavy_hair \| high_ponytail · +12 more · default: "long_hair"
hair_color	enum		black \| dark_brown \| light_brown \| blonde \| platinum_blonde \| red · +12 more · default: "natural"

Types

1 $defs

AspectRatioobject

Aspect ratio model that calculates 4K resolution dimensions

ratio

enum

Aspect ratio for 4K resolution output

1:1 | 16:9 | 9:16 | 4:3 | 3:4 · default: "1:1"

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/image-apps-v2/hair-change","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}