跳至主要內容

Mage API · 音訊模型

Seed Audio API

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

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 使用已儲存的音訊參考。

  • 音訊輸出
  • 1版本
  • 19預設每段影片所需 Gems
  • $0.019約合美元

總覽

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 的限制

  • 圖片參考無法與音訊參考同時使用,請擇一傳送。
  • 提示詞最多 2986 個字元。
  • `sample_rate` 須為 8000、16000、24000、32000、44100、48000 其中之一。
  • `speech_rate` 為 -50 到 100 之間的整數。
  • `loudness_rate` 為 -50 到 100 之間的整數。
  • `pitch_rate` 為 -12 到 12 之間的整數。

更多音訊模型

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 餘額,通用所有模型。只需為你生成的內容付費。

Characters社群