GET
/v1/schemas/fal/image/bria/fibo-edit-1.5/product-holding
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace6c0015e01c927a8e43e5456e9894d90c0864adb3bbdb99bde426cd4c4ee3c0c7{
"fetchedAt": 1791262878,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
6 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| product_image_urls* | string[] | One to three reference images of the product to place: extra angles, its packaging, or a companion item. They describe one holding scene rather than three separate products. The product's geometry, colors, materials, branding and label text are reproduced as g… | items ≥ 1 · items ≤ 3 |
| person_image_url* | string | Photo of the person who will hold the product. Their identity, face, expression, clothing, pose and the background are preserved; only the arm and hand move. | |
| instruction | string | Optional. A complete product-holding instruction already runs; this is appended to it. Use it for which hand, which way the label faces, or what must stay untouched. | nullable |
| sync_mode | boolean | Return the image inline in the response instead of as a hosted URL. Adds latency. | default: false |
| seed | integer | Random seed. The same seed with the same inputs returns the same image. | default: 5555 |
| aspect_ratio | enum | Output aspect ratio. Left unset, the output keeps the ratio of the person image. | 1:1 | 2:3 | 3:2 | 3:4 | 4:3 | 4:5 · +3 more · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bria/fibo-edit-1.5/product-holding","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}