Recupera voci condivise

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
}

Recupera un elenco di voci condivise.

Parametri di query

page_sizeintegerOpzionalePredefinito a 30

Numero massimo di voci condivise da restituire. Non può superare 100; il valore predefinito è 30.

categoryenumOpzionale

Categoria vocale usata per il filtro

Valori consentiti:

genderstring or nullOpzionale

Genere usato per il filtro

agestring or nullOpzionale

Età usata per il filtro

accentstring or nullOpzionale

Accento usato per il filtro

languagestring or nullOpzionale

Lingua usata per il filtro

localestring or nullOpzionale

Lingua utilizzata per il filtro

searchstring or nullOpzionale

Termine di ricerca usato per il filtro

use_caseslist of strings or nullOpzionale

Caso d'uso impiegato per il filtro

descriptiveslist of strings or nullOpzionale

Termine di ricerca usato per il filtro

featuredbooleanOpzionalePredefinito a false

Filtra le voci in evidenza

min_notice_period_daysinteger or nullOpzionale

Filtra le voci con un periodo di preavviso minimo pari al numero di giorni indicato.

include_custom_ratesboolean or nullOpzionale

Includi/escludi le voci con tariffe personalizzate

include_live_moderatedboolean or nullOpzionale

Includi/escludi le voci moderate in tempo reale

reader_app_enabledbooleanOpzionalePredefinito a false

Filtra le voci abilitate per l'app reader

owner_idstring or nullOpzionale

Filtra le voci in base all'ID del proprietario pubblico

sortenumOpzionalePredefinito a created_date

Criteri di ordinamento. Deve essere uno tra: created_date, usage_character_count_1y, trending, cloned_by_count.

Valori consentiti:

pageintegerOpzionalePredefinito a 0

Risposta

Risposta riuscita

voiceslist of objects

L'elenco delle voci condivise

has_moreboolean

Indica se ci sono altre voci condivise nelle pagine successive.

total_countintegerOpzionalePredefinito a 0

Il numero totale di voci condivise corrispondenti alla query.

last_sort_idstring or nullOpzionale

Errori

422

Unprocessable Entity Error

Header

Parametri di query

Risposta

Errori