Obtenir les voix partagées

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
}

Récupère une liste de voix partagées.

Paramètres de requête

page_sizeintegerOptionnelPar défaut 30

Nombre maximal de voix partagées à renvoyer. Ne peut pas dépasser 100 ; 30 par défaut.

categoryenumOptionnel

Catégorie de voix utilisée pour le filtrage

Valeurs autorisées:

genderstring or nullOptionnel

Genre utilisé pour le filtrage

agestring or nullOptionnel

Âge utilisé pour le filtrage

accentstring or nullOptionnel

Accent utilisé pour le filtrage

languagestring or nullOptionnel

Langue utilisée pour le filtrage

localestring or nullOptionnel

Paramètres régionaux utilisés pour le filtrage

searchstring or nullOptionnel

Terme de recherche utilisé pour le filtrage

use_caseslist of strings or nullOptionnel

Cas d’utilisation servant au filtrage

descriptiveslist of strings or nullOptionnel

Terme de recherche utilisé pour le filtrage

featuredbooleanOptionnelPar défaut false

Filtrer les voix mises en avant

min_notice_period_daysinteger or nullOptionnel

Filtrer les voix avec un délai de préavis minimal correspondant au nombre de jours indiqué.

include_custom_ratesboolean or nullOptionnel

Inclure/exclure les voix aux tarifs personnalisés

include_live_moderatedboolean or nullOptionnel

Inclure/exclure les voix modérées en direct

reader_app_enabledbooleanOptionnelPar défaut false

Filtrer les voix activées pour l’application de lecture

owner_idstring or nullOptionnel

Filtrer les voix par ID de propriétaire public

sortenumOptionnelPar défaut created_date

Sort criteria. Must be one of: created_date, usage_character_count_1y, trending, cloned_by_count.

Valeurs autorisées:

pageintegerOptionnelPar défaut 0

Réponse

Réponse réussie

voiceslist of objects

La liste des voix partagées

has_moreboolean

Indique s’il y a d’autres voix partagées dans les pages suivantes.

total_countintegerOptionnelPar défaut 0

Le nombre total de voix partagées correspondant à la requête.

last_sort_idstring or nullOptionnel

Erreurs

422

Unprocessable Entity Error

En-têtes

Paramètres de requête

Réponse

Erreurs