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

Mage API · 音声モデル

Eleven Speech API

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

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

ひと目でわかる概要

Eleven Speech APIは、MageのPOST https://api.mage.space/v1/eleven_speech/generate でEleven v4を実行します。デフォルト設定のリクエストは30 Gems(約$0.03)で、サブスクは不要です。Eleven Speechでは@ハンドルのメンションは使えません。

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

概要

Eleven Speech APIでできること

ElevenLabs v4のテキスト読み上げ。16種類のボイスと90以上の言語に対応し、[whispers]や[laughs]などのオーディオタグで1行ずつ演出できます。

ElevenLabsの表現力豊かなテキスト読み上げを90以上の言語で提供し、テキストと同じ長さのMP3として出力します。角括弧のオーディオタグで話し方を指定したり、効果音を加えたりできます:[whispers]、[laughs]、[sarcastic]、[door slams]。

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

クイックスタート

Eleven Speech APIを呼び出す

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_speech/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
  "model_id": "eleven-v4"
}' | 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_speech', {
  prompt: 'Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.',
  model_id: 'eleven-v4',
});

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_speech", {
    "prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
    "model_id": "eleven-v4",
})

print(request["result"]["url"])

モデル

Eleven Speechのmodel_idの値

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

model_id名前デフォルト
eleven-v4Eleven v4はい

オプション

Eleven Speech のパラメーター

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

フィールド値
voicedarian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt

ルール

Eleven Speech APIの制約

  • プロンプトは読み上げるテキストで、オーディオタグを含めて最大5000文字です。
  • `voice`は darian、talia、elara、baxter、eldrin、elowen、kaelen、lawrence、alicia、maisie、warren、jade、caleb、sawyer、florence、wyatt のいずれかです。
  • `stability` は 0(表現豊か)から 1(安定)までの値です。

その他の音声モデル

Mage のその他の音声生成 API

  • 音声 · 19 Gems から

    Seed Audio API

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

  • オーディオ · 113 Gems から

    Eleven Music API

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

FAQ

よくある質問

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

Mageで開発を始めよう

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