GET
/v1/schemas/fal/image/fal-ai/ideogram/custom-models/generate
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracedb696f784ddf4b83435850afbb107cacf958ce22aef59ec4a3f89895233a4a08{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| model_id* | string | The id of a trained custom model returned by /train. The model must have finished training (status COMPLETED). | length ≥ 1 |
| prompt* | string | Text prompt describing the image to generate. | length ≥ 1 |
| rendering_speed | enum | The rendering speed to use. | TURBO | BALANCED | QUALITY · default: "BALANCED" |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. | default: false |
| aspect_ratio | enum | The aspect ratio of the generated image. | 1:3 | 3:1 | 1:2 | 2:1 | 9:16 | 16:9 · +9 more · default: "1:1" |
| seed | integer | Seed for the random number generator. | nullable |
| expand_prompt | boolean | Whether to expand the prompt with MagicPrompt functionality. | default: true |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 8 · default: 1 |
| negative_prompt | string | Description of what to exclude from the image. Descriptions in the prompt take precedence over descriptions in the negative prompt. | default: "" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/ideogram/custom-models/generate","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}