Mage API · 音频生成
AI 音频生成 API:人声、音乐与音效一站搞定
用 Seed Audio 一条提示词即可生成语音、旁白、音乐和音效,并支持声音参考,以及语速、音量和音调控制。
POST https://api.mage.space/v1/{model}/generate一览
Mage 音频生成 API 在 https://api.mage.space/v1/seed_audio/generate 上运行 Seed Audio。发送文本提示词(可附带声音参考或图片),即可获得最长 120 秒的音频文件,内容可以是人声、音乐或音效。每段音频以 Gems 付费,无需订阅。
- 4音频模型
- $0.019默认最低价(每个片段)
- 20并发生成数
- $0月费
模型
Mage API 中的全部音频模型
价格按每次生成计算,以 Gems 计价。标准包 1,000 Gems 售价 $1,更大的套餐还会赠送额外 Gems。价格取决于模型、分辨率和时长;此处显示的是默认设置下的价格,每个响应都会在 billing.gems_charged 中给出实际扣费。生成失败会退还 Gems;因 Mage 内容政策被拦截的则不退还。
| 模型 | 最适合 | model_id 取值 | 默认价格 |
|---|---|---|---|
| Eleven Music | ElevenLabs 歌曲,可带人声或纯音乐 | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4:可自由掌控的逼真语音 | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | 根据你的歌词生成完整歌曲,开放权重 | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | 一条提示词生成人声、音乐和音效 | seed-audio-1.0 | 19 Gems ($0.019) |
快速开始
用 Eleven Music v2.5 生成音频
设置 MAGE_API_KEY,提交请求,然后轮询直到完成。把 URL 中的 eleven_music 换成上方任意模型即可。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
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_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
print(request["result"]["url"])工作原理
从 API 密钥到成品,只需三次调用
所有模型共用一套认证方式、一套异步请求流程和相同的字段名称。
创建 API 密钥
登录 Mage,打开 API → API Keys 并创建密钥。密钥以 mage_sk_ 开头,只显示一次。每个账号最多可以有 10 个有效密钥。
提交生成任务
携带 Authorization: Bearer 请求头,向 https://api.mage.space/v1/{model}/generate 发送 JSON 格式的 POST 请求。接口会立即返回 request_id、status 和 status_url。请附上 Idempotency-Key 请求头,这样重试时不会重复扣费。
轮询并下载
持续轮询 status_url,直到状态变为 completed、failed 或 cancelled。请求完成后,result.url 会提供图片、视频或音频文件,文件保留 30 天。
为生产环境而生
每个 Mage API 请求都享有
一个密钥,通用所有模型
一个 REST API、一个 Gems 余额,即可使用 37 个图片、视频和音频模型。只需修改 URL 路径就能切换模型。
按生成次数付费
无需订阅,也没有最低消费。你购买 Gems,每次请求按标价扣费。生成失败会退还 Gems,但因违反 Mage 内容政策而被拦截的除外。
安全重试
借助幂等键,重试提交时会返回原始请求,不会重复扣费。
角色保持一致
只需保存一次角色或参考图,之后在任意提示词中写下 @handle,即可在所有支持的模型中使用。
支持大文件输入
可通过 URL 或 data URL 传入图片、视频和音频,也可通过签名上传方式上传最大 100 MB 的文件。
同时处理 20 个生成任务
每个账号可同时运行 20 个生成任务,并可根据你的使用场景提高上限。被拒绝的请求不会扣费。
使用场景
开发者用音频 API 做什么
旁白与配音
为视频、讲解内容和有声书生成旁白,并可控制语速、音量和音调。
统一的声音
将一段声音保存为参考,再通过 @handle 提及它,即可在多段音频中保持同一个声音。
音效
根据描述为游戏和应用生成环境音、拟音和界面音效。
背景音乐
用提示词为社交短片和广告制作背景音乐。
为生成的视频配乐
将 Seed Audio 与视频 API 搭配使用,为无声模型生成的视频添加声音。
会说话的智能体
让 Claude、ChatGPT 或你自己的智能体通过 MCP 服务器或 REST API 生成音频。
常见问题
常见问题解答
音频 API 支持文字转语音吗?
生成的音频最长可以多久?
Mage API 的费用是多少?
使用 API 需要 Mage 会员吗?
API 生成的内容可以商用吗?
速率限制是多少?
我的 AI 智能体可以使用 Mage API 吗?
Mage API 有 SDK 吗?
我已经在用其他生成 API 了,需要改哪些地方?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。