Create cloned voice
Custom voices
Create cloned voice
サンプル音声ファイルをアップロードして新しいカスタムボイスを登録します。
POST
Create cloned voice
このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
voice_id はプリセットボイスと同じ TTS エンドポイントから直ちに呼び出せます。
API 経由の ボイスクローニングは Free プランではご利用いただけません。Free プランのアカウントでは Supertone Play でクローニングが可能です。
エンドポイント
multipart/form-data として送信してください。
リクエストボディ
| Field | Required | Description |
|---|---|---|
files | ✅ | クローニング元の音声サンプルです。WAV または MP3、3 MB 未満 である必要があります。 |
name | ✅ | ボイス名です。最大 100 文字。 |
description | — | 自由記述の説明です。 |
サンプル品質のヒント
クローン品質を最大化するためのポイント:- 背景ノイズが少なく、話者が 1 人のクリーンな音声を使用してください。
- 5〜30 秒程度あれば十分です。
- モノラルを推奨します。サンプルレートは高くても問題ありません。
レスポンス
割り当てられたvoice_id を含む、新しいカスタムボイスオブジェクトを返します。この ID を保存し、音声生成 に渡して利用してください。
エラー
| Status | Cause |
|---|---|
400 Bad Request | files または name が欠落、もしくは name が長すぎます。 |
413 Payload Too Large | 音声ファイルが 3 MB を超えています。 |
415 Unsupported Media Type | ファイルが WAV でも MP3 でもありません。 |
403 Forbidden | Free プランのアカウントです(API 経由のクローニングは許可されていません)。 |
関連項目
Docs: Custom voices
SDK サンプル付きのライフサイクル解説。
Custom voice example
クローン作成からリスト、呼び出しまでのエンドツーエンド例。
Authorizations
Body
multipart/form-data
Audio file and voice metadata
Response
Successfully created cloned voice
Unique identifier for the created voice
Example:
"voice_123456789"