공유 음성 가져오기

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

응답

성공 응답

voiceslist of objects

공유된 음성 목록입니다.

has_moreboolean

다음 페이지에 공유 음성이 더 있는지 여부입니다.

total_countinteger선택 사항기본값 0

쿼리와 일치하는 공유 음성의 총개수입니다.

last_sort_idstring or null선택 사항

오류

422

Unprocessable Entity Error

헤더

쿼리 매개변수

응답

오류