스타일 강화 API
인터페이스 설명
스타일 강화는 짧은 스타일 태그를 더 완전하고 Suno 생성에 적합한 스타일 설명으로 확장하며, 완전한 가사로부터 스타일 구절을 생성할 수도 있습니다.
엔드포인트: POST /api/music/boost-style
과금: 무료 한도 내에서는 무료(사용자당 분당 최대 10회, 하루 최대 300회); 무료 한도를 넘으면 회당 0.1위안이 부과됩니다.
한도 초과 감지: 무료 한도를 넘어도 요청은 정상 실행되며, 응답 헤더에 X-Suno-Helper-Free: false와 X-Suno-Helper-Over-Limit: minute(또는 day)가 실립니다. 이를 보고 클라이언트에서 이번 호출이 과금되었음을 안내할 수 있습니다.
권장 모델: suno-v6. suno-v6, suno-v6-wild, suno-v6-mini를 사용할 수 있습니다.
중국어 출력: 요청 내용(originalTags/lyrics/user_guidance)에 중국어가 포함되어 있고 언어를 따로 선언하지 않은 경우, 서비스가 original_tags 뒤에 （请用中文描述）를 자동으로 덧붙이고 user_guidance=语言：简体中文；乐器名也用中文를 보강하여 중국어 스타일 설명이 잘 나오도록 합니다. 실제로 전달된 값은 응답의 appliedOriginalTags, appliedUserGuidance로 확인할 수 있습니다. 보내는 내용에 이미 언어가 명시되어 있다면(예: "중국어 간체로 설명") 서비스는 아무것도 바꾸지 않습니다.
인증
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| Authorization | string | 예 | Bearer YOUR_API_KEY |
| Content-Type | string | 예 | application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| model | string | 예 | - | 대고객 모델명: suno-v6, suno-v6-wild, suno-v6-mini |
| originalTags | string | 아니오 | - | 원본 스타일 태그 |
| original_tags | string | 아니오 | - | originalTags의 호환 별칭 |
| style | string | 아니오 | - | 원본 스타일 태그. originalTags와 택일 |
| instrumental | boolean | 아니오 | false | 순수 연주곡 방향으로 강화할지 여부 |
| lyrics | string | 아니오 | - | 완전한 가사. 전달하면 그 내용으로 스타일 설명을 생성합니다 |
| user_guidance | string | 아니오 | - | 자연어 요구 사항(예: "수오나와 얼후 추가, 남성 보컬, 템포 더 빠르게"). 플랫폼에 같은 이름의 필드가 있고 그대로 전달됩니다 |
요청 예시
curl -X POST https://www.suno-api.io/api/music/boost-style \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"originalTags": "pop, piano, male vocal",
"lyrics": "[Verse]\n창밖에 밤이 내리고\n[Chorus]\n우리는 빛을 향해 걷는다",
"user_guidance": "수오나와 얼후 추가, 남성 보컬, 템포 더 빠르게",
"instrumental": false
}'
응답 결과
{
"code": 200,
"message": "success",
"data": {
"originalTags": "pop, piano, male vocal",
"instrumental": false,
"upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
"requestId": "request_id"
}
}
upsampledStyle는 Style 입력란에 다시 써 넣어야 하는 완전한 스타일 설명입니다.