クローンボイスを作成

クローン手順の第 2 ステップ：アップロードした録音から、自分で名前を付けたボイスをクローンします。クローン自体は無料で、初回合成が成功した時点でクローン料金を 1 回だけ請求します。

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 を渡さない場合は空です。

課金：アップロードとクローンは無料です。クローン料金は 1 回だけで、ボイスの初回合成が成功した時点で差し引かれます（使用記録の明細に voice_clone_activation が 1 項目追加されます）。試聴は音声の文字数分のみ課金され、初回使用には数えません。価格は料金ページを参照してください。

ライフサイクル：クローンに成功すると元の音声とサンプル音声は自動削除され、再度クローンするには改めてアップロードが必要です。クローンに失敗した場合はファイルが保持され、パラメータを変えて再試行できます。クローン後 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 回しか使えません

範囲≥ 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

レスポンス

エラー

関連ページ