Pobierz udostępnione głosy

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
}

Pobiera listę udostępnionych głosów.

Parametry zapytania

page_sizeintegerOpcjonalnyDomyślnie 30

Maksymalna liczba współdzielonych głosów do zwrócenia. Nie może przekraczać 100, domyślnie 30.

categoryenumOpcjonalny

Kategoria głosu do filtrowania

Dozwolone wartości:

genderstring or nullOpcjonalny

Płeć używana do filtrowania

agestring or nullOpcjonalny

Wiek używany do filtrowania

accentstring or nullOpcjonalny

Akcent używany do filtrowania

languagestring or nullOpcjonalny

Język używany do filtrowania

localestring or nullOpcjonalny

Ustawienia regionalne używane do filtrowania

searchstring or nullOpcjonalny

Fraza używana do filtrowania

use_caseslist of strings or nullOpcjonalny

Przypadek użycia do filtrowania

descriptiveslist of strings or nullOpcjonalny

Fraza używana do filtrowania

featuredbooleanOpcjonalnyDomyślnie false

Filtruj wyróżnione głosy

min_notice_period_daysinteger or nullOpcjonalny

Filtruj głosy z minimalnym okresem wypowiedzenia wynoszącym podaną liczbę dni.

include_custom_ratesboolean or nullOpcjonalny

Uwzględnij/wyklucz głosy z niestandardowymi stawkami

include_live_moderatedboolean or nullOpcjonalny

Uwzględnij/wyklucz głosy moderowane na żywo

reader_app_enabledbooleanOpcjonalnyDomyślnie false

Filtruj głosy włączone w aplikacji Reader

owner_idstring or nullOpcjonalny

Filtruj głosy według publicznego ID właściciela

sortenumOpcjonalnyDomyślnie created_date

Kryteria sortowania. Musi to być jedna z wartości: created_date, usage_character_count_1y, trending, cloned_by_count.

Dozwolone wartości:

pageintegerOpcjonalnyDomyślnie 0

Odpowiedź

Pomyślna odpowiedź

voiceslist of objects

Lista udostępnionych głosów

has_moreboolean

Czy na kolejnych stronach są dalsze udostępnione głosy.

total_countintegerOpcjonalnyDomyślnie 0

Łączna liczba udostępnionych głosów pasujących do zapytania.

last_sort_idstring or nullOpcjonalny

Błędy

422

Unprocessable Entity Error

Nagłówki

Parametry zapytania

Odpowiedź

Błędy