ElevenLabs: Eleven Flash v2
Eleven Flash v2は、応答性が求められる音声対話向けの、ElevenLabsの英語専用テキスト読み上げモデルです。準備したテキストを音声へ変換し、リクエスト上限は30,000文字です。ポーズと単語ごとの発音の制御が文書化されています。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Eleven Flash v2は、応答性が求められる音声アプリケーション向けの、ElevenLabsの英語専用音声合成モデルです。書かれた発話を受け取り、選択した声の音声を生成します。メーカーはFlashを、アシスタントの確認、音声の指示、ゲームの返答など、リアルタイムの会話や対話体験に位置付けています。この名前付きエディションは、多言語のFlash v2.5や、表現豊かなv3・v4ファミリーとは別です。
Flash v2の言語プロファイルは英語です。声は地域のアクセントや特定の調子を与えますが、それでこのエディションが多言語モデルになるわけではありません。意図した聞き手と文の目的に合う声を選んでください。アシスタントの確認、指導用ナレーター、対話キャラクターは、事実の内容が同じでも異なる抑揚を必要とする場合があります。合成前に、実際に聞かせる英語の言葉を準備してください。
1つのリクエストは最大30,000文字に対応します。上限の横に記されたメーカーのおおよその音声時間は、固定時間ではありません。対話的な返答では主な考えを1つと明確な終わりを保ち、長い録音では関連するテキストを文や節の境界で分けます。共通TTSワークフローは、つながる生成の韻律を保持するため、隣接するテキストやリクエスト文脈を文書化しています。そのため、分割しても連続する文章の関係を失う必要はありません。
Flash v2のポーズ制御はSSML breakタグを使います。製品ガイドは、自然な間を要求する例として <break time="1.5s" /> を挙げ、最大3秒を文書化しています。声は間の前後の表現に影響し、タグが多すぎると速度変化、ノイズ、アーティファクトを生じる場合があります。単語ごとではなく、聞き手に切り替えが必要な場所でbreakを使ってください。句読点や三点リーダーも時間に影響しますが、一貫性が低く、ためらうような調子を加える場合があります。
単語ごとに、IPAまたはCMU ArpabetのSSML phoneme表記を使用できます。メーカーは、v2の発音をより予測しやすくするためCMU Arpabetを推奨し、複数語の名前では各単語に別々にphonemeルールを適用するよう説明しています。発音辞書は、繰り返し使う用語の望ましい音素や別名を保持でき、照合は大文字・小文字を区別します。これはv4のネイティブなスラッシュで囲むIPA構文や、Flash v2.5の発音プロファイルとは異なります。
参照コード、日付、略語は、求める読み上げ形式に準備してください。同じ数字でも数量や識別子を表すため、整数として読むか、1桁ずつ読むかを指定します。月日を曖昧でなく書き、言葉として読ませる略語は展開してください。テキスト内の通常の説明指示は、それ自体が読み上げられる場合があります。v3・v4の表現用audioタグは、このエディションについて説明されている制御プロファイルではありません。
メーカーの形式群には、MP3、非圧縮16ビットPCM、電話向けμ-lawとA-law、Opusがあります。共通ワークフローは、完全な録音を返すことも、音声を順次返すこともできます。音声設定は安定性、類似性、ペースに影響し、文書化された速度範囲は0.7〜1.2、1.0が変更なしです。それらの設定は表現を誘導しますが、同一のテイクや最終録音の正確な長さを保証するものではありません。
実用的な英語のヘルプメッセージでは、結果を先に伝えてから次の行動を1つ示します。保存した選択を確認し、関連するフィールド名を明瞭に読み、ユーザーが次にできることを説明してください。チュートリアルでは完全な指示を書き、次の行動の前に間を置きます。選択した音声の難しい名前、数字、移行を確認してください。そのテイクを原稿と発音の準備とともに残せば、再利用できる音声の合図、通知、アシスタントの返答にできます。
Ailoot Ultra · 音声合成 POST /v1/audio/speech elevenlabs/eleven-flash-v2
elevenlabs/eleven-flash-v2はじめに
Eleven Flash v2は、応答性が求められる音声対話向けの、ElevenLabsの英語専用テキスト読み上げモデルです。準備したテキストを音声へ変換し、リクエスト上限は30,000文字です。ポーズと単語ごとの発音の制御が文書化されています。
- 対応する入力
- テキスト
- 結果
- 音声
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 音声合成 POST /v1/audio/speech
- 入力の種類
text- 出力の種類
audio- 出力形式
- mp3
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 elevenlabs/eleven-flash-v2 | デフォルト— |
フィールドinput | 種類string | 要件必須 | 値と制限 最小の長さ: 1 最大の長さ: 30,000 単位: Unicode 文字 | デフォルト— |
フィールドvoice | 種類string | 要件必須 | 値と制限 george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will | デフォルト— |
フィールドresponse_format | 種類string | 要件必須 | 値と制限 mp3 | デフォルト— |
入力素材の組み合わせ
text_to_speech · 必須: input
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, input, voice, response_format |
パラメータvoice_ids | 仕様george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will |
パラメータresponse_format | 仕様mp3 |
パラメータmax_input_characters | 仕様30000 |
パラメータother_options | 仕様false |
パラメータinput | 仕様正確なUTF-8テキスト。正規化せずにUnicode文字数を数えます |
パラメータmaterial_types | 仕様text |
ライフサイクル: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 実際に返された task_id またはメディアライブラリのレコード
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
このモデルのプロファイルから、使用する音声を正確に選択してください。
入力文字数と音声の秒数は、別の計測単位です。
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
Ailootの料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 課金単位 | 料金 |
|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 課金単位— | 料金 入力 · 入力トークン — / 1K トークン 出力 · 出力トークン — / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定入力文字 | 料金表— | 課金単位入力文字あたり | 料金 入力 · 入力文字 $0.00008 入力文字あたり |
参考料金の詳細
モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。
ElevenLabs: Eleven Flash v2
設定別の価格
| 設定 | 課金条件 | 料金 |
|---|---|---|
| 設定ElevenLabs: Eleven Flash v2 · 標準設定 | 課金条件デフォルト設定 | 料金 入力 · 入力文字数 $0.00004 入力文字あたり |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · 音声合成
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "elevenlabs/eleven-flash-v2", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.mp3
結果を受け取って保存
Ailoot Ultra · 音声合成
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
その他のコンテンツ取得
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
バイナリ結果の全体とヘッダーを保存してください。JSON または複数の出力が返された場合は、すべてのデータ項目を保存し、実際に返された署名付きアセット URL から各アセットを取得してください。
元のレスポンスを確認する場合
再送せずに照合できるよう、元の operation_id/X-Client-Request-ID を保存してください。音声専用のポーリングルートはありません。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドbinary audio | 種類bytes |
フィールドresponse headers | 種類headers |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、素材の表現形式、またはパラメーター値が不正です | 次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。 |
レスポンスserver_error | 条件返されたレスポンスは、操作または結果の確認が必要であることを示しています | 次の手順最初に返された操作/タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra elevenlabs/eleven-flash-v2
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · ElevenLabs: Eleven Flash v2
- 利用できる入力と結果は何ですか?
POST /v1/audio/speech·elevenlabs/eleven-flash-v2:text→audio- リクエストはどの項目を使用しますか?
POST /v1/audio/speech·elevenlabs/eleven-flash-v2:model,input,voice,response_format- どの制限が適用されますか?
POST /v1/audio/speech·elevenlabs/eleven-flash-v2:input.maximum_length:30000