音訊
Chatterbox 聲音複製
上傳簡短的聲音片段、輸入文字,即可下載以該聲音朗讀的 24 kHz WAV。
Chatterbox by Resemble AI
API 參考
透過 REST 提交
使用您的個人 API 金鑰(msk_…),從您自己的工具為此工作負載建立工作。以這種方式啟動的工作,會在您於 您的裝置 連接的同一批裝置上執行——至少須有一部在線上。
POST
https://cp.meshlabs.cloud/v1/organizations/jobs使用 X-Organization-Api-Key: msk_your_personal_api_key 進行驗證。此標頭名稱與組織金鑰相同;個人金鑰使用同一個端點。
輸入檔案:使用同一個 API 金鑰呼叫
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] 等副語言標籤存在於已發布的分詞器中,則會保留為 token。 |
input_audio_url | 否 | — | 要複製的參考片段。選填:未提供片段的目錄工作會使用內建的 default_voice.wav 範例檔,而非使用者的錄音。可上傳檔案或在此裝置上錄音,但不能同時使用兩者。 |
max_new_tokens | 否 | 256 | 起始 token 之後取樣的語音 token 數上限。 |
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
}
}'GET
https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}使用同一個 API 金鑰輪詢,直到 status 進入終止狀態(COMPLETED、FAILED、CANCELED 或 MODERATION_BLOCKED)。啟用內容審核時,工作可能會先處於 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 授權。它複製的是您提供的片段,不會憑空創造名人的聲音,也不是支援七十種語言的錄音室。首次執行會將模型下載到您的裝置上。