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

Mage API · 音声モデル

Eleven Music API

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

POST https://api.mage.space/v1/eleven_music/generate

ひと目でわかる概要

Eleven Music APIは、POST https://api.mage.space/v1/eleven_music/generate を通じてMage上でEleven Music v2.5を実行します。デフォルト設定のリクエストは113 Gems(約$0.113)で、サブスクリプションは不要です。Eleven Musicは@handleメンションに対応していません。

  • 音声出力
  • 1バリアント
  • 1131クリップあたりのGems(デフォルト)
  • $0.113米ドル換算の目安

概要

Eleven Music APIでできること

ElevenLabsのEleven Music:説明文から、歌詞とボーカル付きの曲もインストゥルメンタルも生成。長さは最大5分まで、指定したとおりにぴったり仕上がります。

ElevenLabsの音楽モデル:ボーカル入りまたはインストゥルメンタルの曲を、リクエストした長さぴったりのMP3で生成します。アーティスト名を含むプロンプトや著作権で保護された歌詞の引用はElevenLabsに拒否され、リクエストは失敗して返金されます。

プロンプトだけで生成します。

クイックスタート

Eleven Music APIを呼び出す

MAGE_API_KEYを設定し、/eleven_music/generate に送信して、リクエストが完了するまでstatus_urlをポーリングします。

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

モデル

Eleven Musicのmodel_idの値

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

model_id名前デフォルト
eleven-music-v2.5Eleven Music v2.5はい

オプション

Eleven Musicのパラメーター

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

フィールド値
duration10, 30, 60, 120, 180, 300

ルール

Eleven Music APIの制約

  • プロンプトは曲の説明で、最大2000文字です。

その他の音声モデル

Mage のその他の音声生成 API

  • 音声 · 30 Gemsから

    Eleven Speech API

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

  • 音声 · 19 Gems から

    Seed Audio API

    ひとつのプロンプトから音声、音楽、効果音を生成

FAQ

よくある質問

Eleven Music APIの料金はいくらですか?
デフォルト設定(Eleven Music v2.5)でのEleven Musicリクエストは113 Gems、約$0.113です。解像度、長さ、バリエーションを変えると料金が変わり、正確な料金はレスポンスで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによってブロックされた場合は返金されません。
Eleven Music APIのエンドポイントは?
MageのAPIキーを設定したAuthorization: Bearerヘッダーを付けて、POST https://api.mage.space/v1/eleven_music/generate に送信します。レスポンスには、結果をポーリングするためのstatus_urlが含まれます。
呼び出せるEleven Musicのモデルは?
eleven-music-v2.5(Eleven Music v2.5)です。デフォルトはEleven Music v2.5です。
Eleven Musicは参照画像やCharactersに対応していますか?
Eleven Musicは画像・動画・音声の入力を受け付けません。@handleメンションにも対応していません。
ClaudeやChatGPTからEleven Musicを使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Eleven Musicを名指しで頼むだけです。アシスタントはget_modelでオプションを読み取り、生成前に料金を提示します。
Eleven Musicの生成結果はどのくらい保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

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