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 fromclip_id. The clip must belong to an account available to your API key.
Endpoints
| Endpoint | Method | Credits | Description |
|---|---|---|---|
/suno/v2/studio/crop | POST | Free | Keep [start_s, end_s) and export |
/suno/v2/studio/removeSection | POST | Free | Delete one or more ranges |
/suno/v2/studio/duplicate | POST | Free | Copy a range and insert it |
/suno/v2/studio/addSection | POST | Billed | Phase 1 — generate 2 candidate fills |
/suno/v2/studio/addSectionCommit | POST | Free | Phase 2 — commit a selected candidate |
Add Section workflow (two phases)
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.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
GET /suno/v2/status?taskId=... until complete.