列出相似音色

POST

/v1/similar-voices

POST

/v1/similar-voices

curl -X POST https://api.elevenlabs.io/v1/similar-voices \
     -H "Content-Type: multipart/form-data" \
     -F audio_file=@<file1>

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

请求头

请求

响应

错误