メインコンテンツへスキップ
POST
/
v3
/
minimax-speech-2.5-turbo-preview
MiniMax Speech-2.5-turbo-preview 同期音声合成
curl --request POST \
  --url https://api.highwayapi.ai/v3/minimax-speech-2.5-turbo-preview \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "text": "<string>",
  "voice_setting": {
    "speed": 123,
    "vol": 123,
    "pitch": 123,
    "voice_id": "<string>",
    "emotion": "<string>",
    "latex_read": true,
    "text_normalization": true
  },
  "audio_setting": {
    "sample_rate": 123,
    "bitrate": 123,
    "format": "<string>",
    "channel": 123
  },
  "pronunciation_dict": {
    "tone": [
      {}
    ]
  },
  "timbre_weights": [
    {
      "voice_id": "<string>",
      "weight": 123
    }
  ],
  "stream": true,
  "stream_options": {
    "exclude_aggregated_audio": true
  },
  "language_boost": "<string>",
  "output_format": "<string>",
  "voice_modify": {
    "pitch": 123,
    "intensity": 123,
    "timbre": 123,
    "sound_effects": "<string>"
  }
}
'
{
  "audio": "<string>",
  "status": 123
}
この API は、テキストから音声への同期生成をサポートし、1 回のテキスト送信は最大 10000 文字です。100 種類以上のシステムボイス、クローンボイスの自由選択に対応しています。音量、ピッチ、話速、出力形式の調整に対応しています。比率に基づくミキシング機能、固定間隔時間の制御に対応しています。mp3, pcm, flac, wav を含む複数の音声仕様・形式に対応し、ストリーミング出力にも対応しています。 長文の音声合成リクエストを送信した後、返却される url の有効期限は url が返却されてから 24 時間である点に注意し、ダウンロード情報の有効時間にご注意ください。
短文生成、音声チャット、オンラインソーシャルなどのシナリオに適しています。処理時間は短いですが、テキスト長の制限は 10000 文字未満です。長文の場合は 非同期呼び出し音声合成 の使用を推奨します。

リクエストヘッダー

Content-Type
string
必須
列挙値: application/json
Authorization
string
必須
Bearer 認証形式: Bearer {{API Key}}。

リクエストボディ

text
string
必須
合成対象のテキスト。長さは 10000 文字未満に制限され、段落の切り替えは改行文字で代替します。(音声内の間隔時間を制御する必要がある場合は、文字の間に <#x#> を追加します。x の単位は秒で、0.01-99.99 をサポートし、小数点以下は最大 2 桁です)。カスタムテキスト間の音声時間間隔をサポートし、カスタムテキスト音声のポーズ時間を実現できます。なお、テキスト間隔時間は、音声として発音できる 2 つのテキストの間に設定する必要があり、複数の連続した時間間隔は設定できません。
voice_setting
object
必須
audio_setting
object
pronunciation_dict
object
timbre_weights
object[]
voice_id とのいずれか一方が必須です
stream
boolean
デフォルト:"false"
ストリーミングするかどうか。デフォルトは false、つまりストリーミングは有効化されません。
stream_options
object
language_boost
string
デフォルト:"null"
指定したマイナー言語および方言の認識能力を強化します。設定後、指定したマイナー言語/方言のシナリオで音声表現を向上できます。マイナー言語の種類が明確でない場合は、“auto” を選択できます。モデルがマイナー言語の種類を自動判断します。以下の値をサポートします:'Chinese', 'Chinese,Yue', 'English', 'Arabic', 'Russian', 'Spanish', 'French', 'Portuguese', 'German', 'Turkish', 'Dutch', 'Ukrainian', 'Vietnamese', 'Indonesian', 'Japanese', 'Italian', 'Korean', 'Thai', 'Polish', 'Romanian', 'Greek', 'Czech', 'Finnish', 'Hindi', 'Bulgarian', 'Danish', 'Hebrew', 'Malay', 'Persian', 'Slovak', 'Swedish', 'Croatian', 'Filipino', 'Hungarian', 'Norwegian', 'Slovenian', 'Catalan', 'Nynorsk', 'Tamil', 'Afrikaans', 'auto'
output_format
string
デフォルト:"hex"
出力結果の形式を制御するパラメータです。選択可能な値は url hex です。デフォルト値は hex です。このパラメータは非ストリーミングシナリオでのみ有効で、ストリーミングシナリオでは hex 形式の返却のみをサポートします。返却される url の有効期限は 24 時間です。
voice_modify
object
ボイスエフェクター設定。このパラメータがサポートする音声形式:
  • 非ストリーミング:mp3, wav, flac
  • ストリーミング:mp3

レスポンス情報

audio
string
合成後の音声セグメント。hex エンコードを使用し、入力で定義された形式 (audio_setting.format) に従って生成されます(mp3/pcm/flac)。返却形式は output_format の定義に従って返却され、stream が true の場合は hex の返却形式のみをサポートします。
status
number
現在の音声ストリーム状態。stream が true の場合のみ返却されます。1 は合成中、2 は合成終了を表します。