Skip to main content
Suno Studio APIs edit an existing clip on the same Suno account (resolved from clip_id) and export a new song. Most Studio operations are free (0 credits). The exception is Add Section, which runs an infill generation (billed like music creation) and then a free commit step.

Account binding

All Studio endpoints resolve the Suno account from clip_id. The clip must belong to an account available to your API key.

Endpoints

EndpointMethodCreditsDescription
/suno/v2/studio/cropPOSTFreeKeep [start_s, end_s) and export
/suno/v2/studio/removeSectionPOSTFreeDelete one or more ranges
/suno/v2/studio/duplicatePOSTFreeCopy a range and insert it
/suno/v2/studio/addSectionPOSTBilledPhase 1 — generate 2 candidate fills
/suno/v2/studio/addSectionCommitPOSTFreePhase 2 — commit a selected candidate

Add Section workflow (two phases)

1

Generate candidates

Call Add Section with clip_id and insert_at_s. Poll Get Task Status until success. The result includes candidate clips plus Studio project context.
2

Commit selection

Call Add Section Commit with the phase-1 taskId and the chosen candidate_clip_id. Account reuse comes from phase 1 — do not pass the original song taskId for account binding.

Quick example — crop

curl -X POST https://api.mountsea.ai/suno/v2/studio/crop \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "clip_id": "5a3c023f-d1ed-4a85-b61e-168dde2b6659",
    "start_s": 0,
    "end_s": 45,
    "title": "Summer Vibes (Cropped)"
  }'
Then poll GET /suno/v2/status?taskId=... until complete.