共有音声を取得

GET

/v1/shared-voices

GET

/v1/shared-voices

curl -G https://api.elevenlabs.io/v1/shared-voices \
     -d accent=american \
     -d age=young \
     -d category=professional \
     -d descriptives=tiktok \
     -d featured=true \
     -d gender=male \
     -d include_custom_rates=true \
     -d include_live_moderated=true \
     -d language=en \
     -d locale=en-US \
     -d min_notice_period_days=30 \
     -d owner_id=7c9fab611d9a0e1fb2e7448a0c294a8804efc2bcc324b0a366a5d5232b7d1532 \
     -d reader_app_enabled=true \
     -d search=tiktok \
     -d sort=created_date \
     -d use_cases=audiobook

{
  "voices": [
    {
      "public_owner_id": "63e84100a6bf7874ba37a1bab9a31828a379ec94b891b401653b655c5110880f",
      "voice_id": "sB1b5zUrxQVAFl2PhZFp",
      "date_unix": 1714423232,
      "name": "Alita",
      "accent": "american",
      "gender": "Female",
      "age": "young",
      "descriptive": "calm",
      "use_case": "characters_animation",
      "category": "professional",
      "usage_character_count_1y": 12852,
      "usage_character_count_7d": 12852,
      "play_api_usage_character_count_1y": 12852,
      "cloned_by_count": 11,
      "free_users_allowed": true,
      "live_moderation_enabled": false,
      "featured": false,
      "language": "en",
      "description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
      "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
      "rate": 1,
      "verified_languages": [
        {
          "language": "en",
          "model_id": "eleven_multilingual_v2",
          "accent": "american",
          "locale": "en-US",
          "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3"
        }
      ]
    }
  ],
  "has_more": false,
  "total_count": 0
}

共有ボイスのリストを取得します。

クエリパラメータ

page_sizeintegerオプションデフォルト値 30

返す共有音声の最大数です。100を超えることはできず、デフォルトは30です。

categoryenumオプション

フィルタリングに使用する音声カテゴリ

許可された値:

genderstring or nullオプション

フィルタリングに使用する性別

agestring or nullオプション

フィルタリングに使用する年齢

accentstring or nullオプション

フィルタリングに使用するアクセント

languagestring or nullオプション

フィルタリングに使用する言語

localestring or nullオプション

フィルタリングに使用するロケール

searchstring or nullオプション

絞り込みに使用する検索語

use_caseslist of strings or nullオプション

フィルタリングに使用するユースケース

descriptiveslist of strings or nullオプション

絞り込みに使用する検索語

featuredbooleanオプションデフォルト値 false

注目の音声でフィルタリングします

min_notice_period_daysinteger or nullオプション

指定した日数以上の最小事前通知期間を持つ音声をフィルタリングします。

include_custom_ratesboolean or nullオプション

カスタム料金の音声を含める／除外する

include_live_moderatedboolean or nullオプション

ライブモデレーション対象の音声を含める／除外する

reader_app_enabledbooleanオプションデフォルト値 false

Reader Appで有効な音声をフィルタリングします

owner_idstring or nullオプション

公開オーナーIDで音声をフィルタリングします

sortenumオプションデフォルト値 created_date

並べ替え条件です。created_date、usage_character_count_1y、trending、cloned_by_countのいずれかである必要があります。

許可された値:

pageintegerオプションデフォルト値 0

レスポンス

成功レスポンス。

voiceslist of objects

共有音声のリスト。

has_moreboolean

後続のページに共有音声がさらにあるかどうか。

total_countintegerオプションデフォルト値 0

クエリに一致する共有音声の合計数です。

last_sort_idstring or nullオプション

エラー

422

Unprocessable Entity Error

ヘッダー

クエリパラメータ

レスポンス

エラー