Deepgram: Aura-2
Deepgram Aura-2 menjana pertuturan dalam bahasa Inggeris, Sepanyol, Jerman, Perancis, Belanda, Itali dan Jepun. Katalog suaranya, rentak yang mengikuti teks dan kawalan sebutan khusus bahasa menyokong arahan pertuturan, narasi dan aplikasi berbilang bahasa.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Aura-2 ialah keluarga teks ke pertuturan Deepgram dengan suara dalam tujuh bahasa: Inggeris, Sepanyol, Jerman, Perancis, Belanda, Itali dan Jepun. Ia menukar teks yang diberikan kepada pertuturan untuk balasan khidmat pelanggan, menu telefon, penerangan dan narasi. Pengeluar menerangkan rentak, ekspresiviti dan kata pengisi perbualan sebagai respons kepada perkataan dan konteks teks yang diberikan.
Padankan suara dengan bahasa dan tugas
Setiap suara dikenal pasti melalui keluarga, penutur dan bahasanya. Katalog membezakan loghat dan ciri penyampaian dan bukannya menganggap semua penutur boleh saling menggantikan. Thalia ialah pilihan bahasa Inggeris Amerika yang bertenaga; Draco ialah suara British yang dikaitkan dengan penceritaan; Celeste ialah suara bahasa Sepanyol Colombia yang dikaitkan dengan kegunaan perbualan dan pengumuman. Pilih suara dengan mengambil kira skrip sebenar dan pendengar.
Suara bahasa Sepanyol tertentu menyokong pertukaran kod antara bahasa Inggeris dan Sepanyol: Aquila, Carina, Diana, Javier dan Selena. Keupayaan itu milik penutur yang dinamakan tersebut, bukannya setiap suara dalam keluarga ini. Untuk petikan campuran bahasa, kekalkan bahasa yang dimaksudkan bagi nama produk dan frasa petikan, serta dengar peralihannya dengan penutur yang profil terdokumentasinya menyokong tugas tersebut.
Sediakan teks untuk pertuturan
Panduan pemformatan Aura-2 mengesyorkan tanda baca pada penghujung ayat, tanda soal untuk soalan, koma untuk jeda yang semula jadi dan frasa pendek yang berdiri sendiri. Berikan teks pertuturan akhir, bukannya arahan yang meminta pensintesis menulis mesej. Skrip panduan awal yang berguna ialah: “Selamat datang. Pilih bahasa, kemudian pilih topik yang anda perlukan. Anda boleh mengulang arahan pada bila-bila masa.” Tanda baca memisahkan tindakan pendengar dan memberikan irama yang lebih jelas kepada model.
Eja pengecam sebagai huruf berasingan apabila ia mesti dibaca aksara demi aksara. Jelaskan akronim dan elakkan ayat panjang yang bersambung tanpa henti apabila beberapa syarat perlu diterangkan. Pengeluar turut mengesyorkan agar perkataan perintah diletakkan dalam tanda petikan dan sesuatu petikan dibaca kuat untuk diperiksa sebelum sintesis. Untuk narasi pendidikan atau produk, kekalkan istilah penting sambil menukar tajuk bertulis dan senarai padat kepada frasa pertuturan yang lengkap.
Rentak dan sebutan
Pengeluar mendokumenkan kawalan kelajuan dan sebutan IPA untuk bahasa Inggeris dan Sepanyol. Julat kadar pertuturan Aura-2 ialah 0.7 hingga 1.5; untuk bahasa Sepanyol, ia mengesyorkan 0.9 hingga 1.5 kerana tetapan yang lebih perlahan boleh menimbulkan ketidaklancaran pertuturan. Sebutan dan kelajuan boleh digabungkan dalam keluarga ini. Penggantian IPA boleh menyasarkan nama atau istilah khusus, dan konvensyen Aura-2 meletakkan penanda tekanan tepat sebelum vokal.
Spesifikasi kawalan sebutan membenarkan sehingga lima ratus penggantian, dengan setiap rentetan IPA tidak melebihi 128 aksara, serta mendokumenkan had teks input 2,000 aksara bagi aliran kerja itu. Aura-2 tidak menyokong ciri kawalan jeda eksplisit yang didokumenkan untuk Flux TTS. Gunakan struktur ayat dan tanda baca untuk menyediakan irama, dan bahagikan bahan yang lebih panjang kepada petikan yang koheren apabila aliran kerja pilihan memerlukannya.
Penyampaian dan penggunaan audio
Pengeluar menyediakan aliran kerja sintesis permintaan lengkap dan penstriman teks ke audio. Panduan medianya membezakan PCM, mu-law dan A-law penstriman mentah daripada pilihan output berasaskan fail seperti WAV, MP3, Opus, FLAC dan AAC. Tetapan lalai PCM/WAV yang didokumenkan untuk aliran kerja permintaan Aura ialah 24 kHz. Bekas fail, kadar pensampelan dan pengekodan membentuk gabungan yang sah; sambungan telefon dan fail narasi yang boleh dimuat turun mungkin memerlukan pilihan berbeza.
Aura-2 kekal sebagai keluarga yang berasingan daripada Aura generasi pertama dan Flux TTS. Keadaan merentas giliran Flux, maklum balas sampukan dan kawalan jeda khusus kelompoknya bukan ciri yang boleh disimpulkan daripada nama suara Aura-2. Output yang berguna ialah versi pertuturan skrip sebenar dalam bahasa, loghat dan perwakilan audio yang sesuai. Semak nama, pertukaran bahasa, rentak berpandukan tanda baca dan arahan penting bersama pendengar sasaran sebelum menggunakan semula rakaman.
Ailoot Ultra · Penjanaan suara POST /v1/audio/speech deepgram/aura-2
deepgram/aura-2Pengenalan
Deepgram Aura-2 menjana pertuturan dalam bahasa Inggeris, Sepanyol, Jerman, Perancis, Belanda, Itali dan Jepun. Katalog suaranya, rentak yang mengikuti teks dan kawalan sebutan khusus bahasa menyokong arahan pertuturan, narasi dan aplikasi berbilang bahasa.
- Input yang diterima
- Teks
- Hasil
- Audio
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Penjanaan suara POST /v1/audio/speech
- Input
text- Output
audio- Format output
- mp3
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had deepgram/aura-2 | Lalai— |
Medaninput | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 Unit: aksara Unicode | Lalai— |
Medanvoice | Jenisstring | KeperluanDiperlukan | Nilai & had 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 | Lalai— |
Medanresponse_format | Jenisstring | KeperluanDiperlukan | Nilai & had mp3 | Lalai— |
Gabungan bahan input
text_to_speech · Diperlukan: input
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input, voice, response_format |
Parametervoice_ids | Kontrakaura-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 |
Parameterresponse_format | Kontrakmp3 |
Parametermax_input_characters | Kontraknull |
Parameterother_options | Kontrakfalse |
Parameterinput | Kontrakteks UTF-8 tepat; kiraan aksara Unicode tanpa penormalan |
Parametermaterial_types | Kontraktext |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pilih suara yang tepat daripada profil model ini.
Aksara input dan saat audio ialah ukuran penggunaan yang berbeza.
Pelan harga
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Kadar Ailoot
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Unit pengebilan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Unit pengebilan— | Caj Input · Token input — / 1K token Output · Token output — / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
| Konfigurasiaksara input | Jadual kadar— | Unit pengebilanbagi setiap aksara masukan | Caj Input · aksara input $0.00006 bagi setiap aksara masukan |
Butiran tarif rujukan
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
Deepgram: Aura-2
Harga mengikut konfigurasi
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiDeepgram: Aura-2 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Aksara input USD 0.00006 bagi setiap aksara masukan |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Penjanaan suara
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
Terima dan simpan hasil
Ailoot Ultra · Penjanaan suara
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan kandungan lain
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
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Simpan hasil binari dan pengepala yang lengkap. Jika JSON atau berbilang output dikembalikan, simpan setiap item data dan dapatkan setiap URL aset bertandatangan yang sebenar.
Jika respons asal perlu disemak
Simpan operation_id/X-Client-Request-ID asal untuk penyelarasan rekod tanpa penghantaran semula; tiada laluan khusus untuk meninjau status audio.
Medan respons
| Medan | Jenis |
|---|---|
Medanbinary audio | Jenisbytes |
Medanresponse headers | Jenisheaders |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Alias
Alias model
Ailoot Ultra deepgram/aura-2
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Deepgram: Aura-2
- Apakah input dan hasil yang tersedia?
POST /v1/audio/speech·deepgram/aura-2:text→audio- Apakah medan yang digunakan oleh permintaan?
POST /v1/audio/speech·deepgram/aura-2:model,input,voice,response_format