コンソール

ボイス生成

POST/v1/audio/voice/generations

テキストと声の説明からボイスまたは音声を生成します。

リクエストパラメータ

フィールド型必須説明
model: string必須

モデルID。安定版モデルIDの使用を推奨します。固定バージョンを再現する必要がある場合は、スナップショットモデルIDを指定できます。

input: string必須

音声を生成するテキスト。

instruction: string必須

声のスタイル、年齢、感情、話速などの説明。

response_format: string任意

同期リクエストの音声形式。非同期タスクの実際の形式は、タスク照会の返却値に準じます。

delivery_method: string任意

結果の受け渡し方法。

create_voice: boolean任意

delivery_method=urlの場合にのみtrueに設定できます。作成に成功すると、JSONの結果でvoice_idが返され、後続のTTSまたはTTSDで使用できます。指定しない場合またはfalseの場合は、音声プレビューのみを生成します。

async: boolean任意

trueに設定すると、非同期タスクを作成してタスクオブジェクトを直ちに返します。

webhook_url: string任意

非同期タスクの完了後にコールバックするHTTPS URL。

戻り値

このエンドポイントは、声の説明に基づいて生成した音声プレビューを返します。同期リクエストでは音声を直接返すか、delivery_method=urlで音声のURLを取得できます。async=trueを渡した場合はタスクIDを返し、結果は後でタスクの取得エンドポイントから取得します。