GET

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

Accept:

kind inputactivity imagehash 76a7757b…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `0415b5e078f48cd89a6b2cafa499fa77604ce7b7628b9e6f2b378bf45bfd7506` { "fetchedAt": 1783331098, "extractorVersion": "1", "verifiedAt": null }

Request body

3 properties · 1 required · 1 $defs

property	type	description	constraints
image_url*	string	Portrait image URL for expression change
aspect_ratio	AspectRatio	Aspect ratio for 4K output (default: 3:4 for portraits)
target_expression	enum		smile \| surprise \| glare \| panic \| shyness \| laugh · +14 more · default: "smile"

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/expression-change","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}