无法通过ElevenLabs API调用指定语音ID问题求助

可能原因及对应解决步骤 #

1. 依赖库版本过旧 #

你使用的elevenlabs==0.3.0b0是早期测试版本，可能与当前ElevenLabs API的语音ID映射不兼容。先升级到最新稳定版：

pip install --upgrade elevenlabs

升级后，使用客户端统一调用的方式（避免混用旧版独立函数与新版客户端）：

from elevenlabs import Voice, VoiceSettings, play
from elevenlabs.client import ElevenLabs

client = ElevenLabs(api_key="你的API密钥")

audio = client.generate(
    text="Hello! My name is Ryan.",
    voice=Voice(
        voice_id="rU18Fk3uSDhmg5Xh41o4",
        settings=VoiceSettings(stability=0.71, similarity_boost=0.5, style=0.0, use_speaker_boost=True)
    )
)

play(audio)

2. 语音ID验证 #

通过API主动拉取账号可用语音列表，确认「Ryan Kurk」的正确ID（网页悬停获取的ID可能存在临时不一致的情况）：

from elevenlabs.client import ElevenLabs

client = ElevenLabs(api_key="你的API密钥")
voices = client.voices.get_all()

# 遍历输出所有可用语音的名称与ID
for voice in voices.voices:
    print(f"语音名称: {voice.name}, ID: {voice.voice_id}")

用输出中「Ryan Kurk」对应的ID替换到生成代码中。

3. API密钥与账号权限检查 #

• 确认使用的API密钥所属账号和网页端操作的是同一账号；
• 检查账号订阅等级：部分付费语音仅允许对应订阅等级通过API调用，网页端的试用权限不代表API可用。

4. 指定API端点 #

部分语音可能仅在官方默认端点可用，显式指定端点尝试：

client = ElevenLabs(api_key="你的API密钥", api_url="https://api.elevenlabs.io/v1")

内容的提问来源于stack exchange，提问作者Giacomo