メインコンテンツへスキップ

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.0Seed Audioはい

オプション

Seed Audio のパラメーター

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

フィールド値
duration5, 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

  • オーディオ · 113 Gems から

    Eleven Music API

    ElevenLabsの楽曲生成。ボーカルありもなしも対応

  • 音声 · 30 Gemsから

    Eleven Speech API

    ElevenLabs v4:演出できるリアルな音声

  • 音声 · 125 Gemsから

    MiniMax Music 3 API

    歌詞からフルソングを生成、オープンウェイト

FAQ

よくある質問

Seed Audio API の料金はいくらですか?
デフォルト設定(Seed Audio)での Seed Audio のリクエストは 19 Gems、約 $0.019 です。解像度、長さ、バージョンを変更すると料金も変わります。正確な料金はレスポンスで確認できます。生成に失敗した場合は返金されますが、Mage のコンテンツポリシーによりブロックされた場合は返金されません。
Seed Audio API のエンドポイントは何ですか?
Mage の API キーを指定した Authorization: Bearer ヘッダーを付けて、POST https://api.mage.space/v1/seed_audio/generate にリクエストします。レスポンスには、結果をポーリングするための 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コミュニティ