Mage API · 音频模型

Seed Audio API

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

获取 API 密钥在试玩区体验 Seed Audio
POST https://api.mage.space/v1/seed_audio/generate

一览

Seed Audio API 通过 Mage 运行 Seed Audio,端点为 POST https://api.mage.space/v1/seed_audio/generate。使用默认设置的一次请求需要 19 Gems(约 $0.019),无需订阅。Seed Audio 支持在提示词中通过 @handle 引用已保存的音频。

概览

Seed Audio API 能做什么

一条提示词即可生成语音、对话、音乐和音效,输出时长与你指定完全一致的 MP3,范围为 5 秒到 2 分钟。最多可用 3 段音频来匹配音色。

一条提示词即可生成人声、对话、音乐和音效,输出时长与要求完全一致的 MP3。

它支持 image 作为输入。

快速开始

调用 Seed Audio API

设置 MAGE_API_KEY,向 /seed_audio/generate 提交请求,然后轮询 status_url,直到请求完成。

cURL
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"
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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

console.log(request.result.url);
Python
# 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"])

模型

Seed Audio 的 model_id 取值

传入 model_id 即可选择变体。未指定时将使用默认变体。

model_id名称默认
seed-audio-1.0Seed Audio是

选项

Seed Audio 参数

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

字段取值
duration5, 10, 30, 60, 120

输入

Seed Audio 支持的媒体输入

可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。

字段用途
image参考图片。

规则

Seed Audio API 的限制

更多音频模型

Mage 上的其他音频生成 API

常见问题

常见问题解答

Seed Audio API 的费用是多少?

使用默认设置(Seed Audio)的一次 Seed Audio 请求需要 19 Gems,约 $0.019。其他分辨率、时长和版本会改变价格,具体费用以响应中返回的为准。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的请求不予退还。

Seed Audio API 的端点是什么?

向 https://api.mage.space/v1/seed_audio/generate 发送 POST 请求,并在 Authorization: Bearer 请求头中携带你的 Mage API 密钥。响应中包含 status_url,可用于轮询结果。

可以调用哪些 Seed Audio 模型?

seed-audio-1.0(Seed Audio)。默认是 Seed Audio。

Seed Audio 支持参考图片或角色吗?

Seed Audio 支持 image。Seed Audio 支持在提示词中通过 @handle 引用已保存的音频。

可以在 Claude 或 ChatGPT 中使用 Seed Audio 吗?

可以。将 Mage MCP 服务器连接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然后直接说出 Seed Audio 的名称即可。你的助手会通过 get_model 读取可用选项,并在生成前告知价格。

Seed Audio 的生成结果会保存多久?

结果和输入内容会保存 30 天。想长期保留的内容,请下载到你自己的存储空间。

用 Mage 开始开发

一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。

获取 API 密钥在试玩区体验 Seed Audio

相关内容