APIエンドポイント
Search Voices
様々なキーワードとフィルターで音声を検索してください。
GET
Search Voices APIでは、様々なフィルタリングやソートオプションを使用して、必要な音声を見つけることができます。このガイドでは、検索パラメータを効果的に使用する方法を説明します。
基本的な使用方法
音声を検索するには、/v1/voices/search
にGETリクエストを送信します。複数のパラメータを使用して結果をフィルタリングやソートできます。
検索ロジック
- 同じパラメータ内の複数の値はOR ロジックで結合されます(カンマ区切り)
- 異なるパラメータ間はAND ロジックで結合されます
- パラメータを指定しない場合、名前の昇順でソートされた最初のページの20件の音声が返されます
利用可能なパラメータ
フィルターパラメータ
language
- 利用可能なオプション:
ko
,ja
,en
- 例:
language=en,ko
(英語または韓国語の音声を検索)
gender
- 利用可能なオプション:
male
,female
- 例:
gender=male,female
age
- 利用可能なオプション:
child
,young-adult
,middle-aged
,elder
- 例:
age=young-adult,middle-aged
use_case
- 利用可能なオプション:
advertisement
,announcement
,audiobook
,documentary
,education
,game
- 例:
use_case=game,advertisement
search
- 名前と説明フィールドを検索
- スペースで区切られたキーワードはAND ロジックで検索
- 例:
search=calm professional
ページネーション
page
- 0から開始
- デフォルト値: 0
page_size
- 範囲: 1-100
- デフォルト値: 20
ソート
sort
- デフォルト値:
name:asc
- 利用可能なオプション:
name:asc
,name:desc
age:asc
,age:desc
use_case:asc
,use_case:desc
language:asc
,language:desc
gender:asc
,gender:desc
リクエスト例
レスポンス形式
APIは以下を含むJSONレスポンスを返します:
- 一致する音声のリスト
- 一致の総数
- 現在のページ番号
- ページサイズ
- 総ページ数
レスポンス例
Headers
API key for the service
Query Parameters
Search across name and description
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)
Page number (default: 0)
Number of items per page (default: 20, max: 100)
Sorting criteria (default: name:asc)