Suno의 텍스트 프롬프트 생성 오디오 모델입니다. [laughs]·[sighs] 같은 비언어 사운드가 포함된 음성은 물론 음악·효과음까지 생성하며, 13개 언어의 100개 이상 화자 프리셋을 제공합니다. 오디오와 함께 음성 연속성을 위한 .npz 히스토리 파일도 반환할 수 있습니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
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-ai/bark",
"input": {
"prompt": "Hello, my name is Suno. And, uh — and I like pizza. [laughs] But I also have other interests such as playing tic tac toe.",
"history_prompt": "en_speaker_6",
"text_temp": 0.7,
"waveform_temp": 0.7
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | No | Hello, my name is Suno. And, uh — and I like pizza. [laughs] But I also have other interests such as playing tic tac toe. | 입력 프롬프트. [laughs], [sighs], [music], 노래용 ♪, 강조용 대문자 지원 |
history_prompt | string | No | - | 화자 프리셋 — en_speaker_0..9, ko_speaker_0..9, announcer 등 13개 언어 131종 announcerde_speaker_0de_speaker_1de_speaker_2de_speaker_3de_speaker_4de_speaker_5de_speaker_6de_speaker_7de_speaker_8de_speaker_9en_speaker_0en_speaker_1en_speaker_2en_speaker_3en_speaker_4en_speaker_5en_speaker_6en_speaker_7en_speaker_8en_speaker_9es_speaker_0es_speaker_1es_speaker_2es_speaker_3es_speaker_4es_speaker_5es_speaker_6es_speaker_7es_speaker_8es_speaker_9fr_speaker_0fr_speaker_1fr_speaker_2fr_speaker_3fr_speaker_4fr_speaker_5fr_speaker_6fr_speaker_7fr_speaker_8fr_speaker_9hi_speaker_0hi_speaker_1hi_speaker_2hi_speaker_3hi_speaker_4hi_speaker_5hi_speaker_6hi_speaker_7hi_speaker_8hi_speaker_9it_speaker_0it_speaker_1it_speaker_2it_speaker_3it_speaker_4it_speaker_5it_speaker_6it_speaker_7it_speaker_8it_speaker_9ja_speaker_0ja_speaker_1ja_speaker_2ja_speaker_3ja_speaker_4ja_speaker_5ja_speaker_6ja_speaker_7ja_speaker_8ja_speaker_9ko_speaker_0ko_speaker_1ko_speaker_2ko_speaker_3ko_speaker_4ko_speaker_5ko_speaker_6ko_speaker_7ko_speaker_8ko_speaker_9pl_speaker_0pl_speaker_1pl_speaker_2pl_speaker_3pl_speaker_4pl_speaker_5pl_speaker_6pl_speaker_7pl_speaker_8pl_speaker_9pt_speaker_0pt_speaker_1pt_speaker_2pt_speaker_3pt_speaker_4pt_speaker_5pt_speaker_6pt_speaker_7pt_speaker_8pt_speaker_9ru_speaker_0ru_speaker_1ru_speaker_2ru_speaker_3ru_speaker_4ru_speaker_5ru_speaker_6ru_speaker_7ru_speaker_8ru_speaker_9tr_speaker_0tr_speaker_1tr_speaker_2tr_speaker_3tr_speaker_4tr_speaker_5tr_speaker_6tr_speaker_7tr_speaker_8tr_speaker_9zh_speaker_0zh_speaker_1zh_speaker_2zh_speaker_3zh_speaker_4zh_speaker_5zh_speaker_6zh_speaker_7zh_speaker_8zh_speaker_9 |
custom_history_prompt | string | No | - | .npz 히스토리 파일로 음성 연속성 유지 (history_prompt보다 우선) |
text_temp | number | No | 0.7 | 텍스트 생성 온도 (1.0 다양, 0.0 보수적) |
waveform_temp | number | No | 0.7 | 파형 생성 온도 (1.0 다양, 0.0 보수적) |
output_full | boolean | No | false | 생성 전체를 .npz 파일로 반환해 히스토리 프롬프트로 재사용 |
이 모델의 custom_history_prompt 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=suno-ai/bark" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:custom_history_prompt=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "suno-ai/bark",
"input": {
"prompt": "your prompt here",
"custom_history_prompt": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 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": "suno-ai/bark",
"input": {
"prompt": "Hello, my name is Suno. And, uh — and I like pizza. [laughs] But I also have other interests such as playing tic tac toe.",
"history_prompt": "en_speaker_6",
"text_temp": 0.7,
"waveform_temp": 0.7
}
}'한국어 화자 프리셋으로 한국어 음성 생성
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-ai/bark",
"input": {
"prompt": "안녕하세요? 오늘은 날씨가 정말 좋네요. [laughs]",
"history_prompt": "ko_speaker_0"
}
}'