跳至主要内容

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-v4Eleven v4是

选项

Eleven Speech 参数

以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。

字段取值
voicedarian, 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

  • 音频 · 19 Gems 起

    Seed Audio API

    一条提示词,生成人声、音乐和音效

  • 音频 · 起价 113 Gems

    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 余额,畅用所有模型。按生成量付费,用多少付多少。