​
現在（2025年5月28日以降）正式版のデプロイが完了しました。

現在の正式API版（/v1/...）が2025年5月28日付でデプロイ完了しており、新規連携時にはもはやサンドボックスエンドポイントを使用せず、/v1版を連携してください。

すでにサンドボックスに連携して使用中の場合：
2025年6月6日以前に/sandbox/... → /v1/...にURLのみを修正すれば完了です。

サンドボックスを連携して使用したことがない場合：
この文書はスキップして、正式版文書のみを参照すれば十分です。

📄 正式文書を見る：APIリファレンス

サンドボックス環境では、既存のボイスIDシステムが完全に刷新されます。
従来の{character-language-style}形式の複雑なボイスIDは廃止され、
今後は****キャラクター単位のvoice_id + パラメータ(**** language、style）の組み合わせでシンプルに呼び出します。

​
🗂 ボイスIDマッピング表のダウンロード

🔗 Voice IDマッピングシートを見る

シートでは既存のOld Voice IDと新規New Voice ID + language/styleパラメータを1:1で確認できます。
例えば、次のように置き換えられます：

Old Voice IDNew Voice IDNamelanguagestyle
wq4QNZra8YVCTWGVXbC91992bbd4758bdcf9c9b0Adamkoneutral
vG4KaR4wwG5mvdCJfyrbWN7d6fa2e0c4abfd9e1acc4cYoonhoenhappy

このマッピング表にはキャラクターごとの様々なスタイルの組み合わせが含まれており、
既存になかったキャラクターや新規スタイルも多数追加されています。

​
✅ 置き換え方法

  1. 既存に使用していたOld Voice IDをマッピング表で検索してください。
  2. 該当するNew Voice IDと一緒に、language/styleパラメータを抽出します。
  3. API呼び出し時、voice_idには新しいIDを入力し、language、styleはパラメータとして一緒に渡してください。
POST /sandbox/text-to-speech/{91992bbd4758bdcf9c9b0}
{
  "text": "例文です。",
  "language": "ko",
  "style": "neutral"
}

​
🧭 参考事項

  • ほとんどの場合、styleはneutralがデフォルト値であり、オプショナルです。
    入力しない場合、システムに設定されたデフォルトスタイルで音声が生成されます。
  • 新しいシステムでは、同じキャラクターIDで様々なスタイル/言語を選択的に呼び出すことができます。

​
❓ 探しているボイスIDが見つかりませんか？

マッピング表で既存に使用していたOld Voice IDが見つからない場合、
そのボイスが新モデルでサポートされていないか、統合された可能性があります。
カスタマーサポートにお問い合わせいただければ、迅速に確認いたします。