Obtener voces compartidas

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
}

Obtiene una lista de voces compartidas.

Parámetros de consulta

page_sizeintegerOpcionalValor predeterminado: 30

Número máximo de voces compartidas que se devolverán. No puede superar 100; el valor predeterminado es 30.

categoryenumOpcional

Categoría de voz utilizada para filtrar

Valores permitidos:

genderstring or nullOpcional

Género utilizado para filtrar

agestring or nullOpcional

Edad usada para filtrar

accentstring or nullOpcional

Acento utilizado para filtrar

languagestring or nullOpcional

Idioma utilizado para filtrar

localestring or nullOpcional

Configuración regional utilizada para filtrar

searchstring or nullOpcional

Término de búsqueda utilizado para filtrar

use_caseslist of strings or nullOpcional

Caso de uso utilizado para filtrar

descriptiveslist of strings or nullOpcional

Término de búsqueda utilizado para filtrar

featuredbooleanOpcionalValor predeterminado: false

Filtra voces destacadas

min_notice_period_daysinteger or nullOpcional

Filtra voces con un periodo mínimo de aviso del número de días indicado.

include_custom_ratesboolean or nullOpcional

Incluir/excluir voces con tarifas personalizadas

include_live_moderatedboolean or nullOpcional

Incluir/excluir voces moderadas en directo

reader_app_enabledbooleanOpcionalValor predeterminado: false

Filtra voces habilitadas para la app de lectura

owner_idstring or nullOpcional

Filtra voces por ID de propietario público

sortenumOpcionalValor predeterminado: created_date

Criterios de ordenación. Debe ser uno de los siguientes: created_date, usage_character_count_1y, trending, cloned_by_count.

Valores permitidos:

pageintegerOpcionalValor predeterminado: 0

Respuesta

Respuesta correcta.

voiceslist of objects

La lista de voces compartidas

has_moreboolean

Indica si hay más voces compartidas en las páginas siguientes.

total_countintegerOpcionalValor predeterminado: 0

El número total de voces compartidas que coinciden con la consulta.

last_sort_idstring or nullOpcional

Errores

422

Unprocessable Entity Error

Encabezados

Parámetros de consulta

Respuesta

Errores