유사한 음성 목록 | ElevenLabs Documentation

{
  "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
}

제공된 오디오 샘플과 유사한 공유 음성 목록을 반환합니다. similarity_threshold와 top_k가 모두 제공되지 않으면 기본값이 적용됩니다.

요청

This endpoint expects a multipart form containing an optional file.

audio_filefile선택 사항

similarity_thresholddouble or null선택 사항

제공된 샘플과 라이브러리 음성 간 음성 유사도 임곗값입니다. 값의 범위는 0~2입니다. 값이 작을수록 더 유사한 음성이 반환됩니다.

top_kinteger or null선택 사항

반환할 가장 유사한 음성 수입니다. similarity_threshold가 제공되면 이 수보다 적은 음성이 반환될 수 있습니다. 값 범위는 1~100입니다.

응답

성공 응답

voiceslist of objects

공유된 음성 목록입니다.

has_moreboolean

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

total_countinteger선택 사항기본값 0

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

last_sort_idstring or null선택 사항

오류

422

Unprocessable Entity Error

헤더

요청

응답

오류