Mage API · 音声モデル
Seed Audio API
1つのプロンプトから音声、音楽、効果音を生成
POST https://api.mage.space/v1/seed_audio/generateひと目でわかる概要
Seed Audio API は、POST https://api.mage.space/v1/seed_audio/generate を通じて Mage 上で Seed Audio を実行します。デフォルト設定でのリクエストは 19 Gems(約 $0.019)で、サブスクリプションは不要です。Seed Audio では、プロンプト内で @handle を使って保存済みの音声リファレンスを指定できます。
- 音声出力
- 1バリアント
- 191クリップあたりのGems(デフォルト)
- $0.019米ドル換算の目安
概要
Seed Audio API でできること
1つのプロンプトから、ナレーション、会話、音楽、効果音を生成します。長さは5秒から2分まで指定どおりのMP3で出力されます。最大3つの音声クリップから声を合わせることもできます。
1つのプロンプトから、音声、会話、音楽、効果音を、指定した長さぴったりの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.0 | Seed Audio | はい |
オプション
Seed Audio のパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| duration | 5, 10, 30, 60, 120 |
入力
Seed Audio が受け付けるメディア入力
いずれも、httpsのURL、データ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 のその他の音声生成 API
Eleven Music API
ElevenLabsの楽曲生成。ボーカルありもなしも対応
Eleven Speech API
ElevenLabs v4:演出できるリアルな音声
MiniMax Music 3 API
歌詞からフルソングを生成、オープンウェイト
FAQ
よくある質問
Seed Audio API の料金はいくらですか?
Seed Audio API のエンドポイントは何ですか?
Seed Audio ではどのモデルを呼び出せますか?
Seed Audio は参照画像やキャラクターに対応していますか?
Claude や ChatGPT から Seed Audio を使えますか?
Seed Audio の生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。