Deepgram: Aura-2
Deepgram Aura-2は、英語、スペイン語、ドイツ語、フランス語、オランダ語、イタリア語、日本語の音声を生成します。音声カタログ、テキストに応じたペース、言語固有の発音制御により、音声案内、ナレーション、多言語アプリケーションを支えます。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Aura-2は、英語、スペイン語、ドイツ語、フランス語、オランダ語、イタリア語、日本語の7言語の声を持つDeepgramのテキスト読み上げファミリーです。入力テキストを、カスタマーサービスの返答、電話メニュー、説明、ナレーションの音声へ変換します。メーカーは、ペース、表現力、会話のつなぎ言葉を、入力テキストの表現と文脈への反応として説明しています。
声を言語とタスクに合わせる
各声は、ファミリー、話者、言語で識別されます。カタログはすべての話者を互換とみなさず、アクセントや表現の特徴を区別しています。Thaliaは元気な米国英語の選択肢、Dracoは物語に関連付けられた英国の声、Celesteは会話やアナウンス用途に関連付けられたコロンビアのスペイン語の声です。実際の原稿と聞き手を考えて声を選んでください。
一部のスペイン語の声、Aquila、Carina、Diana、Javier、Selenaは、英語とスペイン語の切り替えに対応します。この機能は名前が挙げられた話者に属し、ファミリー内のすべての声に属するわけではありません。混合言語の文章では、商品名や引用フレーズの意図した言語を残し、そのタスクに対応することが文書化された話者で切り替わりを聞いてください。
読み上げ用のテキストを準備する
Aura-2の書式ガイドは、文末の句読点、質問の疑問符、自然な間のためのカンマ、短い独立したフレーズを推奨しています。合成モデルにメッセージを書かせる指示ではなく、最終的な読み上げテキストを入力してください。有用な案内原稿の例は、「ようこそ。言語を選び、必要なトピックを選択してください。案内はいつでも繰り返せます。」です。句読点が聞き手の行動を分け、モデルに明確なリズムを与えます。
識別子を文字ごとに読む必要がある場合は、文字を分けて表記してください。頭字語を展開し、複数の条件を説明するときに長くつながった文を避けます。メーカーは、コマンドの言葉を引用符で囲み、合成前に文章を声に出して確認することも推奨しています。教育や商品ナレーションでは、重要用語を残しながら、書き言葉の見出しや密なリストを完全な読み上げフレーズへ変えてください。
ペースと発音
メーカーは、英語とスペイン語の速度およびIPA発音制御を文書化しています。Aura-2の話速範囲は0.7〜1.5で、スペイン語では遅い設定が非流暢性を生む場合があるため、0.9〜1.5を推奨しています。このファミリーでは発音と速度を組み合わせられます。IPAの上書きは専門的な名前や用語を対象にでき、Aura-2の慣習ではストレスマーカーを母音の直前に置きます。
発音制御の仕様は、最大500件の上書き、各IPA文字列最大128文字を許可し、そのワークフローの入力テキスト上限を2,000文字としています。Aura-2は、Flux TTSで文書化された明示的なポーズ制御に対応しません。文構造と句読点でリズムを準備し、選んだワークフローで必要な場合は、長い資料を意味的につながった文章へ分割してください。
音声の提供と利用
メーカーは、完全なリクエストの合成と、ストリーミングのテキストから音声への変換ワークフローを提供します。メディアガイドは、ストリーミングの生PCM、mu-law、A-lawと、WAV、MP3、Opus、FLAC、AACなどのファイル向け出力を区別しています。Auraのリクエストワークフローで文書化されたPCM/WAVの既定値は24 kHzです。ファイルコンテナー、サンプルレート、エンコードは有効な組み合わせにする必要があり、電話接続とダウンロードするナレーションファイルでは異なる選択が必要な場合があります。
Aura-2は、初代AuraやFlux TTSとは別のファミリーです。Fluxのターン間状態、割り込みのフィードバック、バッチ専用のポーズ制御を、Aura-2の音声名から推測するべきではありません。有用な出力は、実際の原稿を適切な言語、アクセント、音声表現で読み上げたものです。録音を再利用する前に、名前、言語切り替え、句読点に基づくペース、重要な指示を、意図した聞き手とともに確認してください。
Ailoot Ultra · 音声合成 POST /v1/audio/speech deepgram/aura-2
deepgram/aura-2はじめに
Deepgram Aura-2は、英語、スペイン語、ドイツ語、フランス語、オランダ語、イタリア語、日本語の音声を生成します。音声カタログ、テキストに応じたペース、言語固有の発音制御により、音声案内、ナレーション、多言語アプリケーションを支えます。
- 対応する入力
- テキスト
- 結果
- 音声
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 音声合成 POST /v1/audio/speech
- 入力の種類
text- 出力の種類
audio- 出力形式
- mp3
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 deepgram/aura-2 | デフォルト— |
フィールドinput | 種類string | 要件必須 | 値と制限 最小の長さ: 1 単位: Unicode 文字 | デフォルト— |
フィールドvoice | 種類string | 要件必須 | 値と制限 aura-2-thalia-en, aura-2-agathe-fr, aura-2-agustina-es, aura-2-alvaro-es, aura-2-ama-ja, aura-2-amalthea-en, aura-2-andromeda-en, aura-2-antonia-es, aura-2-apollo-en, aura-2-aquila-es, aura-2-arcas-en, aura-2-aries-en, aura-2-asteria-en, aura-2-athena-en, aura-2-atlas-en, aura-2-aurelia-de, aura-2-aurora-en, aura-2-beatrix-nl, aura-2-callista-en, aura-2-carina-es, aura-2-celeste-es, aura-2-cesare-it, aura-2-cinzia-it, aura-2-cora-en, aura-2-cordelia-en, aura-2-cornelia-nl, aura-2-daphne-nl, aura-2-delia-en, aura-2-demetra-it, aura-2-diana-es, aura-2-dionisio-it, aura-2-draco-en, aura-2-ebisu-ja, aura-2-elara-de, aura-2-electra-en, aura-2-elio-it, aura-2-estrella-es, aura-2-fabian-de, aura-2-flavio-it, aura-2-fujin-ja, aura-2-gloria-es, aura-2-harmonia-en, aura-2-hector-fr, aura-2-helena-en, aura-2-hera-en, aura-2-hermes-en, aura-2-hestia-nl, aura-2-hyperion-en, aura-2-iris-en, aura-2-izanami-ja, aura-2-janus-en, aura-2-javier-es, aura-2-julius-de, aura-2-juno-en, aura-2-jupiter-en, aura-2-kara-de, aura-2-lara-de, aura-2-lars-nl, aura-2-leda-nl, aura-2-livia-it, aura-2-luciano-es, aura-2-luna-en, aura-2-maia-it, aura-2-mars-en, aura-2-melia-it, aura-2-minerva-en, aura-2-neptune-en, aura-2-nestor-es, aura-2-odysseus-en, aura-2-olivia-es, aura-2-ophelia-en, aura-2-orion-en, aura-2-orpheus-en, aura-2-pandora-en, aura-2-phoebe-en, aura-2-pluto-en, aura-2-rhea-nl, aura-2-roman-nl, aura-2-sander-nl, aura-2-saturn-en, aura-2-selena-es, aura-2-selene-en, aura-2-silvia-es, aura-2-sirio-es, aura-2-theia-en, aura-2-uzume-ja, aura-2-valerio-es, aura-2-vesta-en, aura-2-viktoria-de, aura-2-zeus-en | デフォルト— |
フィールドresponse_format | 種類string | 要件必須 | 値と制限 mp3 | デフォルト— |
入力素材の組み合わせ
text_to_speech · 必須: input
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, input, voice, response_format |
パラメータvoice_ids | 仕様aura-2-thalia-en, aura-2-agathe-fr, aura-2-agustina-es, aura-2-alvaro-es, aura-2-ama-ja, aura-2-amalthea-en, aura-2-andromeda-en, aura-2-antonia-es, aura-2-apollo-en, aura-2-aquila-es, aura-2-arcas-en, aura-2-aries-en, aura-2-asteria-en, aura-2-athena-en, aura-2-atlas-en, aura-2-aurelia-de, aura-2-aurora-en, aura-2-beatrix-nl, aura-2-callista-en, aura-2-carina-es, aura-2-celeste-es, aura-2-cesare-it, aura-2-cinzia-it, aura-2-cora-en, aura-2-cordelia-en, aura-2-cornelia-nl, aura-2-daphne-nl, aura-2-delia-en, aura-2-demetra-it, aura-2-diana-es, aura-2-dionisio-it, aura-2-draco-en, aura-2-ebisu-ja, aura-2-elara-de, aura-2-electra-en, aura-2-elio-it, aura-2-estrella-es, aura-2-fabian-de, aura-2-flavio-it, aura-2-fujin-ja, aura-2-gloria-es, aura-2-harmonia-en, aura-2-hector-fr, aura-2-helena-en, aura-2-hera-en, aura-2-hermes-en, aura-2-hestia-nl, aura-2-hyperion-en, aura-2-iris-en, aura-2-izanami-ja, aura-2-janus-en, aura-2-javier-es, aura-2-julius-de, aura-2-juno-en, aura-2-jupiter-en, aura-2-kara-de, aura-2-lara-de, aura-2-lars-nl, aura-2-leda-nl, aura-2-livia-it, aura-2-luciano-es, aura-2-luna-en, aura-2-maia-it, aura-2-mars-en, aura-2-melia-it, aura-2-minerva-en, aura-2-neptune-en, aura-2-nestor-es, aura-2-odysseus-en, aura-2-olivia-es, aura-2-ophelia-en, aura-2-orion-en, aura-2-orpheus-en, aura-2-pandora-en, aura-2-phoebe-en, aura-2-pluto-en, aura-2-rhea-nl, aura-2-roman-nl, aura-2-sander-nl, aura-2-saturn-en, aura-2-selena-es, aura-2-selene-en, aura-2-silvia-es, aura-2-sirio-es, aura-2-theia-en, aura-2-uzume-ja, aura-2-valerio-es, aura-2-vesta-en, aura-2-viktoria-de, aura-2-zeus-en |
パラメータresponse_format | 仕様mp3 |
パラメータmax_input_characters | 仕様null |
パラメータ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.00006 入力文字あたり |
参考料金の詳細
モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。
Deepgram: Aura-2
設定別の価格
| 設定 | 課金条件 | 料金 |
|---|---|---|
| 設定Deepgram: Aura-2 · 標準設定 | 課金条件デフォルト設定 | 料金 入力 · 入力文字数 $0.00006 入力文字あたり |
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": "deepgram/aura-2", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["aura-2-thalia-en", "aura-2-agathe-fr", "aura-2-agustina-es", "aura-2-alvaro-es", "aura-2-ama-ja", "aura-2-amalthea-en", "aura-2-andromeda-en", "aura-2-antonia-es", "aura-2-apollo-en", "aura-2-aquila-es", "aura-2-arcas-en", "aura-2-aries-en", "aura-2-asteria-en", "aura-2-athena-en", "aura-2-atlas-en", "aura-2-aurelia-de", "aura-2-aurora-en", "aura-2-beatrix-nl", "aura-2-callista-en", "aura-2-carina-es", "aura-2-celeste-es", "aura-2-cesare-it", "aura-2-cinzia-it", "aura-2-cora-en", "aura-2-cordelia-en", "aura-2-cornelia-nl", "aura-2-daphne-nl", "aura-2-delia-en", "aura-2-demetra-it", "aura-2-diana-es", "aura-2-dionisio-it", "aura-2-draco-en", "aura-2-ebisu-ja", "aura-2-elara-de", "aura-2-electra-en", "aura-2-elio-it", "aura-2-estrella-es", "aura-2-fabian-de", "aura-2-flavio-it", "aura-2-fujin-ja", "aura-2-gloria-es", "aura-2-harmonia-en", "aura-2-hector-fr", "aura-2-helena-en", "aura-2-hera-en", "aura-2-hermes-en", "aura-2-hestia-nl", "aura-2-hyperion-en", "aura-2-iris-en", "aura-2-izanami-ja", "aura-2-janus-en", "aura-2-javier-es", "aura-2-julius-de", "aura-2-juno-en", "aura-2-jupiter-en", "aura-2-kara-de", "aura-2-lara-de", "aura-2-lars-nl", "aura-2-leda-nl", "aura-2-livia-it", "aura-2-luciano-es", "aura-2-luna-en", "aura-2-maia-it", "aura-2-mars-en", "aura-2-melia-it", "aura-2-minerva-en", "aura-2-neptune-en", "aura-2-nestor-es", "aura-2-odysseus-en", "aura-2-olivia-es", "aura-2-ophelia-en", "aura-2-orion-en", "aura-2-orpheus-en", "aura-2-pandora-en", "aura-2-phoebe-en", "aura-2-pluto-en", "aura-2-rhea-nl", "aura-2-roman-nl", "aura-2-sander-nl", "aura-2-saturn-en", "aura-2-selena-es", "aura-2-selene-en", "aura-2-silvia-es", "aura-2-sirio-es", "aura-2-theia-en", "aura-2-uzume-ja", "aura-2-valerio-es", "aura-2-vesta-en", "aura-2-viktoria-de", "aura-2-zeus-en"]')
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 deepgram/aura-2
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Deepgram: Aura-2
- 利用できる入力と結果は何ですか?
POST /v1/audio/speech·deepgram/aura-2:text→audio- リクエストはどの項目を使用しますか?
POST /v1/audio/speech·deepgram/aura-2:model,input,voice,response_format