tts-1-hd
A TTS-1 HD írott szöveget alakít jobb minőségű beszédhanggá választható előre beállított hangokkal, sebességgel és hat kimeneti formátummal. Az OpenAI a HD-nél a narráció minőségére helyezi a hangsúlyt a TTS-1 kisebb késleltetésű működésével szemben, így kész felolvasásokhoz, tananyagokhoz és szerkesztett hangrészletekhez hasznos.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A TTS-1 HD az OpenAI hangminőségre optimalizált szövegfelolvasó modellje. Bemenete előkészített szöveg, kimenete beszédhang. A HD választás különbözik a TTS-1 sebességközpontú működésétől: az OpenAI a TTS-1-et kisebb késleltetésűnek, de gyengébb minőségűnek írja le. A HD ezért hasznos narrációs választás, ha a kész hangsáv fontosabb, mint a lejátszás lehető leggyorsabb megkezdése. Írott cikk, leckeszakasz vagy gondosan kidolgozott magyarázat válhat hanganyaggá.
Az alapvető bemenetek a kiválasztott modell, a pontos szöveg és a hang. A gyártó beszédreferenciája kérésenként 4096 karakterre korlátozza a szöveget. Ez az írott bemenet hosszát írja le, nem hangidőtartam-garancia. Meghallgatva is érthető szöveget készíts: bontsd ki a kétértelmű rövidítéseket, döntsd el a mennyiségek kimondását, és minden részlet maradjon összefüggő. Hosszabb leckénél vagy cikknél értelmes határoknál oszd fel a szöveget, és őrizd meg az elkészült részletek felhasználási sorrendjét.
Az OpenAI jelenlegi útmutatója kilenc beépített lehetőséget sorol fel a TTS-1 HD-hez: alloy, ash, coral, echo, fable, onyx, nova, sage és shimmer. A hangokat angolra optimalizálták, míg a szövegfelolvasási útmutató többnyelvű beszédgenerálást támogat a szükséges nyelven megadott szöveggel. A hang-összehasonlítás ugyanazzal a reprezentatív szöveggel a leghasznosabb, benne a végleges anyagban szereplő nevekkel és szakszókinccsel. Több klipből álló narrációnál a hang és sebesség maradjon következetes.
Az alapértelmezett kimenet MP3. Az Opus és AAC alternatív tömörített hangformátumokat ad; a FLAC veszteségmentes tömörítést, a WAV tömörítetlen hangot biztosít. A PCM nyers, 24 kHz-es, 16 bites, előjeles little-endian mintákat ad fájlfejléc nélkül. Ezek eltérő célokat szolgálnak: kis méretű terjeszthető fájlt, streamelhető anyagot vagy szerkesztési munkafolyamatnak átadható hangot. Az OpenAI gyorsabb válaszidőhöz WAV-ot vagy PCM-et ajánl, ha a dekódolási többlet számít. A fájlformátum kiválasztása nem módosítja a szöveget, és nem ad külön hangvezérlő modellt.
A beszéd darabokban is átadható, így a lejátszó a teljes hangfájl elkészülése előtt indulhat. Ez szöveg–hang streamelés; nem igazol kétirányú hangbeszélgetést. A referencia 0.25–4.0 sebességértéket támogat 1.0 alapértékkel. A külön természetes nyelvű instructions mező nem működik a TTS-1 HD-vel, és a modell az SSE-eseménykimenetet sem támogatja. A dokumentált vezérlők a szöveg, előre beállított hang, sebesség és kimeneti formátum, nem az újabb beszédmodellek prompttal vezérelt akcentus- vagy érzelmi irányítási felülete.
A nyelvi útmutató támogatott nyelvei között orosz, ukrán, angol, francia, német, spanyol, portugál, olasz, kínai, japán, koreai, arab, hindi és kazah szerepel. A célnyelven készítsd elő a szöveget; a szintézis megszólaltatja azt, nem lefordítja. Tananyagnál a meghatározások és szakaszátmenetek legyenek világosak. Magyarázó hangrészlethez készítsd elő a pontos üzenetet és minden nevet, amelynek el kell hangoznia. A hang angolra optimalizáltsága továbbra is számít egy adott nyelv és szókincs hangzásának értékelésekor.
Egy gyakorlati HD-munkafolyamat meghallgatható, ellenőrizhető, majd a kész anyagba helyezhető hangrészletet hoz létre. Ellenőrizd, hogy minden mondat megszólalt-e, a nevek és mennyiségek elfogadhatóan hangzottak-e el, és a kiválasztott tempó segíti-e a megértést. Az írott szöveget a hang mellett őrizd meg, hogy a javítás visszavezethető legyen a megfelelő részletre. Az OpenAI megköveteli annak világos közlését, hogy a generált hang mesterséges. A HD a minőségközpontú TTS-családot írja le; önmagában nem ígér pontos időzítést, egyéni beszélőazonosságot vagy másik modell kifejező vezérlőit.
Ailoot Ultra · Felolvasás POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdKezdő lépések
A TTS-1 HD írott szöveget alakít jobb minőségű beszédhanggá választható előre beállított hangokkal, sebességgel és hat kimeneti formátummal. Az OpenAI a HD-nél a narráció minőségére helyezi a hangsúlyt a TTS-1 kisebb késleltetésű működésével szemben, így kész felolvasásokhoz, tananyagokhoz és szerkesztett hangrészletekhez hasznos.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Hang
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Felolvasás POST /v1/audio/speech
- Bemenet
text- Kimenet
audio- Kimeneti formátum
- mp3
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/tts-1-hd | Alapértelmezett— |
Mezőinput | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 Maximális hossz: 4096 Egység: Unicode-karakterek | Alapértelmezett— |
Mezővoice | Típusstring | KövetelményKötelező | Értékek és korlátok alloy | Alapértelmezett— |
Bemeneti anyagok kombinációi
text_to_speech · Kötelező: input
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, input, voice |
Paramétervoice_ids | Szerződésalloy |
Paramétermax_input_characters | Szerződés4096 |
Paraméterother_options | Szerződésfalse |
Paraméterinput | Szerződéspontos UTF-8 szöveg; Unicode-karakterszám normalizálás nélkül |
Paramétermaterial_types | Szerződéstext |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
E modell profiljából válassza ki a pontos hangot.
A bemeneti karakterek és a hangmásodpercek külön mérési egységek.
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Számlázható mennyiség | Elszámolási mennyiség | Elszámolási egység | Díj |
|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Számlázható mennyiség— | Elszámolási mennyiség— | Elszámolási egység— | Díj Bemenet · Bemeneti tokenek — / 1K token Kimenet · Kimeneti tokenek — / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításUltra | Díjtáblázat— | Számlázható mennyiségMinden Unicode-kódpont egy karakternek számít, a Han-karaktereket is beleértve. | Elszámolási mennyiség— | Elszámolási egység1K bemeneti karakterenként | Díj Bemenet · bemeneti karakter $0.06 1K bemeneti karakterenként |
| BeállításKérésenként | Díjtáblázat— | Számlázható mennyiség— | Elszámolási mennyiségegy kérés | Elszámolási egység— | Díj Bemenet $0 kérésenként |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Felolvasás
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
Eredmények fogadása és mentése
Ailoot Ultra · Felolvasás
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
További tartalomlekérések
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
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg a teljes bináris eredményt és a fejléceket. JSON vagy több kimenet esetén őrizzen meg minden adatelemet, és töltse le minden ténylegesen visszaadott, aláírt média-URL tartalmát.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti operation_id/X-Client-Request-ID értéket az egyeztetéshez, újbóli beküldés nélkül; nincs külön hangállapot-lekérdezési útvonal.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőbinary audio | Típusbytes |
Mezőresponse headers | Típusheaders |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot Ultra openai/tts-1-hd
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · tts-1-hd
- Milyen bemenetek és eredmények érhetők el?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- Mely mezőket használja a kérés?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- Milyen korlátok érvényesek?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096