Skip to main content
POST
/
v1
/
custom-voices
/
cloned-voice
Create cloned voice
curl --request POST \
  --url https://supertoneapi.com/v1/custom-voices/cloned-voice \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-sup-api-key: <api-key>' \
  --form files='@example-file' \
  --form 'name=<string>' \
  --form 'description=<string>'
{
  "voice_id": "voice_123456789"
}
このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
アップロードされた音声サンプルからボイスをクローニングし、アカウント上にカスタムボイスとして登録します。返された voice_id はプリセットボイスと同じ TTS エンドポイントから直ちに呼び出せます。
API 経由の ボイスクローニングは Free プランではご利用いただけません。Free プランのアカウントでは Supertone Play でクローニングが可能です。

エンドポイント

POST https://supertoneapi.com/v1/custom-voices/cloned-voice
multipart/form-data として送信してください。

リクエストボディ

FieldRequiredDescription
filesクローニング元の音声サンプルです。WAV または MP3、3 MB 未満 である必要があります。
nameボイス名です。最大 100 文字。
description自由記述の説明です。

サンプル品質のヒント

クローン品質を最大化するためのポイント:
  • 背景ノイズが少なく、話者が 1 人のクリーンな音声を使用してください。
  • 5〜30 秒程度あれば十分です。
  • モノラルを推奨します。サンプルレートは高くても問題ありません。

レスポンス

割り当てられた voice_id を含む、新しいカスタムボイスオブジェクトを返します。この ID を保存し、音声生成 に渡して利用してください。

エラー

StatusCause
400 Bad Requestfiles または name が欠落、もしくは name が長すぎます。
413 Payload Too Large音声ファイルが 3 MB を超えています。
415 Unsupported Media Typeファイルが WAV でも MP3 でもありません。
403 ForbiddenFree プランのアカウントです(API 経由のクローニングは許可されていません)。

関連項目

Docs: Custom voices

SDK サンプル付きのライフサイクル解説。

Custom voice example

クローン作成からリスト、呼び出しまでのエンドツーエンド例。

Authorizations

x-sup-api-key
string
header
required

Body

multipart/form-data

Audio file and voice metadata

files
file
required

Audio file to clone voice from (all common audio formats accepted, max 3MB)

name
string
required

Name of the cloned voice

description
string

Description of the cloned voice

Response

Successfully created cloned voice

voice_id
string
required

Unique identifier for the created voice

Example:

"voice_123456789"