오디오
Chatterbox 음성 복제
짧은 음성 클립을 업로드하고 문장을 입력하면 그 목소리로 된 24 kHz WAV를 다운로드할 수 있습니다.
Chatterbox by Resemble AI
API 레퍼런스
REST로 제출
개인 API 키(msk_…)를 사용하여 내 도구에서 이 워크로드의 작업을 생성하세요. 이렇게 시작한 작업은 내 기기에서 연결한 기기와 동일한 기기에서 실행되며, 최소 한 대는 온라인이어야 합니다.
https://cp.meshlabs.cloud/v1/organizations/jobsX-Organization-Api-Key: msk_your_personal_api_key로 인증합니다. 헤더 이름은 조직 키와 같으며, 개인 키도 같은 엔드포인트를 사용합니다.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign을(를) 호출하고, 반환된 upload_url에 파일을 업로드한 다음, job_spec에 download_url을(를) 전달하세요(예: input_image_url로).요청 본문
{
"workload_type": "chatterbox-tts",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"max_new_tokens": 256,
"repetition_penalty": 1.2
}
}job_spec 필드
| 필드 | 필수 | 기본값 | 설명 |
|---|---|---|---|
prompt | 예 | — | 읽어 줄 영어 텍스트입니다. [laugh], [chuckle] 같은 비언어적 태그는 공개된 토크나이저에 있는 경우 토큰으로 유지됩니다. |
input_audio_url | 아니요 | — | 복제할 참조 클립입니다. 선택 사항이며, 클립이 없는 카탈로그 작업은 사용자 녹음이 아니라 번들된 default_voice.wav 픽스처를 사용합니다. 파일을 업로드하거나 이 기기에서 녹음하세요. 둘 다 사용할 수는 없습니다. |
max_new_tokens | 아니요 | 256 | 시작 토큰 이후 샘플링되는 음성 토큰 수의 상한입니다. |
repetition_penalty | 아니요 | 1.2 | 공식 generation_config 기본값은 1.2입니다. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "chatterbox-tts",
"job_spec": {
"prompt": "A photorealistic lighthouse at dusk",
"max_new_tokens": 256,
"repetition_penalty": 1.2
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}status이(가) 최종 상태(COMPLETED, FAILED, CANCELED 또는 MODERATION_BLOCKED)가 될 때까지 같은 API 키로 폴링하세요. 콘텐츠 검토가 활성화된 경우, 작업은 컴퓨팅 대기열에 들어가기 전에 MODERATION_PENDING 상태로 시작할 수 있습니다. 완료된 작업의 각 출력에는 사전 서명된 download_url 값이 포함됩니다.
생성 응답
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "chatterbox-tts",
"status": "PENDING",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"max_new_tokens": 256,
"repetition_penalty": 1.2
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}완료 응답
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "chatterbox-tts",
"status": "COMPLETED",
"job_spec_json": {
"prompt": "A photorealistic lighthouse at dusk",
"max_new_tokens": 256,
"repetition_penalty": 1.2
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}참조 클립과 읽어 줄 문장을 업로드하세요. Chatterbox가 해당 음성을 복제해 24 kHz WAV로 다운로드할 수 있게 해 줍니다. 연결한 기기에서 무료로 음성을 복제할 수 있습니다. 영어를 지원하며 모델은 MIT 라이선스입니다. 사용자가 제공한 클립을 복제하는 것이며 유명인의 목소리를 만들어 내지 않고, 70개 언어를 지원하는 스튜디오도 아닙니다. 처음 실행할 때는 기기에 모델을 내려받습니다.