获取共享音色

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

请求头

查询参数

响应

错误