Mage API · 音訊模型

Seed Audio API

一個提示詞,生成人聲、音樂與音效

取得 API 金鑰在 Playground 試用 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 URL、data URL,或上傳最大 100 MB 的檔案。

欄位用途
image參考圖片。

規則

Seed Audio API 的限制

更多音訊模型

Mage 上的其他 AI 音訊生成 API

常見問題

常見問題

Seed Audio API 的費用是多少?

以預設設定(Seed Audio)發出一次 Seed Audio 請求,費用為 19 Gems,約 $0.019。其他解析度、長度和版本會影響價格,確切費用會顯示在回應中。生成失敗會退還 Gems;若因違反 Mage 的內容政策而被封鎖,則不予退還。

Seed Audio API 的端點是什麼?

使用 POST 請求 https://api.mage.space/v1/seed_audio/generate,並在 Authorization: Bearer 標頭中帶入你的 Mage API 金鑰。回應會包含 status_url,可用來輪詢結果。

我可以呼叫哪些 Seed Audio 模型?

seed-audio-1.0(Seed Audio)。預設為 Seed Audio。

Seed Audio 支援參考圖片或角色嗎?

Seed Audio 支援 image,並可在提示詞中透過 @handle 使用已儲存的音訊參考。

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

可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然後直接指名要用 Seed Audio。你的助理會透過 get_model 讀取可用選項,並在生成前告知價格。

Seed Audio 的生成結果會保存多久?

結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。

開始使用 Mage 打造你的作品

一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。

取得 API 金鑰在 Playground 試用 Seed Audio

相關內容