创建克隆音色

克隆流程第 2 步：用上传的录音克隆出你命名的音色；克隆本身免费，首次合成成功时收一次克隆费。

POST/v1/voice_clone

传入第 1 步的 file_id 与你自己起的 voice_id，之后把 voice_id 填到 /v1/audio/speech 的 voice 或 /v1/t2a_v2 的 voice_setting.voice_id 即可合成。带上 text 与 model 可拿到试听音频：demo_audio 是 api.hop-base.com 上的下载链接，6 小时内有效；不传 text 时为空。

计费：上传与克隆免费。克隆费只收一次，在音色首次合成成功时一并扣除（使用记录明细多一项 voice_clone_activation）；试听只按语音字符计费，不算首次使用。价格见价格页。

生命周期：克隆成功后源音频与示例音频自动删除，再次克隆须重新上传；克隆失败则保留文件，可换参数重试。克隆后 7 天内未用于合成的音色自动删除，且不收克隆费。音色只属于你的帐户（企业帐户下由企业主名下成员的密钥共享），其他帐户即使知道 voice_id 也用不了。

创建克隆音色

curl https://api.hop-base.com/v1/voice_clone \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": 123456789,
    "voice_id": "MyNarrator01",
    "text": "Hello, this is my cloned voice.",
    "model": "speech-2.8-hd",
    "need_noise_reduction": true
  }'

200application/json

{
  "input_sensitive": false,
  "input_sensitive_type": 0,
  "demo_audio": "https://api.hop-base.com/relay/EXAMPLE-TOKEN",
  "extra_info": {
    "audio_length": 2210,
    "usage_characters": 31
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

请求头

Authorization:必填string

Bearer sk-…：控制台「API 密钥」里创建的密钥，所属分组须包含请求的模型

请求体参数JSON

file_id:必填integer

第 1 步 purpose=voice_clone 上传返回的文件 ID，只能用一次

范围≥ 1

voice_id:必填string

你自己起的音色名，帐户内唯一：由字母、数字、-、_ 组成，以字母开头，不以 - 或 _ 结尾

长度8–256 字符

clone_prompt:可选object

示例片段

text:可选string

试听文本；传了会返回试听音频，按语音字符计费（不算首次使用）

长度≤ 1000 字符

model:可选string

传 text 时必填

可选值speech-2.8-hdspeech-2.8-turbo

language_boost:可选string

与原生入口相同

可选值autoChineseChinese,YueEnglishArabicRussianSpanishFrenchPortugueseGermanTurkishDutchUkrainianVietnameseIndonesianJapaneseItalianKoreanThaiPolishRomanianGreekCzechFinnishHindiBulgarianDanishHebrewMalayPersianSlovakSwedishCroatianFilipinoHungarianNorwegianSlovenianCatalanNynorskTamilAfrikaans

text_validation:可选string

预期文本，用语音识别比对源音频

长度≤ 200 字符

accuracy:可选number

text_validation 的通过阈值；官方默认 0.7

范围0–1

need_noise_reduction:可选boolean

降噪

默认false

need_volume_normalization:可选boolean

音量归一

默认false

aigc_watermark:可选boolean

AIGC 水印

默认false

200克隆成功

input_sensitive:可选boolean

输入是否触发敏感内容

input_sensitive_type:可选integer

敏感内容类型

demo_audio:可选string

试听音频下载链接，6 小时内有效；不传 text 时为空字符串

extra_info:可选object

仅带试听时返回

base_resp:可选object

成功时为 {"status_code": 0, "status_msg": "success"}；错误不走这里，而是非 200 状态码加 error 对象

错误

400file_id 已用过或已过期、voice_id 不合规或已被占用、音频时长超出范围、text_validation 比对未通过、text 超长、传 text 缺 model、未知字段等

401没带密钥、密钥无效或已过期（missing_api_key / invalid_api_key / api_key_expired）

402余额或密钥 / 成员 / 部门额度用完（insufficient_quota）

404模型不在这把密钥的分组里（model_not_found），或路径不属于该分组（route_not_found）

413请求体超过 64 KiB：request body is too large

503voice cloning is temporarily unavailable、voice registry is temporarily unavailable; please retry 等：稍后重试

请求头

请求体参数JSON

返回

错误

相关页面