メインコンテンツへスキップ
POST
音声を生成

音声を選ぶ

プロバイダーをまたいで使えるリクエストにするには、トップレベルの voice を設定します。Phaseo はこれをルーティング先のプロバイダーの音声に対応付けます。ルーティング先のプロバイダーとモデルが受け付けない voice を指定すると、param: "voice" 付きで 400 invalid_request_error が返されます。 eleven-labs/eleven-v4 と eleven-labs/eleven-v4-turbo では、カスタムのクローンを含め、20 文字の ElevenLabs ボイスライブラリ ID を指定できます。必要に応じて config.elevenlabs.voice_settings.stability と similarity_boost を設定してください。Eleven v4 は speed と voice_settings.style に対応していません。

プロバイダー固有の音声を渡す

voice の代わりにプロバイダー独自の音声設定を使うには、次を指定します。
  • ElevenLabs: config.elevenlabs.voice_id、config.elevenlabs.voice、または config.elevenlabs.voiceName。
  • Google: config.google.voice_name または config.google.voiceName。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json
model
string
必須
input
string
必須
models
string[]

model の後に試行される、任意の順序付きフォールバックモデルです。model は必須で、常にプライマリモデルです。試行が 429、500、502、503、504 で失敗すると次のエントリーが試行され、その他のエラーはそのまま返されます。最大 25 個のモデル ID またはプリセットを指定でき、重複や model と同じエントリーは無視されます。各試行は個別のリクエストとして検証、記録、課金され、レスポンスの model フィールドとルーティングトレースには、リクエストを処理したモデルが表示されます。ストリーミングリクエストは最初のバイトの送信前にのみフォールバックし、動画と音楽のジョブは送信時にのみフォールバックします。Batch、realtime、council のリクエストは models を拒否します。動的ルートで設定されたフォールバックが優先され、phaseo/auto は models と併用できません。

Required array length: 1 - 25 elements
Minimum string length: 1
例:
voice
string
speed
number
必須範囲: 0.25 <= x <= 4
format
enum<string>
利用可能なオプション:
mp3,
wav,
ogg,
aac
provider
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

config
object

レスポンス

200 - audio/mpeg

音声ファイル

The response is of type file.

最終更新日 2026年11月16日