Loading template…
✦

ai-music-api/generate

⚡ Run with API

Generate, extend, cover, mash up, and split Suno songs on ModelFold. V6 Mini is the fast default. Lyrics, WAV, MIDI, music video, and voice tools are included. Failed jobs are refunded.

Model Type:

Pricing: Generate song: 16 credits / call

Playground

Pre-filled from the model spec — run it as-is, or tweak any field first.

Ready
Version

V6 Mini is the fastest current version. Older versions may be rejected.

Custom mode

On: you supply the lyrics and title. Off: describe the idea or attach references.

Instrumental

Required

Prompt
Style
Title
Lyrics
Exclude
Vocal gender
Style weight
Weirdness
Audio weight
Variety
Persona id
Persona type
Duration (seconds)

Only when custom mode is on and the version is V5.5, V6, V6 Mini, or V6 Wild. 10–360.

Reference images
Reference videos
Reference audio
Balance: —Cost16 credits
Result

No output yet — press Run.

≡
README
Complete guide to using Suno

Suno music API on ModelFold

Create a song, extend it, cover it, add vocals or accompaniment, split stems, and export lyrics, WAV, MIDI, or a music video. The playground and the jobs API use the same parameters. Failed calls are refunded. Docs: https://modelfold.ai/docs/suno-api/generate-music Model: https://modelfold.ai/models/suno

Suno music API on ModelFold

What you can call

One Suno model, many operations. Pick the operation in the playground or pass its id as model.

Generate song

ai-music-api/generate

Extend

ai-music-api/extend

Cover

ai-music-api/upload-and-cover-audio

Upload and extend

ai-music-api/upload-and-extend-audio

Add instrumental

ai-music-api/add-instrumental

Add vocals

ai-music-api/add-vocals

How pricing works

Each call has an upstream credit cost. ModelFold charges ceil(cost × the site markup). The markup is the same price_markup setting used by the rest of the site. Vocal separation has three prices: vocals plus instrumental, one named stem, and all stems. A few tools are free. If a provider reports a higher cost than the quote, the difference is charged when the job succeeds.

Chain a follow-up call

The result lists every audio file and a text sidecar. sourceTaskId is the id follow-up calls expect. audio_id is the track id. Do not send the ModelFold task id as task_id.

  1. 1

    1

    Generate a song and keep sourceTaskId plus audio_id.

  2. 2

    2

    Extend, cover, WAV, MIDI, video, and separation need both ids.

  3. ✓

    3

    Upload operations need a public audio URL.

Price per call
Generate song16 credits
Extend16 credits
Cover16 credits
Upload and extend16 credits
Add instrumental16 credits
Add vocals16 credits
Mashup16 credits
Separate vocals13 credits
Replace section7 credits
Sound effect4 credits
Music video3 credits
Timestamped lyrics1 credits
Lyrics1 credits
Boost style1 credits
Convert to WAV1 credits
Recover audio1 credits
Cover image0 credits
Persona0 credits
MIDI0 credits
Create voice0 credits
Check voice0 credits
Validation phrase0 credits
Regenerate phrase0 credits
One stem26 credits
All stems65 credits

Price is the upstream cost times the site markup, rounded up. Failed jobs are refunded in full. Some tools are free.

Quick start
curl https://modelfold.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ai-music-api/generate","input":{"custom_mode":false,"instrumental":true,"model":"V6_MINI","style":"acoustic guitar","prompt":"A short sunny acoustic sketch"}}'