ElevenLabs: Eleven Flash v2.5
Eleven Flash v2.5は、多言語の対話応答や音声アプリケーション向けにテキストを音声へ変換します。32言語とリクエストあたり最大40,000文字に対応し、素早い応答を重視するプロファイルでは、数字や名前を読み上げ形式に準備することが役立ちます。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Eleven Flash v2.5は、リアルタイムで対話的なアプリケーション向けに設計された、ElevenLabsの多言語テキスト読み上げモデルです。入力された返答テキストを音声に変換し、素早い応答を重視する特性と、自然な表現、一貫した声の特徴を両立します。メーカーは、音声エージェント、チャットボット、ゲーム、即時のフィードバックが必要なアプリケーション、大規模なテキスト読み上げ変換を代表的な用途として挙げています。
モデルは、Multilingual v2の29言語にハンガリー語、ノルウェー語、ベトナム語を加えた32言語に対応します。文書化された集合には、英語、日本語、中国語、ドイツ語、ヒンディー語、フランス語、韓国語、ポルトガル語、イタリア語、スペイン語、インドネシア語、オランダ語、トルコ語、フィリピノ語、ポーランド語、スウェーデン語、ブルガリア語、ルーマニア語、アラビア語、チェコ語、ギリシャ語、フィンランド語、クロアチア語、マレー語、スロバキア語、デンマーク語、タミル語、ウクライナ語、ロシア語があります。これは英語専用のFlash v2とは異なります。英語の声のアクセントがすべてのローカライズに適切と想定せず、原稿の言語と対応する地域の声を選んでください。
1つのリクエストは最大40,000文字に対応します。メーカーは文字数表とともにおおよその音声時間を示していますが、文字上限は固定の録音時間ではありません。発話速度、言語、句読点、声の表現によって長さが変わります。リアルタイムの返答には、ずっと短い完結したフレーズを使い、長い録音では意味のある節で原稿を分け、境界周辺の文脈を残してください。高い文字上限は原本の準備に有用ですが、途切れない長い返答が聞きやすくなるわけではありません。
数字の正規化は、このモデルの実質的な違いです。Flash v2.5固有の節は、低レイテンシーのプロファイルでは正規化が既定で無効になり、電話番号、日付、金額表記が予期しない形で読まれることがあると述べています。合成前に、意図した読み上げ形式を準備してください。数字が数量、参照コード、1桁ずつ復唱する数字のどれかを決めます。日付は聞き手が聞くべき月日で書き、略語を言葉として読ませる場合は展開形を入力してください。
発音は、表記の書き換えや辞書の別名で誘導できます。メーカーの辞書ガイドは、phonemeルールを名前の挙がったv4、v3、Flash v2に限定し、ほかのエディションには別名を勧めています。そのため、Flash v2.5にFlash v2のphonemeタグ対応を引き継がせるべきではありません。繰り返し登場する名前や用語に望ましい発音を用意し、選択した声で確かめてください。感情表現の説明を通常のテキスト内に指示として入れると、それ自体が読み上げられる場合があります。求める録音のために、余分な指示のない最終原稿を準備してください。
共通のTTSワークフローは、ストリーミング音声と完全な音声生成に対応します。形式群には、MP3、非圧縮16ビットPCM、電話向けμ-lawとA-law、Opusがあります。再生先に合う形式を選び、生成に用いたテキストを音声とともに参照可能なままにしてください。ElevenLabsの音声制御は一貫性や速度に影響し、原稿の言葉と句読点が、意図したリズムの多くを与えます。これらはメーカーのワークフロー上の選択肢であり、特定アプリケーションがすべての制御を公開しているという想定とは別です。製品ガイドはFlash v2.5のSSML breakに明示的に対応し、<break time="1.5s" /> など、最大3秒のポーズを示しています。breakタグが多すぎると、速度に影響したりアーティファクトを生じたりする場合があります。共通の速度制御は0.7〜1.2で、1.0が変更なしです。
アシスタントでは、会話の文に明確な結果を1つと次の行動を1つ準備してください。実用的な文なら、処理が完了したことを伝え、まだ必要な1項目を説明できます。ゲームやチュートリアルでは、ユーザーが行動を続けながら理解できる短さに指示を保ってください。多言語プロジェクトでは、語彙を置き換えるだけでなく実際の表現を調整し、名前、行動、条件の意味を残します。
名前、識別子、日付、長めの説明など、原稿の難しい部分を含む代表的な文章を確認してください。聞き取りやすさ、アクセント、ペース、数字が意図した通りに読まれるかを点検します。メーカーの文書では合成は非決定的なため、似た入力でも正確なテイクは変わり得ます。通知、ヘルプ応答、対話キャラクター、録音説明の再利用可能な成果物として、選択した音声と読み上げテキストの準備を残してください。
Ailoot Ultra · 音声合成 POST /v1/audio/speech elevenlabs/eleven-flash-v2.5
elevenlabs/eleven-flash-v2.5はじめに
Eleven Flash v2.5は、多言語の対話応答や音声アプリケーション向けにテキストを音声へ変換します。32言語とリクエストあたり最大40,000文字に対応し、素早い応答を重視するプロファイルでは、数字や名前を読み上げ形式に準備することが役立ちます。
- 対応する入力
- テキスト
- 結果
- 音声
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 音声合成 POST /v1/audio/speech
- 入力の種類
text- 出力の種類
audio- 出力形式
- mp3
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 elevenlabs/eleven-flash-v2.5 | デフォルト— |
フィールドinput | 種類string | 要件必須 | 値と制限 最小の長さ: 1 最大の長さ: 40,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 | 仕様40000 |
パラメータ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.5
設定別の価格
| 設定 | 課金条件 | 料金 |
|---|---|---|
| 設定ElevenLabs: Eleven Flash v2.5 · 標準設定 | 課金条件デフォルト設定 | 料金 入力 · 入力文字数 $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.5", "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.5
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · ElevenLabs: Eleven Flash v2.5
- 利用できる入力と結果は何ですか?
POST /v1/audio/speech·elevenlabs/eleven-flash-v2.5:text→audio- リクエストはどの項目を使用しますか?
POST /v1/audio/speech·elevenlabs/eleven-flash-v2.5:model,input,voice,response_format- どの制限が適用されますか?
POST /v1/audio/speech·elevenlabs/eleven-flash-v2.5:input.maximum_length:40000