Mage API · 音频模型
Eleven Speech API
ElevenLabs v4:可自由掌控的逼真语音
POST https://api.mage.space/v1/eleven_speech/generate一览
Eleven Speech API 通过 Mage 运行 Eleven v4,接口为 POST https://api.mage.space/v1/eleven_speech/generate。使用默认设置的一次请求消耗 30 Gems(约 $0.03),无需订阅。Eleven Speech 不支持 @handle 提及。
- 音频输出
- 1版本
- 30每段视频消耗的 Gems(默认)
- $0.03约合美元
概览
Eleven Speech API 能做什么
ElevenLabs v4 文字转语音,提供 16 种声音,支持 90 多种语言,可用 [whispers] 或 [laughs] 等音频标签逐句控制演绎。
ElevenLabs 富有表现力的文本转语音,支持 90 多种语言,输出与文本等长的 MP3。方括号中的音频标签可控制演绎方式并添加音效提示:[whispers]、[laughs]、[sarcastic]、[door slams]。
仅凭提示词即可生成。
快速开始
调用 Eleven Speech API
设置 MAGE_API_KEY,提交到 /eleven_speech/generate,然后轮询 status_url,直到请求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_speech/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
"model_id": "eleven-v4"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('eleven_speech', {
prompt: 'Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.',
model_id: 'eleven-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_speech", {
"prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
"model_id": "eleven-v4",
})
print(request["result"]["url"])模型
Eleven Speech 的 model_id 值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| eleven-v4 | Eleven v4 | 是 |
选项
Eleven Speech 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| voice | darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt |
规则
Eleven Speech API 的限制
- 提示词即要朗读的文本,最多 5000 个字符,包含音频标签。
- `voice` 可选值:darian、talia、elara、baxter、eldrin、elowen、kaelen、lawrence、alicia、maisie、warren、jade、caleb、sawyer、florence、wyatt。
- `stability` 的取值范围为 0(更具表现力)到 1(更稳定)。
更多音频模型
Mage 上的其他音频生成 API
Seed Audio API
一条提示词,生成人声、音乐和音效
Eleven Music API
ElevenLabs 歌曲,可带人声或纯音乐
常见问题
常见问题解答
Eleven Speech API 的费用是多少?
使用默认设置(Eleven v4)的一次 Eleven Speech 请求消耗 30 Gems,约 $0.03。其他分辨率、时长和变体会影响价格,具体扣费以返回结果为准。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的生成不予退还。
Eleven Speech API 的端点是什么?
向 POST https://api.mage.space/v1/eleven_speech/generate 发送请求,并在 Authorization: Bearer 请求头中带上你的 Mage API 密钥。响应中包含 status_url,可用来轮询获取结果。
我可以调用哪些 Eleven Speech 模型?
eleven-v4(Eleven v4)。默认模型为 Eleven v4。
Eleven Speech 支持参考图片或角色吗?
Eleven Speech 不接受图片、视频或音频输入,也不支持 @handle 提及。
可以在 Claude 或 ChatGPT 中使用 Eleven Speech 吗?
可以。将 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接说出 Eleven Speech 的名称即可。你的助手会通过 get_model 读取它的选项,并在生成前告知价格。
Eleven Speech 的生成结果会保存多久?
结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。