Seed Audio API

ひと目でわかる概要

Seed Audio API は、POST https://api.mage.space/v1/seed_audio/generate を通じて Mage 上で Seed Audio を実行します。デフォルト設定でのリクエストは 19 Gems(約 $0.019)で、サブスクリプションは不要です。Seed Audio では、プロンプト内で @handle を使って保存済みの音声リファレンスを指定できます。

• 音声

  出力

• 1

  バリアント

• 19

  1クリップあたりの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 をポーリングします。

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"])

モデル

Seed Audio の model_id の値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

オプション

Seed Audio のパラメーター

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

入力

Seed Audio が受け付けるメディア入力

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

ルール

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

FAQ

よくある質問

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。

関連情報

• AI音声生成API
• Seed Audio API リファレンス
• Seed Audio プレイグラウンド
• すべてのAPIモデル
• Mage MCPサーバー