ボイス・音楽・サウンドを生成するAI音声生成API

ひと目でわかる概要

Mageの音声生成APIは、https://api.mage.space/v1/seed_audio/generate でSeed Audioを実行します。テキストプロンプトを送信すると(ボイスリファレンスや画像も追加可能)、ボイス、音楽、効果音を含む最長120秒の音声ファイルを受け取れます。料金はクリップごとにGemsで支払い、サブスクリプションは不要です。

• 1

  音声モデル

• $0.019

  標準の最安価格(1クリップあたり)

• 20

  同時生成数

• $0

  月額料金

モデル

Mage APIのすべての音声モデル

料金は1回の生成ごとにGemsで表示しています。標準パックでは1,000 Gemsが$1で、大きいパックにはボーナスGemsが付きます。料金はモデル、解像度、長さによって変わります。ここにはデフォルト設定での料金を表示しており、実際の請求額は各レスポンスのbilling.gems_chargedで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。

クイックスタート

Seed Audioで音声を生成

MAGE_API_KEYを設定してリクエストを送信し、完了するまでポーリングします。URLのseed_audioは、上記のどのモデルにも置き換えられます。

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

使い方

APIキーから完成まで、たった3回の呼び出し

すべてのモデルで、認証方式、非同期リクエストの流れ、フィールド名が共通です。

1. 01

   APIキーを作成

   Mageにサインインし、API → APIキーを開いてキーを作成します。キーはmage_sk_で始まり、表示されるのは一度だけです。1つのアカウントで有効なキーは10個まで持てます。

2. 02

   生成をリクエスト

   Authorization: Bearerヘッダーを付けて、https://api.mage.space/v1/{model}/generateにJSONボディをPOSTします。レスポンスはすぐに返り、request_id、status、status_urlが含まれます。Idempotency-Keyヘッダーを送れば、リトライしても二重に支払うことはありません。

3. 03

   ポーリングしてダウンロード

   statusがcompleted、failed、cancelledのいずれかになるまで、status_urlをポーリングします。完了したリクエストには、画像・動画・音声ファイルを指すresult.urlが含まれ、ファイルは30日間保存されます。

本番運用向け

すべての Mage API リクエストで使える機能

ユースケース

開発者が音声APIで作っているもの

FAQ

よくある質問

Mageで開発を始めよう

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

関連情報

• AI画像生成API
• AI動画生成API
• Mage MCPサーバー
• Mage SDK
• Mage for ComfyUI
• すべてのAPIモデル
• APIプレイグラウンド
• APIドキュメント