tts-1-hd
TTS-1 HD mengubah teks tertulis menjadi audio ucapan berkualitas lebih tinggi dengan pilihan suara prasetel, kecepatan, dan enam format keluaran. OpenAI memosisikan HD untuk kualitas narasi dibandingkan profil TTS-1 yang berlatensi lebih rendah, sehingga berguna untuk pembacaan akhir, materi pembelajaran, dan petikan audio yang disunting.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
TTS-1 HD adalah model teks ke suara OpenAI yang dioptimalkan untuk kualitas audio. Masukannya adalah naskah yang telah disiapkan, dan keluarannya berupa audio ucapan. Pilihan HD berbeda dari profil TTS-1 yang berorientasi pada kecepatan: OpenAI menjelaskan bahwa TTS-1 memiliki latensi lebih rendah, tetapi kualitas lebih rendah. Karena itu, HD merupakan pilihan narasi yang berguna ketika kualitas trek suara akhir lebih penting daripada memulai pemutaran secepat mungkin. Artikel tertulis, petikan pelajaran, atau penjelasan yang sudah dipoles dapat menjadi aset lisan.
Masukan utamanya adalah model pilihan, teks yang tepat, dan suara. Referensi ucapan produsen membatasi naskah hingga 4096 karakter per permintaan. Ini menjelaskan panjang masukan tertulis, bukan jaminan durasi audio. Siapkan naskah yang dapat dipahami ketika didengar: jabarkan singkatan ambigu, tentukan bagaimana besaran diucapkan, dan jaga koherensi setiap petikan. Untuk pelajaran atau artikel yang lebih panjang, bagi teks pada batas yang bermakna dan pertahankan urutan pemakaian petikan hasilnya.
Panduan OpenAI saat ini mencantumkan sembilan pilihan bawaan untuk TTS-1 HD: alloy, ash, coral, echo, fable, onyx, nova, sage, dan shimmer. Suara-suara tersebut dioptimalkan untuk bahasa Inggris, sedangkan panduan teks ke suara mendukung generasi ucapan dalam beberapa bahasa dengan memberikan teks dalam bahasa yang dibutuhkan. Perbandingan suara paling berguna dengan naskah representatif yang sama, termasuk nama dan kosakata khusus yang akan muncul dalam materi akhir. Pertahankan konsistensi suara dan kecepatan ketika beberapa klip membentuk satu narasi.
MP3 adalah keluaran bawaan. Opus dan AAC menyediakan format audio terkompresi alternatif; FLAC menyediakan kompresi tanpa kehilangan kualitas; WAV menyediakan audio tanpa kompresi. PCM menyediakan sampel mentah 24 kHz, 16-bit bertanda dengan urutan little-endian tanpa header berkas. Pilihan ini melayani kegunaan berbeda: berkas ringkas untuk distribusi, aset streaming, atau audio untuk alur kerja penyuntingan. OpenAI menyarankan WAV atau PCM untuk waktu respons lebih cepat ketika beban dekode berpengaruh. Memilih format berkas tidak mengubah naskah atau menambahkan model kendali suara terpisah.
Ucapan dapat disampaikan dalam potongan, sehingga pemutar dapat memulai sebelum berkas audio lengkap siap. Ini merupakan streaming teks ke audio; hal ini tidak menetapkan percakapan suara dua arah. Referensi mendukung nilai kecepatan dari 0,25 hingga 4,0, dengan 1,0 sebagai bawaan. Kolom instruksi bahasa alami terpisah tidak berfungsi dengan TTS-1 HD, dan keluaran peristiwa SSE tidak didukung untuk model ini. Kendali yang didokumentasikan adalah naskah, suara prasetel, kecepatan, dan format keluaran, bukan antarmuka arahan aksen atau emosi berbasis prompt dari model ucapan yang lebih baru.
Panduan bahasa mencakup Rusia, Ukraina, Inggris, Prancis, Jerman, Spanyol, Portugis, Italia, Tionghoa, Jepang, Korea, Arab, Hindi, dan Kazakh di antara bahasa yang didukung. Siapkan naskah dalam bahasa sasaran; sintesis mewujudkan teks itu alih-alih menerjemahkannya. Untuk konten pembelajaran, perjelas definisi dan transisi bagian. Untuk petikan audio penjelasan, siapkan pesan yang tepat dan nama yang harus terdengar. Optimasi suara untuk bahasa Inggris tetap relevan ketika mengevaluasi bunyi bahasa dan kosakata tertentu.
Alur kerja HD yang praktis menghasilkan petikan audio untuk didengarkan, ditinjau, lalu dimasukkan ke dalam materi akhir. Periksa bahwa setiap kalimat diucapkan, nama serta besaran dilafalkan secara memadai, dan tempo pilihan mendukung pemahaman. Simpan naskah tertulis bersama audio agar koreksi dapat ditelusuri ke petikan terkait. OpenAI mewajibkan pengungkapan yang jelas bahwa suara yang dihasilkan bersifat buatan. HD menggambarkan keluarga TTS yang berorientasi pada kualitas; nama ini sendiri tidak menjanjikan waktu yang tepat, identitas penutur kustom, atau kendali ekspresif model lain.
Ailoot Ultra · Sintesis ucapan POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdMulai
TTS-1 HD mengubah teks tertulis menjadi audio ucapan berkualitas lebih tinggi dengan pilihan suara prasetel, kecepatan, dan enam format keluaran. OpenAI memosisikan HD untuk kualitas narasi dibandingkan profil TTS-1 yang berlatensi lebih rendah, sehingga berguna untuk pembacaan akhir, materi pembelajaran, dan petikan audio yang disunting.
- Masukan yang diterima
- Teks
- Hasil
- Audio
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Sintesis ucapan POST /v1/audio/speech
- Masukan
text- Keluaran
audio- Format keluaran
- mp3
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan openai/tts-1-hd | Bawaan— |
Kolominput | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 Panjang maksimum: 4.096 Satuan: karakter Unicode | Bawaan— |
Kolomvoice | Jenisstring | PersyaratanWajib | Nilai & batasan alloy | Bawaan— |
Kombinasi bahan masukan
text_to_speech · Wajib: input
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input, voice |
Parametervoice_ids | Kontrakalloy |
Parametermax_input_characters | Kontrak4096 |
Parameterother_options | Kontrakfalse |
Parameterinput | Kontrakteks UTF-8 persis; jumlah karakter Unicode tanpa normalisasi |
Parametermaterial_types | Kontraktext |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pilih suara yang tepat dari profil model ini.
Karakter masukan dan detik audio merupakan satuan pengukuran yang berbeda.
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Tarif Ailoot
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah yang ditagihkan | Jumlah penagihan | Satuan penagihan | Biaya |
|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah yang ditagihkan— | Jumlah penagihan— | Satuan penagihan— | Biaya Masukan · Token masukan — / 1K token Keluaran · Token keluaran — / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiUltra | Jadwal tarif— | Jumlah yang ditagihkanSetiap titik kode Unicode dihitung sebagai satu karakter, termasuk karakter Han. | Jumlah penagihan— | Satuan penagihanper 1K karakter masukan | Biaya Masukan · karakter masukan $0.06 per 1K karakter masukan |
| KonfigurasiPer permintaan | Jadwal tarif— | Jumlah yang ditagihkan— | Jumlah penagihansatu permintaan | Satuan penagihan— | Biaya Masukan $0 per permintaan |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Sintesis ucapan
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 · Sintesis ucapan
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan konten 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, berkas, dan bagian konten yang dikembalikan.
Simpan hasil biner dan header secara lengkap. Jika JSON atau beberapa keluaran dikembalikan, simpan setiap item data dan ambil data dari setiap URL aset bertanda tangan yang benar-benar dikembalikan.
Jika respons asli perlu diperiksa
Simpan operation_id/X-Client-Request-ID asli untuk rekonsiliasi tanpa pengiriman ulang; tidak ada rute polling khusus audio.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolombinary audio | Jenisbytes |
Kolomresponse headers | Jenisheaders |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Alias
Alias model
Ailoot Ultra openai/tts-1-hd
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · tts-1-hd
- Input dan hasil apa yang tersedia?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- Kolom apa yang digunakan permintaan?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- Batasan apa yang berlaku?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096