Spiral gives your agent every tool with one account. Browse the tools →

falAudioAvailable nowReleased 2025-05-06

ACE Step · Prompt to Audio

fal-ai/ace-step/prompt-to-audio

Turn text into speech and audio with ACE Step · Prompt to Audio from fal through one Spiral API key. It runs in the background and returns audio. Pay as you go, with no subscription.

Pricing

$0.00026 per second. Billed on duration, default 60.

Limits

Runs
In the background
Returns
audio
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
255 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

Prompt to control the style of the generated audio. This will be used to generate tags and lyrics.

instrumentaltrue or falsefalse

Whether to generate an instrumental version of the audio.

durationnumber
5 to 240
60

The duration of the generated audio in seconds.

number_of_stepsnumber (whole)
3 to 60
27

Number of steps to generate the audio.

seednumber (whole)—

Random seed for reproducibility. If not provided, a random seed will be used.

schedulerone of
euler, heun
euler

Scheduler to use for the generation process.

guidance_typeone of
cfg, apg, cfg_star
apg

Type of CFG to use for the generation process.

granularity_scalenumber (whole)
-100 to 100
10

Granularity scale for the generation process. Higher values can reduce artifacts.

guidance_intervalnumber
0 to 1
0.5

Guidance interval for the generation. 0.5 means only apply guidance in the middle steps (0.25 * infer_steps to 0.75 * infer_steps)

guidance_interval_decaynumber
0 to 1
0

Guidance interval decay for the generation. Guidance scale will decay from guidance_scale to min_guidance_scale in the interval. 0.0 means no decay.

guidance_scalenumber
0 to 200
15

Guidance scale for the generation.

minimum_guidance_scalenumber
0 to 200
3

Minimum guidance scale for the generation after the decay.

tag_guidance_scalenumber
0 to 10
5

Tag guidance scale for the generation.

lyric_guidance_scalenumber
0 to 10
1.5

Lyric guidance scale for the generation.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/ace-step/prompt-to-audio",
    "input": {
      "prompt": "A lofi hiphop song with a chill vibe about a sunny day on the boardwalk."
    }
  }'

Frequently asked questions

How much does ACE Step · Prompt to Audio cost?

$0.00026 per second. Billed on `duration`, default 60. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use ACE Step · Prompt to Audio through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/ace-step/prompt-to-audio"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use ACE Step · Prompt to Audio?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use ACE Step · Prompt to Audio?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.