GET

/v1/schemas/fal/image/fal-ai/image-apps-v2/headshot-photo

Accept:

kind inputactivity imagehash 73f9a651…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `48170f3a82ad012417858bbe9a9270c06410e44bbfabc023cb0773773c9c53f4` { "fetchedAt": 1783330412, "extractorVersion": "1", "verifiedAt": null }

Request body

3 properties · 1 required · 1 $defs

property	type	description	constraints
image_url*	string	Portrait image URL to convert to professional headshot
aspect_ratio	AspectRatio	Aspect ratio for 4K output (default: 3:4 for portraits)
background_style	enum		professional \| corporate \| clean \| gradient · default: "professional"

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