Hailuo 音声合成 (Text-to-Speech)¶

1. 概要 (Overview)¶

Hailuo AI は、中国の Minimax によって開発された
高品質な クラウドベース音声合成（TTS） サービスです。
自然な発音、多言語対応、感情表現を特徴とし、
VoiceScriptPlayer では AI キャラクターボイス生成 や 字幕同期 など、
クリエイティブな音声制作環境を提供します。

⚠️ 重要:
Hailuo の API プラン と Web プラン は別々に提供されています。
API 機能は無料では利用できず、
必ず Minimax の API サブスクリプションプラン を契約する必要があります。
契約後は Hailuo サブスクリプション管理ページ で
残りのコイン（使用量） を確認できます。

📘 初めての方へ:
➡ Hailuo 購読と支払いガイドを見る

2. VoiceScriptPlayer での使用方法¶

hailuo-editor

VoiceScriptPlayer の Audio Editor（オーディオエディター） では、
Hailuo エンジンを使ってテキストを直接音声に変換できます。
COEIROINK と同じ UI 構造を持ち、複数の文を同時に合成したり、
各文の長さやタイミングをタイムライン上で調整することが可能です。

🗣️ 基本的な使用手順¶

TextToSpeech エンジンを選択
上部のドロップダウンから Hailuo AI を選択します。
API キーが正しく登録されていれば自動的に接続されます。
テキスト入力
上部のタイムラインまたはテキストボックスに複数の文を入力します。
各文は独立したブロックとして表示され、順序や長さを自由に調整できます。
基本音声設定

項目	説明
言語	使用する言語を選択（日本語・英語・韓国語など）
ボイス	使用する音声プロファイル（例：Thoughtful Woman、Gentle Male など）
感情	話し方やトーン（通常・優しい・元気など）
話速	話す速度（デフォルト 1.0）
ピッチ	声の高さ
ボリューム	音量全体の調整

後処理オプション（任意）
ピッチ、強さ、音色などを細かく調整可能です。
発音辞書機能により、特定の単語や名前の発音をカスタマイズできます。
「エフェクト」項目では、エコーやフィルターなどの簡単な効果を適用できます。
合成とプレビュー
▶ 再生ボタン を押すと、すぐに合成された音声が再生されます。
修正があった場合は自動的に再合成され、プレビューに反映されます。
合成された音声は自動的に Asset/Sound/ フォルダーに保存されます。

💬 字幕設定¶

項目	説明
X / Y	字幕の画面上の位置
FontSize / OutlineSize	フォントサイズとアウトラインの太さ
Dock	字幕の配置位置（上 / 中央 / 下）
Fill / Outline	フォントおよびアウトラインの色設定
プレビュー	合成音声と字幕の同期をリアルタイムで確認可能

🧩 タイムライン制御¶

各文はタイムライン上で個別のブロックとして表示されます。
ブロックをドラッグして位置を移動したり、端をドラッグして長さを調整可能。
タイムライン構造は COEIROINK やビデオトラックと同様に動作します。
複数の文を順に配置して、会話シーン全体を構成できます。

3. 出力パス (Output Path)¶

項目	パス
生成された音声ファイル	自動的に `Asset/Sound/` フォルダーに保存されます
字幕データ	同じフォルダー内に `.srt` またはプロジェクトメタデータとして保存されます

4. 注意事項 (Notes & Limitations)¶

Hailuo API は 無料では利用できません。
Web プランと API プランは別サービス であり、
Web サイト上で音声を合成しても、API 呼び出しには別途料金が発生します。
クラウドベースのため、インターネット接続が必須 です。
一部の音声は感情設定をサポートしていません。
API 呼び出し制限があるため、短い文単位での合成を推奨します。
応答が遅い場合は、Hailuo サーバーの状態やトラフィックを確認してください。

5. ライセンスと出典 (License & Credits)¶

公式サイト: https://www.minimax.io/audio
商用利用可能（ただし Minimax の利用規約を遵守する必要があります）