Chatterbox 소개
Resemble AI의 오픈소스 Chatterbox text-to-speech는 영어 최대 1,000자를 24 kHz 모노 WAV로 읽습니다. 내장 목소리 또는 보낸 짧은 레퍼런스 클립의 목소리를 쓰며 표현력과 변화를 조절합니다.
POST /jobs/createTask에서 모델 이름을 resemble-ai/chatterbox-v1/text-to-speech(으)로 지정하면 호출할 수 있습니다. 6크레딧/회부터(US$0.06). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
exaggeration | 아니요 | How emotional the reading is, from 0 (flat) to 1 (dramatic). ≥ 0 · ≤ 1 · 기본값: 0.5 |
guidance_scale | 아니요 | 프롬프트를 얼마나 엄격히 따를지. ≥ 0.1 · ≤ 1 · 기본값: 0.5 |
reference_audio_url | 아니요 | Optional clip of the voice to imitate; the reading takes on its timbre. |
temperature | 아니요 | Variation between takes, from 0.05 to 2. ≥ 0.05 · ≤ 2 · 기본값: 0.7 |
text | 예 | Up to 1,000 characters of English, read exactly as written. Spell sounds out; tags are read aloud. |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /회 | ≈ USD |
|---|---|---|
| 기본 | 5.4 | US$0.054 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 6크레딧/회(US$0.06)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Chatterbox API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 resemble-ai/chatterbox-v1/text-to-speech, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "resemble-ai/chatterbox-v1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Chatterbox API 질문
Chatterbox API 요금은 얼마인가요?
Chatterbox 가격은 6크레딧(US$0.06) /회입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Chatterbox의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 텍스트 음성 변환: resemble-ai/chatterbox-v1/text-to-speech을(를) 넣으세요.
음성을 선택할 수 있나요?
음성 목록은 없지만 음성을 복제할 수 있습니다. reference_audio_url에 짧은 MP3 또는 WAV 클립을 보내면 낭독이 그 목소리의 음색을 따릅니다. 클립이 없으면 모든 요청은 Chatterbox의 내장 음성을 사용합니다. 슬라이더가 바꾸는 것은 음성이 어떻게 연기하는지이지, 누구의 음성인지가 아닙니다. 사용할 권리가 있는 목소리만 사용하세요.
<laugh>나 [sigh] 같은 태그가 작동하나요?
아니요. 테스트에서 모델은 이런 태그를 단어 그대로 소리 내어 읽었습니다. 대신 소리를 철자로 풀어 쓰세요 — ‘ha…’, ‘mmm…’, ‘ahh…’처럼요. 더 감정적인 낭독을 원하면 exaggeration을 높이세요.
어떤 언어를 읽을 수 있나요?
영어입니다. 이 모델은 다른 언어를 지원하지 않습니다.
Chatterbox API의 제한은 무엇인가요?
텍스트 길이(글자): 1,000; 최대 업로드 크기: 90 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Chatterbox을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Chatterbox을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
