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.5 | Eleven Music v2.5 | はい |
オプション
Eleven Musicのパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| duration | 10, 30, 60, 120, 180, 300 |
ルール
Eleven Music APIの制約
- プロンプトは曲の説明で、最大2000文字です。
その他の音声モデル
Mage のその他の音声生成 API
Eleven Speech API
ElevenLabs v4:演出できるリアルな音声
Seed Audio API
ひとつのプロンプトから音声、音楽、効果音を生成
FAQ
よくある質問
Eleven Music APIの料金はいくらですか?
Eleven Music APIのエンドポイントは?
呼び出せるEleven Musicのモデルは?
Eleven Musicは参照画像やCharactersに対応していますか?
ClaudeやChatGPTからEleven Musicを使えますか?
Eleven Musicの生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。