GET

/v1/schemas/fal/image/fal-ai/minimax/image-01/subject-reference

kind inputactivity imagehash 10a370b0…extracted Oct 17, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
ffe0671e68f11b3c3c72a97790a01ddb18a5a034afbaacb9a79ba04c19a2b274
{
  "fetchedAt": 1792213207,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

6 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
image_url*stringURL of the subject reference image to use for consistent character appearance
prompt*stringText prompt for image generation (max 1500 characters)length ≥ 1 · length ≤ 1500
prompt_optimizerbooleanWhether to enable automatic prompt optimizationdefault: false
enable_safety_checkerbooleanAuthorized callers may set false to request relaxed screening.default: true
num_imagesintegerNumber of images to generate (1-9)1 ≤ n ≤ 9 · default: 1
aspect_ratioenumAspect ratio of the generated image1:1 | 16:9 | 4:3 | 3:2 | 2:3 | 3:4 · +2 more · 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/minimax/image-01/subject-reference","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}