様々な条件でボイスをフィルタリングできるSearch Voices APIのパラメータ使用法と検索例を説明します。
パラメータ | 説明 | 例 |
---|---|---|
name | ボイス名で検索(部分一致) | My Voice (→ クローンボイス検索) |
language | ボイスの言語コード(カンマで複数入力可能) | ko 、en 、ja |
gender | ボイスの性別(カンマで複数入力可能) | male 、female |
age | ボイスの年齢層 | teen 、adult 、senior など |
use_case | 推奨用途ベースフィルター | audiobook 、narration 、advertisement など |
style | 感情スタイルフィルター (最初の値がデフォルト) | neutral 、happy 、sad 、angry など |
model | サポートする音声モデル基準フィルター | sona_speech_1 など |
page_size | 1ページ当たり項目数(デフォルト:20、最大:100) | 50 |
next_page_token | ページネーション用トークン | 前のレスポンスで受け取ったnextPageToken 値 |
⚠️ sort
パラメータはサポートしていません。
My Voice
)を検索してvoice_id
を取得できます。
next_page_token
値は前のレスポンスから取得できます。items
配列とnext_page_token
値を含み、各ボイスのvoice_id
、スタイル、サンプルURLなども一緒に提供されます。API key for the service
Number of items per page (default: 20, max: 100)
Search across name. Space separated.
Search across description. Space separated.
Filter by language (comma-separated)
Filter by gender (comma-separated)
Filter by age (comma-separated)
Filter by use case (comma-separated)
Filter by style (comma-separated)
Filter by model (comma-separated)
Token for pagination (obtained from the previous page's response)
Paginated available voices response with next page token
The response is of type object
.