一个密钥,通用所有模型
28 个图片、视频和音频模型,共用一个 REST API 和一个 Gems 余额。只需更改 URL 路径即可切换模型。
一览
Mage 音频生成 API 在 https://api.mage.space/v1/seed_audio/generate 上运行 Seed Audio。发送文本提示词(可附带声音参考或图片),即可获得最长 120 秒的音频文件,内容可以是人声、音乐或音效。每段音频以 Gems 付费,无需订阅。
1
音频模型
$0.019
默认最低价(每个片段)
20
并发生成数
$0
月费
模型
价格按每次生成计算,以 Gems 计价。标准包 1,000 Gems 售价 $1,更大的套餐还会赠送额外 Gems。价格取决于模型、分辨率和时长;此处显示的是默认设置下的价格,每个响应都会在 billing.gems_charged 中给出实际扣费。生成失败会退还 Gems;因 Mage 内容政策被拦截的则不退还。
| 模型 | 最适合 | model_id 取值 | 默认价格 |
|---|---|---|---|
| Seed Audio | 一条提示词生成人声、音乐和音效 | seed-audio-1.0 | 19 Gems ($0.019) |
快速开始
设置 MAGE_API_KEY,提交请求,然后轮询直到完成。将 URL 中的 seed_audio 替换为上方任意模型即可。
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])工作原理
所有模型共用一套认证方式、一套异步请求流程和相同的字段名称。
登录 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 天。
为生产环境而生
28 个图片、视频和音频模型,共用一个 REST API 和一个 Gems 余额。只需更改 URL 路径即可切换模型。
无需订阅,也没有最低消费。你购买 Gems,每次请求按标价扣费。生成失败会退还 Gems,但因违反 Mage 内容政策而被拦截的除外。
借助幂等键,重试提交时会返回原始请求,不会重复扣费。
只需保存一次角色或参考图,之后在任意提示词中写下 @handle,即可在所有支持的模型中使用。
可通过 URL 或 data URL 传入图片、视频和音频,也可通过签名上传方式上传最大 100 MB 的文件。
每个账号可同时运行 20 个生成任务,并可根据你的使用场景提高上限。被拒绝的请求不会扣费。
使用场景
为视频、讲解内容和有声书生成旁白,并可控制语速、音量和音调。
将一段声音保存为参考,再通过 @handle 提及它,即可在多段音频中保持同一个声音。
根据描述为游戏和应用生成环境音、拟音和界面音效。
用提示词为社交短片和广告制作背景音乐。
将 Seed Audio 与视频 API 搭配使用,为无声模型生成的视频添加声音。
让 Claude、ChatGPT 或你自己的智能体通过 MCP 服务器或 REST API 生成音频。
常见问题
支持。Seed Audio 可以用描述的声音或已保存的声音参考朗读脚本,并提供语速、音量和音调设置。它还能通过同一个提示词输入框生成音乐和音效。
Seed Audio 生成的音频单段最长 120 秒。
没有订阅,也没有月费。每次生成按对应模型的标价以 Gems 支付,标准包中 1,000 Gems 售价 $1。每个模型页面都会列出默认设置下的价格,每次响应也会返回实际扣费金额。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的则不予退还。如果你的余额不足以支付某次请求,该请求会在扣费前被拒绝。
不需要。API 仅使用 Gems。会员方案及其应用内无限生成权益不适用于 API 请求,因此任何有 Gems 的 Mage 账号都可以调用。
可以。你用 Mage 创作的内容(包括通过 API 和 MCP 服务器生成的内容)可用于商业用途。署名我们会很感谢,但不是必须的。
一个账号最多可同时有 20 个生成任务处于排队或运行中。超出后提交会被以 429 拒绝,且不会扣费。如需根据你的使用场景提高上限,请发邮件至 [email protected]。
可以。智能体可以使用密钥调用 REST API,也可以连接 Mage MCP 服务器,它为 Claude、ChatGPT、Claude Code、Grok 和 Cursor 提供十六个现成工具,用于选择模型、查询价格、生成内容以及获取结果。详见MCP 服务器。
有。npm 上的官方 @mage-space/sdk 包和 PyPI 上的 mage-space 均为开源,并为每个模型提供了类型定义。它们会替你提交任务、等待结果、安全重试并上传文件。ComfyUI 用户可以安装 comfyui-mage 节点包。详见Mage SDK。
将你的客户端指向 https://api.mage.space/v1,把 Mage 密钥作为 Bearer 令牌发送,并按模型页面映射你的字段:prompt、aspect_ratio、resolution、duration 和 model_id 在所有 Mage 模型中的用法一致。请求是异步的,所以先提交,再轮询 status_url。
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。