리마스터 API (Remaster)
인터페이스 설명
리마스터는 완료된 곡을 더 나은 음질의 "리마스터 버전"으로 다시 생성합니다. 한 번에 2개 버전을 반환하며, 제목에는 업스트림이 자동으로 (Remastered)를 덧붙입니다.
엔드포인트: POST /api/music/remaster
과금: 유료. 요청한 모델에 따라 과금되며(기본 suno-v6, 호출당 0.6 위안), 실제 청구 금액은 백오피스 가격 설정을 따릅니다.
모델 설명: 리마스터는 업스트림 전용 인터페이스와 전용 리마스터 모델을 사용하며 플랫폼이 고정하므로 model에 따라 바뀌지 않습니다. 요청의 model은 가격 계산과 채널 선택에만 쓰이며, suno-v6를 명시적으로 전달하는 것을 권장합니다.
대기 시간과 타임아웃(중요): 이 엔드포인트는 동기 방식이며, 응답이 돌아온 시점에야 주문이 접수되어 리마스터에 넘겨집니다. 클라이언트 타임아웃을 300초 이상으로 설정하세요. 응답이 없다고 해서 처리되지 않은 것이 아니며, 타임아웃 직후 재시도하면 주문이 중복되고 요금이 두 번 청구됩니다. 연결이 끊겼다면 잠시 후
GET /api/music/songs로 확인할 수 있습니다.
인증
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| Authorization | string | 예 | Bearer YOUR_API_KEY |
| Content-Type | string | 예 | application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| song_id | string | 예 | - | 리마스터할 소스 곡 ID. 완료 상태여야 하고 현재 API Key로 접근할 수 있어야 합니다 |
| model | string | 아니오 | suno-v6 | 대고객 모델명: suno-v6, suno-v6-wild, suno-v6-mini. 가격과 채널에만 사용됩니다 |
| variation_category | string | 아니오 | normal | 변형 강도: subtle, normal, high(구값 low는 subtle과 동일) |
| style_profile | string | 아니오 | boost | 음색 스타일: natural, boost, clarity |
| tags | string | 아니오 | - | 예약 필드. 비어 있지 않으면 업스트림으로 그대로 전달됩니다 |
| source_audio_url | string | 아니오 | - | 소스 곡이 외부 계정에서 온 경우의 소스 오디오 주소 |
| source_file_name | string | 아니오 | - | 소스 곡이 외부 계정에서 온 경우의 소스 파일 이름 |
| source_title | string | 아니오 | - | 소스 곡이 외부 계정에서 온 경우의 소스 제목 |
audio_id, source_clip_id, sourceClipId는 song_id와 같은 의미이며 하나만 쓰면 됩니다.
요청 예시
curl -X POST https://www.suno-api.io/api/music/remaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "source_song_id",
"variation_category": "high",
"style_profile": "clarity"
}'
기본 설정이면 소스 곡만 전달하면 됩니다. variation_category: normal + style_profile: boost와 같습니다:
{ "model": "suno-v6", "song_id": "source_song_id" }
응답 결과
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "원곡 제목 (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "원곡 제목 (Remastered)",
"status": "processing"
}
]
}
}
한 번에 2개의 리마스터 버전이 반환됩니다. clips[].song_id 두 개를 모두 저장하고 곡 조회 API로 complete가 될 때까지 폴링한 뒤 오디오를 받으세요.
주의 사항
- 소스 곡은 완료 상태여야 하고 현재 API Key로 접근할 수 있는 범위에 있어야 합니다. 외부 소재는 실행 계정으로 자동 동기화됩니다.
- 리마스터는 음질만 다시 만듭니다. 스타일, 편곡, 창법을 바꾸려면 스타일 강화, 업로드 후 커버 또는 Remix 계열 엔드포인트를 사용하세요.
variation_category가 클수록 리마스터 버전과 소스 곡의 차이가 커집니다. 실제 납품 전에는normal로 한 번 시도한 뒤 올리는 것을 권장합니다.