스템 삭제 API
인터페이스 설명
스템 삭제는 이미 생성된 스템 트랙을 목록에서 숨깁니다. 삭제는 소프트 삭제로, 백엔드는 스템 행에
stem_hidden 표시만 남깁니다. 원본 오디오, MIDI, 다운로드 리소스는 그대로 유지되며, 같은 곡에서 나중에 다시
새 스템을 분리할 수 있습니다.
엔드포인트: POST /api/music/stem-delete
과금: 무료. 삭제는 플랫폼 내부의 표시 상태만 바꾸며 Suno를 호출하지 않고 요금도 발생하지 않습니다.
권장 모델: suno-v6. suno-v6, suno-v6-wild, suno-v6-mini를 사용할 수 있습니다.
인증
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| Authorization | string | 예 | Bearer YOUR_API_KEY |
| Content-Type | string | 예 | application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| song_id | string | 아니오 | - | 단일 스템 트랙의 song_id(/api/music/separate가 반환한 트랙 ID) |
| song_ids | string[] | 아니오 | - | 일괄 지정. 한 번에 최대 100건 |
| stem_batch_id | string | 아니오 | - | 배치 단위 삭제: 해당 자동 분리 배치의 모든 트랙을 지웁니다 |
| stem_mode | string | 아니오 | - | 모드 단위 삭제: 예를 들어 two, twelve |
song_id / song_ids / stem_batch_id / stem_mode 중 최소 하나를 보내야 하며, 없으면 400을 반환합니다.
요청 예시
curl -X POST https://www.suno-api.io/api/music/stem-delete \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"song_ids": ["stem_track_id_1", "stem_track_id_2"]
}'
응답 결과
{
"code": 200,
"message": "success",
"data": {
"hidden": 2,
"affected_sources": 1
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
| hidden | number | 이번에 숨긴 트랙 수 |
| affected_sources | number | 영향을 받은 원본 곡 수 |
주의 사항
- 멱등: 이미 숨겨졌거나 ID가 존재하지 않으면
hidden: 0을 반환하고 오류가 나지 않으므로 반복 호출이 안전합니다. - 삭제는 현재 API Key가 소유한 곡에만 영향을 줍니다. 내 것이 아닌 트랙은 변경되지 않습니다.
- 목록에서 마지막으로 보이는 스템을 숨기면 원본 곡의 "분리됨" 표시도 함께 지워집니다.