音声合成 API (POST /v1/audio/speech)
OpenAI /v1/audio/speech 標準仕様に準拠した音声合成コアエンドポイントです。
📥 リクエストパラメータ
| パラメータ名 | 型 | 必須 | デフォルト値 | 説明 |
|---|---|---|---|---|
model | string | いいえ | edgetts | モデルまたは Provider 識別子 (tts-1, edgetts, kokoro) |
input | string | はい | - | 読み上げるテキスト内容 (最大 8,192 文字) |
voice | string | いいえ | alloy | 対象のボイス ID またはエイリアス (alloy, zh-CN-XiaoxiaoNeural) |
response_format | string | いいえ | mp3 | 音声フォーマット: mp3, opus, aac, flac, wav, pcm |
speed | float | いいえ | 1.0 | 再生速度倍率 (0.25 〜 4.0) |
stream | boolean | いいえ | false | HTTP Chunked ストリーミングを有効化するかどうか |
💡 cURL 呼び出し例
bash
curl http://localhost:8030/v1/audio/speech \
-H "Authorization: Bearer sk-onetts-v1-k9L3mX8QZ2sT4vA7wE1rY6u" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"input": "OneTTS 音声合成エンジンへようこそ!",
"voice": "alloy",
"response_format": "mp3"
}' \
--output speech.mp3