GET

/v1/schemas/fal/audio/fal-ai%2Face-step%2Fprompt-to-audio

kind inputactivity audiohash 2c98dfafextracted Jul 6, 2026version currentsource upstream spec ↗

Request body

14 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringPrompt to control the style of the generated audio. This will be used to generate tags and lyrics.
lyric_guidance_scalenumberLyric guidance scale for the generation.0 ≤ n ≤ 10 · default: 1.5
minimum_guidance_scalenumberMinimum guidance scale for the generation after the decay.0 ≤ n ≤ 200 · default: 3
durationnumberThe duration of the generated audio in seconds.5 ≤ n ≤ 240 · default: 60
guidance_intervalnumberGuidance interval for the generation. 0.5 means only apply guidance in the middle steps (0.25 * infer_steps to 0.75 * infer_steps)0 ≤ n ≤ 1 · default: 0.5
tag_guidance_scalenumberTag guidance scale for the generation.0 ≤ n ≤ 10 · default: 5
instrumentalbooleanWhether to generate an instrumental version of the audio.default: false
guidance_typeenumType of CFG to use for the generation process.cfg | apg | cfg_star · default: "apg"
schedulerenumScheduler to use for the generation process.euler | heun · default: "euler"
number_of_stepsintegerNumber of steps to generate the audio.3 ≤ n ≤ 60 · default: 27
granularity_scaleintegerGranularity scale for the generation process. Higher values can reduce artifacts.-100 ≤ n ≤ 100 · default: 10
guidance_interval_decaynumberGuidance interval decay for the generation. Guidance scale will decay from guidance_scale to min_guidance_scale in the interval. 0.0 means no decay.0 ≤ n ≤ 1 · default: 0
seedintegerRandom seed for reproducibility. If not provided, a random seed will be used.nullable
guidance_scalenumberGuidance scale for the generation.0 ≤ n ≤ 200 · default: 15

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/ace-step/prompt-to-audio","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}