Mage API · 音声生成
ボイス・音楽・サウンドを生成するAI音声生成API
Seed Audioなら、ひとつのプロンプトからスピーチ、ナレーション、音楽、効果音を生成。ボイスリファレンスに加え、話す速さ、音量、ピッチの調整にも対応しています。
POST https://api.mage.space/v1/{model}/generateひと目でわかる概要
Mageの音声生成APIは、https://api.mage.space/v1/seed_audio/generate でSeed Audioを実行します。テキストプロンプトを送信すると(ボイスリファレンスや画像も追加可能)、ボイス、音楽、効果音を含む最長120秒の音声ファイルを受け取れます。料金はクリップごとにGemsで支払い、サブスクリプションは不要です。
- 4音声モデル
- $0.019標準の最安価格(1クリップあたり)
- 20同時生成数
- $0月額料金
モデル
Mage APIのすべての音声モデル
料金は1回の生成ごとにGemsで表示しています。標準パックでは1,000 Gemsが$1で、大きいパックにはボーナスGemsが付きます。料金はモデル、解像度、長さによって変わります。ここにはデフォルト設定での料金を表示しており、実際の請求額は各レスポンスのbilling.gems_chargedで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。
| モデル | おすすめの用途 | model_idの値 | デフォルト価格 |
|---|---|---|---|
| Eleven Music | ElevenLabsの楽曲生成。ボーカルありもなしも対応 | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4:演出できるリアルな音声 | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | 歌詞からフルソングを生成、オープンウェイト | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | ひとつのプロンプトからボイス、音楽、効果音を生成 | seed-audio-1.0 | 19 Gems ($0.019) |
クイックスタート
Eleven Music v2.5で音声を生成
MAGE_API_KEYを設定してリクエストを送信し、完了するまでポーリングします。URLのeleven_musicは、上記のどのモデルにも置き換えられます。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
print(request["result"]["url"])使い方
APIキーから完成まで、たった3回の呼び出し
すべてのモデルで、認証方式、非同期リクエストの流れ、フィールド名が共通です。
APIキーを作成
Mageにサインインし、API → APIキーを開いてキーを作成します。キーはmage_sk_で始まり、表示されるのは一度だけです。1つのアカウントで有効なキーは10個まで持てます。
生成をリクエスト
Authorization: Bearerヘッダーを付けて、https://api.mage.space/v1/{model}/generateにJSONボディをPOSTします。レスポンスはすぐに返り、request_id、status、status_urlが含まれます。Idempotency-Keyヘッダーを送れば、リトライしても二重に支払うことはありません。
ポーリングしてダウンロード
statusがcompleted、failed、cancelledのいずれかになるまで、status_urlをポーリングします。完了したリクエストには、画像・動画・音声ファイルを指すresult.urlが含まれ、ファイルは30日間保存されます。
本番運用向け
すべての Mage API リクエストで使える機能
1 つのキーで全モデルに対応
1つのREST APIと1つのGems残高で使える、画像・動画・音声モデル37種。URLパスを変えるだけでモデルを切り替えられます。
生成ごとの従量課金
サブスクリプションも最低利用額もありません。Gems を購入し、リクエストごとに表示価格が差し引かれます。生成に失敗した場合は返却されます(Mage のコンテンツポリシーによりブロックされた場合を除く)。
安全な再試行
冪等キーを使えば、再送信しても二重に課金されず、元のリクエストの結果が返ります。
一貫したキャラクター
キャラクターやリファレンスを一度保存しておけば、プロンプトに @handle と書くだけで、対応するすべてのモデルで使えます。
大きなファイルも入力可能
画像・動画・音声の入力は URL またはデータ URL で送信できます。署名付きアップロードなら最大 100 MB のファイルもアップロード可能です。
20 件の同時生成
1 アカウントで 20 件まで同時に生成できます。上限はご利用内容に応じて引き上げることも可能です。拒否されたリクエストに課金されることはありません。
ユースケース
開発者が音声APIで作っているもの
ナレーションとボイスオーバー
動画、解説コンテンツ、オーディオブック向けのナレーションを生成。話す速さ、音量、ピッチも調整できます。
一貫したボイス
ボイスクリップをリファレンスとして保存し、@handleで指定すれば、複数のクリップで同じボイスを使えます。
効果音
ゲームやアプリ向けの環境音、フォーリー、UIサウンドを、説明文から作成できます。
BGM
SNS用クリップや広告のBGMを、プロンプトから生成できます。
生成動画のサウンドトラック
Seed Audioと動画APIを組み合わせて、音のないモデルで作ったクリップにサウンドを追加できます。
話すエージェント
Claude、ChatGPT、または自作のエージェントから、MCPサーバーやREST API経由で音声を生成できます。
FAQ
よくある質問
音声APIでテキスト読み上げはできますか?
生成できる音声の長さはどれくらいですか?
Mage API の料金はいくらですか?
API を使うには Mage のメンバーシップが必要ですか?
API で生成したものは商用利用できますか?
レート制限はどうなっていますか?
AIエージェントからMage APIを使えますか?
Mage API用のSDKはありますか?
すでに別の生成APIを使っています。何を変更すればいいですか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。