tts-1-hd
TTS-1 HD menukar teks bertulis menjadi audio pertuturan berkualiti lebih tinggi dengan pilihan suara praset, kelajuan dan enam format output. OpenAI meletakkan HD sebagai pilihan untuk kualiti narasi, berbanding profil TTS-1 yang mempunyai kependaman lebih rendah, menjadikannya berguna untuk bacaan audio siap, bahan pembelajaran dan petikan audio yang disunting.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
TTS-1 HD ialah model teks-ke-pertuturan OpenAI yang dioptimumkan untuk kualiti audio. Skrip yang disediakan menjadi inputnya dan audio pertuturan menjadi outputnya. Pilihan HD berbeza daripada profil TTS-1 yang berorientasikan kelajuan: OpenAI menggambarkan TTS-1 sebagai mempunyai kependaman lebih rendah tetapi kualiti lebih rendah. Oleh itu, HD ialah pilihan narasi yang berguna apabila trek suara siap lebih penting daripada memulakan main balik secepat mungkin. Artikel bertulis, petikan pelajaran atau penerangan yang diperhalus boleh menjadi aset pertuturan.
Input terasnya ialah model terpilih, teks yang tepat dan suara. Rujukan pertuturan pengeluar mengehadkan skrip kepada 4096 aksara bagi setiap permintaan. Itu menerangkan panjang input bertulis, bukannya jaminan tempoh audio. Sediakan skrip yang boleh difahami apabila didengar: kembangkan singkatan yang kabur, tentukan cara kuantiti dituturkan dan pastikan setiap petikan koheren. Untuk pelajaran atau artikel yang lebih panjang, bahagikan teks pada sempadan yang bermakna dan simpan susunan penggunaan petikan yang terhasil.
Panduan OpenAI semasa menyenaraikan sembilan pilihan terbina dalam bagi TTS-1 HD: alloy, ash, coral, echo, fable, onyx, nova, sage dan shimmer. Suara tersebut dioptimumkan untuk bahasa Inggeris, manakala panduan teks-ke-pertuturan menyokong penjanaan pertuturan dalam beberapa bahasa dengan membekalkan teks dalam bahasa yang diperlukan. Perbandingan suara paling berguna apabila menggunakan skrip wakil yang sama, termasuk nama dan kosa kata khusus yang akan muncul dalam bahan akhir. Kekalkan suara dan kelajuan yang konsisten apabila beberapa klip membentuk satu narasi.
MP3 ialah output lalai. Opus dan AAC menyediakan format audio termampat alternatif; FLAC menyediakan pemampatan tanpa kehilangan; WAV menyediakan audio tanpa pemampatan. PCM membekalkan sampel mentah 24 kHz, 16-bit bertanda little-endian tanpa pengepala fail. Pilihan ini memenuhi kegunaan yang berbeza: fail padat untuk pengedaran, aset penstriman atau audio untuk disalurkan ke aliran kerja penyuntingan. OpenAI mengesyorkan WAV atau PCM untuk masa respons lebih pantas apabila beban penyahkodan menjadi pertimbangan. Pemilihan format fail tidak mengubah skrip atau menambah model kawalan suara yang berasingan.
Pertuturan boleh dihantar dalam cebisan, membolehkan pemain bermula sebelum keseluruhan fail audio tersedia. Ini ialah penstriman teks-ke-audio; ia tidak mewujudkan perbualan suara dua hala. Rujukan menyokong nilai kelajuan daripada 0.25 hingga 4.0, dengan 1.0 sebagai lalai. Medan arahan bahasa semula jadi yang berasingan tidak berfungsi dengan TTS-1 HD, dan output peristiwa SSE tidak disokong untuk model ini. Skrip, suara praset, kelajuan dan format output ialah kawalan yang didokumentasikan, berbanding antara muka arahan loghat atau emosi pada model pertuturan yang lebih baharu.
Panduan bahasa merangkumi bahasa Rusia, Ukraine, Inggeris, Perancis, Jerman, Sepanyol, Portugis, Itali, Cina, Jepun, Korea, Arab, Hindi dan Kazakh antara bahasa yang disokongnya. Sediakan skrip dalam bahasa sasaran; sintesis menyuarakan teks itu dan bukannya menterjemahkannya. Untuk kandungan pembelajaran, pastikan takrif dan peralihan bahagian jelas. Untuk petikan audio penerangan, sediakan mesej tepat dan sebarang nama yang mesti didengar. Pengoptimuman suara untuk bahasa Inggeris tetap relevan apabila menilai bunyi sesuatu bahasa dan kosa kata tertentu.
Aliran kerja HD yang praktikal menghasilkan petikan audio untuk didengar, disemak dan kemudian dimasukkan ke dalam bahan siap. Periksa bahawa setiap ayat telah disuarakan, nama dan kuantiti disebut dengan memuaskan, serta kadar pertuturan yang dipilih membantu pemahaman. Simpan skrip bertulis bersama audio supaya pembetulan boleh dijejak kepada petikan yang berkaitan. OpenAI mewajibkan pendedahan jelas bahawa suara yang dijana adalah buatan. HD menerangkan keluarga TTS yang berorientasikan kualiti; ia sendiri tidak menjanjikan pemasaan tepat, identiti penutur tersuai atau kawalan ekspresif model yang berbeza.
Ailoot Ultra · Penjanaan suara POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdPengenalan
TTS-1 HD menukar teks bertulis menjadi audio pertuturan berkualiti lebih tinggi dengan pilihan suara praset, kelajuan dan enam format output. OpenAI meletakkan HD sebagai pilihan untuk kualiti narasi, berbanding profil TTS-1 yang mempunyai kependaman lebih rendah, menjadikannya berguna untuk bacaan audio siap, bahan pembelajaran dan petikan audio yang disunting.
- 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 openai/tts-1-hd | Lalai— |
Medaninput | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 Panjang maksimum: 4,096 Unit: aksara Unicode | Lalai— |
Medanvoice | Jenisstring | KeperluanDiperlukan | Nilai & had alloy | Lalai— |
Gabungan bahan input
text_to_speech · Diperlukan: input
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input, voice |
Parametervoice_ids | Kontrakalloy |
Parametermax_input_characters | Kontrak4096 |
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 | Kuantiti yang boleh dibilkan | Kuantiti pengebilan | Unit pengebilan | Caj |
|---|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti yang boleh dibilkan— | Kuantiti pengebilan— | 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 |
| KonfigurasiUltra | Jadual kadar— | Kuantiti yang boleh dibilkanSetiap titik kod Unicode dikira sebagai satu aksara, termasuk aksara Han. | Kuantiti pengebilan— | Unit pengebilanbagi setiap 1K aksara masukan | Caj Input · aksara input $0.06 bagi setiap 1K aksara masukan |
| KonfigurasiBagi setiap permintaan | Jadual kadar— | Kuantiti yang boleh dibilkan— | Kuantiti pengebilansatu permintaan | Unit pengebilan— | Caj Input $0 bagi setiap permintaan |
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}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/tts-1-hd", "input": "Good afternoon! This is a short voice take.", "voice": "alloy"}')
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 openai/tts-1-hd
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · tts-1-hd
- Apakah input dan hasil yang tersedia?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- Apakah medan yang digunakan oleh permintaan?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- Apakah had yang terpakai?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096