Music Generation
텍스트 한 줄로 완성곡을 만들고, 가사를 직접 써서 노래를 만들고, 기존 곡을 다른 스타일로 커버하고, 효과음 생성과 보컬·반주 분리까지 할 수 있습니다. Suno와 MiniMax Music 최신 모델 기반입니다.
모델 한눈에 보기
| 모델 | 크레딧 | 결과물 | 특징 |
|---|---|---|---|
| minimax/music-cover | 700 | 커버 곡 1개 | 원곡 멜로디를 유지한 스타일·보컬·편곡 변환 |
| minimax/music-2.6 | 350 | 노래 1곡 (최대 ~6분) | 가사 자동 생성·연주곡 모드, BPM·조성 제어 |
| minimax/music-2.5 | 350 | 노래 1곡 | 가사 기반 완성곡, 풍부한 악기 구성 |
| suno/music-v5-5 | 140 | 노래 2곡 + 커버 이미지 | 최신 모델, 최고 음질·풍부한 편곡 |
| suno/music-v5 | 140 | 노래 2곡 + 커버 이미지 | 향상된 음질과 음악성 |
| suno/music-v4-5 | 140 | 노래 2곡 + 커버 이미지 | 안정적인 기본 모델 |
| suno/vocal-separation | 120 | 보컬 + 반주 MP3 | 생성한 곡을 MR/아카펠라로 분리 |
| suno/sfx-v5 | 29 | 효과음 2개 변형 | UI 사운드·게임 오디오·폴리, 루프 지원 |
Suno 음악 생성은 1회 요청마다 서로 다른 2곡이 만들어지고, MiniMax Music은 1곡이 만들어집니다. 생성에는 보통 1~3분이 걸리는 비동기 작업입니다.
모델 상세 정보
각 모델의 상세한 파라미터, 예제, 프롬프트 팁은 개별 문서에서 확인하세요.
Suno Music V5.5
Suno
Suno의 최신 모델로, 최고 음질과 가장 풍부한 편곡을 제공합니다. 텍스트 설명만으로, 또는 커스텀 모드에서 가사·스타일·제목을 직접 지정해 완성곡 2곡을 생성합니다. 각 트랙의 오디오, 커버 이미지, 메타데이터를 반환합니다.
Suno Music V5
Suno
향상된 음질과 음악성을 갖춘 Suno V5 음악 생성 모델입니다. 텍스트 설명만으로, 또는 커스텀 모드에서 가사·스타일·제목을 직접 지정해 완성곡 2곡을 생성합니다. 각 트랙의 오디오, 커버 이미지, 메타데이터를 반환합니다.
Suno Music V4.5
Suno
Suno V4.5 음악 생성 모델입니다. 텍스트 설명만으로, 또는 커스텀 모드에서 가사·스타일·제목을 직접 지정해 완성곡 2곡을 생성합니다. 각 트랙의 오디오, 커버 이미지, 메타데이터를 반환합니다.
MiniMax Music 2.6
MiniMax
텍스트 프롬프트로 최대 6분 길이의 완성곡 또는 연주곡을 생성합니다. 99% 이상 정확한 BPM·조성 제어, 14종 이상의 구조 태그, 가사 자동 생성, 보컬 없는 연주곡 모드를 지원합니다.
MiniMax Music 2.5
MiniMax
보컬, 가사, 풍부한 악기 구성을 갖춘 최대 5분 길이의 완성곡을 생성합니다. 14종 구조 태그, 장르별 특성을 반영하는 스타일-aware 믹싱, 오케스트라·전통 악기까지 확장된 악기 라이브러리를 지원합니다.
MiniMax Music Cover
MiniMax
어떤 곡이든 다른 스타일로 재해석합니다. 입력 오디오에서 멜로디 구조를 추출해 트랙을 재생성합니다 — 멜로디와 곡 길이는 유지되고, 목소리·악기·장르·편곡은 모두 바뀔 수 있습니다.
Suno SFX V5
Suno
Suno V5 효과음 생성 모델입니다. 텍스트 설명만으로 짧은 효과음 2가지 변형을 생성하며, 루프 모드·템포·조성(key)을 옵션으로 제어할 수 있습니다. UI 사운드, 게임 오디오, 영상 폴리에 적합합니다.
Sonilo v1.1 Text to Music
Sonilo
Fal.AI를 통해 제공되는 Sonilo v1.1 텍스트-투-뮤직 모델입니다. 원하는 사운드를 설명하는 텍스트만으로 최대 3개의 서로 다른 음악 트랙(각 최대 600초)을 생성합니다.
Suno Vocal Separation
Suno
Suno로 생성한 곡을 보컬과 반주(인스트루멘탈) 스템으로 분리합니다. 이전 Suno 음악 생성 결과의 taskId와 audioId를 입력하면 분리된 vocalUrl/instrumentalUrl 오디오 파일을 반환합니다.
동작 방식
POST /v1/predictions로 생성 요청 →job_id를 즉시 돌려받습니다 (크레딧은 이 시점에 차감).GET /v1/predictions/{job_id}로 상태를 폴링합니다.pending → processing → completed순서로 바뀝니다.- 완료되면 결과의 오디오/이미지가 자동으로 CDN에 저장되어 서명된 URL로 반환되고, 콘솔의 Storage 페이지에도 등록됩니다.
- 생성이 실패하면 차감된 크레딧은 자동으로 환불됩니다.
1. 간단 모드 — 설명만으로 노래 만들기
가장 쉬운 방법입니다. customMode: false로 두고 prompt에 원하는 곡의 분위기·장르·주제를 한글 또는 영어로 설명하면(최대 500자), 가사·제목·스타일을 AI가 알아서 만듭니다.
curl -X POST https://api.core.today/v1/predictions \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "suno/music-v5-5",
"input": {
"customMode": false,
"instrumental": false,
"prompt": "밤바다를 걷는 기분의 잔잔한 어쿠스틱 발라드, 따뜻한 여성 보컬"
}
}'응답으로 받은 job_id로 완료될 때까지 몇 초 간격으로 상태를 확인합니다:
curl https://api.core.today/v1/predictions/JOB_ID \
-H "X-API-Key: cdt_your_api_key"완료(status: "completed") 시 결과 구조:
{
"job_id": "...",
"status": "completed",
"result": {
"taskId": "e3f26411...", // 보컬 분리에 쓰는 원곡 ID
"sunoData": [
{
"id": "8e83779c-...", // 트랙 ID (보컬 분리의 audioId)
"audioUrl": "https://files.core.today/...mp3", // 재생/다운로드 URL
"imageUrl": "https://files.core.today/...png", // 커버 이미지
"title": "푸른 바람 노래",
"tags": "한국 동요",
"duration": 73.84, // 초 단위 길이
"prompt": "생성에 사용된 가사 전문..."
},
{ "...": "두 번째 곡 (같은 구조)" }
]
}
}2. 커스텀 모드 — 가사를 직접 써서 노래 만들기
customMode: true로 바꾸면 prompt가 가사 그 자체로 쓰입니다 (최대 5,000자). 이때 style(음악 스타일)과 title(곡 제목)을 함께 보내야 합니다. 가사는 [Verse], [Chorus] 같은 구조 마커로 나눠 쓰면 훨씬 좋은 결과가 나옵니다.
curl -X POST https://api.core.today/v1/predictions \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "suno/music-v5-5",
"input": {
"customMode": true,
"instrumental": false,
"title": "푸른 바람 노래",
"style": "밝고 경쾌한 한국 동요, 어린이 합창",
"prompt": "[Verse]\n아침 햇살 창문 열면\n새들 노래 반겨 줘요\n살랑살랑 푸른 바람\n우리 마음 춤춰요\n\n[Chorus]\n랄랄라 함께 불러요\n두 손 잡고 웃어 봐요\n오늘도 반짝이는 꿈\n우리 함께 키워 가요"
}
}'instrumental: true로 설정하세요. 이때는 가사가 필요 없으므로 커스텀 모드에서 prompt를 생략할 수 있습니다.음악 생성 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| customMode | boolean | ✅ | false: 설명만으로 생성(간단 모드) / true: 가사·스타일·제목 직접 지정 |
| instrumental | boolean | ✅ | true면 보컬 없는 연주곡 생성 |
| prompt | string | △ | 간단 모드: 곡 설명(최대 500자) / 커스텀 모드: 가사 전문(최대 5,000자). 커스텀+연주곡일 때만 생략 가능 |
| style | string | △ | 음악 스타일 (커스텀 모드 필수, 최대 1,000자). 예: "lo-fi hip hop, 몽환적" |
| title | string | △ | 곡 제목 (커스텀 모드 필수, 최대 100자) |
| negativeTags | string | - | 제외할 스타일 (쉼표 구분) |
| vocalGender | string | - | 보컬 성별: m(남성) / f(여성) |
| styleWeight | number | - | 스타일 반영 강도 (0~1) |
| weirdnessConstraint | number | - | 독창성·실험성 제약 (0~1) |
| audioWeight | number | - | 오디오 요소 가중치 (0~1) |
△ = 조건부 필수. 고급 파라미터(negativeTags 이하)는 커스텀 모드에서만 적용됩니다. 콘솔 생성 화면에서는 Custom Mode를 켜면 해당 입력창이 자동으로 나타납니다.
3. 효과음 만들기 (SFX)
suno/sfx-v5는 짧은 효과음 전용 모델입니다. 원하는 소리를 설명하면 2가지 변형이 생성됩니다. 게임/앰비언트용으로 끊김 없이 반복되는 사운드가 필요하면 soundLoop: true를, 템포나 조성을 맞추려면 soundTempo(BPM, 1~300)와 soundKey(예: C, Am)를 지정하세요.
curl -X POST https://api.core.today/v1/predictions \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "suno/sfx-v5",
"input": {
"prompt": "부드러운 노크 소리 두 번, 나무 문, 울림 없는 방",
"soundLoop": false
}
}'4. 보컬 분리 — 만든 노래를 MR/아카펠라로
suno/vocal-separation은 앞서 생성한 곡을 보컬 트랙과 반주(인스트루멘탈) 트랙으로 분리합니다. 입력값 2개는 모두 음악 생성 결과 안에 들어 있습니다:
taskId← 생성 결과 최상위의result.taskIdaudioId← 분리할 트랙의result.sunoData[].id
curl -X POST https://api.core.today/v1/predictions \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "suno/vocal-separation",
"input": {
"taskId": "e3f26411e1320351be961922957d654e",
"audioId": "8e83779c-2a4e-4fba-9752-7d0c32ee308c"
}
}'완료 시 결과:
{
"status": "completed",
"result": {
"vocalUrl": "https://files.core.today/...mp3", // 보컬만
"instrumentalUrl": "https://files.core.today/...mp3" // 반주만 (MR)
}
}2곡 중 각 트랙을 따로 분리할 수 있습니다 (트랙당 1회 호출). 이 게이트웨이의 Suno 모델로 생성한 곡에만 사용할 수 있습니다.
5. MiniMax Music — 정확한 BPM 제어와 곡 커버
minimax/music-2.6은 프롬프트에 적은 조성과 BPM을 99% 이상 정확하게 반영합니다 (영상 편집처럼 템포가 중요한 작업에 유용). lyrics_optimizer: true면 스타일 설명 한 줄로 가사까지 자동 생성되고, is_instrumental: true면 보컬 없는 연주곡을 만듭니다.
curl -X POST https://api.core.today/v1/predictions \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/music-2.6",
"input": {
"prompt": "E minor, 90 BPM, acoustic guitar ballad, male vocal, emotional",
"lyrics": "[Verse]\n밤하늘의 별을 세다가\n너의 이름을 떠올렸어\n\n[Chorus]\n아직도 기억해 그날의 노래"
}
}'minimax/music-cover는 원곡의 멜로디와 길이를 유지한 채 장르·보컬·편곡을 바꿉니다. 보컬과 멜로디가 선명한 MP3/WAV URL을 입력하세요:
curl -X POST https://api.core.today/v1/predictions \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "minimax/music-cover",
"input": {
"audio_url": "https://example.com/my-song.mp3",
"prompt": "Jazz arrangement, saxophone lead, smooth female vocal, mellow piano chords"
}
}'결과는 오디오 URL 1개가 반환됩니다. 가사 구조 태그는 [Intro], [Verse], [Chorus], [Hook], [Drop], [Bridge], [Outro] 등 14종을 지원하며, 자세한 파라미터는 아래 모델 상세 문서를 참고하세요.
Python 전체 예제
생성 요청부터 완료 대기, MP3 다운로드까지 한 번에:
import requests, time
API_KEY = "cdt_your_api_key"
BASE = "https://api.core.today/v1"
headers = {"X-API-Key": API_KEY}
# 1) 음악 생성 요청
job = requests.post(f"{BASE}/predictions", headers=headers, json={
"model": "suno/music-v5-5",
"input": {
"customMode": False,
"instrumental": False,
"prompt": "여름 아침 드라이브에 어울리는 밝은 시티팝",
},
}).json()
job_id = job["job_id"]
# 2) 완료까지 폴링 (보통 1~3분)
while True:
res = requests.get(f"{BASE}/predictions/{job_id}", headers=headers).json()
if res["status"] in ("completed", "failed"):
break
time.sleep(10)
# 3) 결과 사용
if res["status"] == "completed":
for i, track in enumerate(res["result"]["sunoData"]):
print(track["title"], f'{track["duration"]:.0f}초', track["audioUrl"])
mp3 = requests.get(track["audioUrl"]).content
with open(f"track_{i}.mp3", "wb") as f:
f.write(mp3)
else:
print("실패 (크레딧 자동 환불):", res.get("error"))팁 & 주의사항
- 프롬프트 팁 — 간단 모드에서는 분위기·장르·주제·보컬 느낌을 함께 적어주세요. 예: "쓸쓸한 가을밤 감성의 어쿠스틱 발라드, 담백한 남성 보컬, 느린 템포".
- 가사 구조 마커 — 커스텀 모드에서는
[Intro][Verse][Chorus][Bridge][Outro]마커로 곡 구조를 잡아주면 완성도가 올라갑니다. - 결과 URL 보관 — 반환되는 오디오/이미지 URL은 서명된 CDN 링크로 일정 기간 후 만료됩니다. 파일은 콘솔의 Storage 페이지에 영구 보관되며, 필요하면 즉시 다운로드해 두세요.
- 2곡 중 선택 — 같은 요청에서 나온 두 곡은 편곡이 서로 다릅니다. 마음에 드는 트랙의
id를 기억해 두면 보컬 분리에 그대로 쓸 수 있습니다. - 저작권 — 생성된 음악은 워터마크 없이 상업적으로 사용할 수 있습니다.
- 실패 처리 — 금칙어 포함 등으로 생성이 실패하면 요청 시 차감된 크레딧은 자동으로 환불됩니다.