AssemblyAI: Universal-3.5 Pro
A Universal-3.5 Pro az AssemblyAI beszédfelismerő modellje, amely egy rövid hangklipből egyetlen válaszban kész átiratot hoz létre. Sync profilja szavankénti megbízhatóságot, opcionális szóidőbélyegeket, szókincstippeket és korábbi beszélgetési kontextust ad a hangbemeneti és push-to-talk munkafolyamatokhoz.
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 Universal-3.5 Pro az AssemblyAI beszédfelismerő modellje rögzített beszéd szöveggé alakításához. Sync profiljában egy rövid hangklip egyetlen válaszban kész átiratot eredményez. Hangüzenetekhez, push-to-talk bemenethez és különálló beszélgetési fordulókhoz illik, amikor az alkalmazás már tudja, mikor kell véget érnie a felvételnek.
A hangot lehatárolt klipként készítse elő. Az AssemblyAI Sync követelményei 80 milliszekundum és 120 másodperc közötti időtartamot fogadnak, legfeljebb 40 MB fájlmérettel. A támogatott formátumok WAV vagy nyers, előjeles, 16 bites little-endian PCM. A hang monó vagy sztereó lehet; a sztereót belsőleg lekeveri. A támogatott mintavételi frekvenciák 8, 16, 22,05, 24, 32, 44,1 és 48 kHz. A WAV-fejléc megadja a mintavételi frekvenciát és a csatornaszámot; nyers PCM esetén ezeket az átírási konfigurációban külön kell megadni.
Rögzítse a teljes megszólalást, és a beszéd eleje és vége maradjon sértetlen. Hasznos önálló feladat lehet egy rövid terméktámogatási hangüzenet, amely terméknevet, rendelésazonosítót és kérést tartalmaz. Őrizze meg a forrásklipet, hogy az átirat e fontos részletek alapján ellenőrizhető legyen. Hosszabb felvételhez hosszú hanganyagok átírására alkalmas munkafolyamatot készítsen elő, ne kezelje a rövid klip időtartamkorlátját a modell teljes hangkapacitására vonatkozó állításként.
Az eredmény tartalmazza a teljes átiratot, szavankénti megbízhatóságot tartalmazó szólistát és nulla és egy közötti összesített megbízhatóságot. A beküldött hang időtartamát és kérésazonosítót is ad, így a szöveg az eredeti kliphez kapcsolva tartható. A szavankénti megbízhatósággal keresse meg a visszahallgatásos ellenőrzést igénylő részleteket, különösen az alkalmazás szempontjából fontos neveket, számokat és szakterületi szókincset.
A szóidőbélyegek opcionálisak és alapértelmezésben ki vannak kapcsolva. Kérésük esetén minden illesztett szóhoz tartozhat kezdő és záró idő milliszekundumban, a klip elejéhez viszonyítva. A gyártó profilja hiányzóként hagyja ezeket az értékeket, ha egy szó nem illeszthető, nem talál ki hozzá megközelítő időzítést. Az időbélyeg-pontosság angol hangnál a legjobb. Szókiemelés, kereshető hullámforma vagy feliratillesztés előkészítésekor őrizze meg explicit módon a hiányzó időzítéseket, és a kész feliratsávként történő használat előtt vesse össze a szöveget a felvétellel.
A kontextusprompt leírja, miről szól a felvétel. Megnevezhet szakterületet, helyzetet vagy az alkalmazás által már ismert konkrét részleteket, maximális hossza 6000 karakter. Rövid, a hanghoz illő leírással kezdjen, például egy adott eszközről szóló műszaki támogatási beszélgetéssel. A prompt felismerési kontextust ad; nem arra kéri a modellt, hogy a beszélő üzenetét másféle dokumentummá írja át.
A külön kulcskifejezés-lista meghatározott szókincs felé tereli a felismerést. A Sync profil legfeljebb 100 kifejezést és a teljes listában 8000 karaktert fogad el. Szokatlan nevekhez, betűszavakhoz vagy termékkifejezésekhez pontos írásmódot használjon, a hétköznapi, jól felismert szavakat pedig hagyja ki. A nagy vagy szükségtelen kifejezéslisták túlzott javításokat okozhatnak, ezért a listát a felvételben fontos szavakra összpontosítsa. A kontextusleírás és a szókincslista együtt is használható.
A korábbi beszélgetés egy rövid válasz értelmezését is segítheti. A korábbi megszólalásokat időrendi sorrendben, a legrégebbitől a legújabbig adja meg, miközben az aktuális hang marad az átírandó forduló. A dokumentált kontextuskeret 500 forduló vagy összesen 16 000 karakter. Ha ezt a korlátot vagy a rendelkezésre álló modellkontextust meghaladja, először a legrégebbi bejegyzéseket távolítja el. Ez akkor hasznos, ha egy rövid válasz olyan azonosítót vagy utalást tartalmaz, amelynek jelentése az előző kérdésből származik.
A nyelvválasztás egy vagy több várt nyelv felé tereli a felismerést. A jelenlegi Sync felület 32 nyelvkódot fogad el, választás hiányában pedig angolt használ. Nyelvek között váltó hang esetén sorolja fel a várt nyelveket. Az egyéni kontextusprompt lecseréli a rendszer által kezelt alapértelmezést, és felülírja a külön nyelvkódos irányítást, ezért a várt nyelveket ebben a promptban nevezze meg, ha nyelvi és helyzeti kontextusra is szükség van. Az átirat maradjon a ténylegesen beszélt nyelveken, az átírást ne kezelje fordítási utasításként.
A modell más AssemblyAI átírási munkafolyamatokban is megjelenik, míg a Sync profil rövidklip-követelményei és eredménymezői ehhez a konkrét felülethez tartoznak. A gyártó Dictation munkafolyamata külön szövegtisztítási lépést ad hozzá; az átirat és az újraírt üzenet eltérő eredmények. Őrizze meg a felismert beszédet, ha későbbi szerkesztési vagy összefoglalási lépés tisztított változatot hoz létre, hogy az eredeti megfogalmazás továbbra is rendelkezésre álljon az összehasonlításhoz.
Hasznos eredmény lehet átírt hangüzenet, asszisztenshez elkészült forduló, rövid kereshető hangszöveg vagy ellenőrző felülethez készült időzített szólista. A döntő szavakat ellenőrizze a felvétel alapján, őrizze meg a hiányzó illesztéseket, és a klipet tartsa a visszaadott szöveghez kapcsolva. A felismerési eredmény forrással alátámasztott átiratot ad az alkalmazás következő lépésének; a kérés megválaszolása vagy az üzenet szerkesztése a környező munkafolyamat feladata.
Ailoot Ultra · Hang átírása POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proKezdő lépések
A Universal-3.5 Pro az AssemblyAI beszédfelismerő modellje, amely egy rövid hangklipből egyetlen válaszban kész átiratot hoz létre. Sync profilja szavankénti megbízhatóságot, opcionális szóidőbélyegeket, szókincstippeket és korábbi beszélgetési kontextust ad a hangbemeneti és push-to-talk munkafolyamatokhoz.
- Elfogadott bemenetek
- Hang
- Eredmények
- Szöveg
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Hang átírása POST /v1/audio/transcriptions
- Bemenet
audio- Kimenet
text
| 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 assemblyai/universal-3-5-pro | Alapértelmezett— |
Mezőinput_audio | Típusobject | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, input_audio |
Paramétermaterial_types | Szerződésaudio |
Paramétermaterial_conditions | SzerződésA példa beolvassa az Ön tényleges, nem üres PCM WAV-fájlját, a fájl teljes bájttartalmát base64 formában kódolja, és az input_audio.format mezőt wav értékkel küldi el. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · pontos task_id egy meglévő, Önhöz tartozó médiarekordból
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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 | Elszámolási egység | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | 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ásbemeneti hangmásodperc | Díjtáblázat— | Elszámolási egységbemeneti hangmásodpercenként | Díj Bemenet · bemeneti hangmásodperc $0.00025 bemeneti hangmásodpercenké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 · Hang átírása
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import base64, io, json, os, wave
from pathlib import Path
audio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes()
if not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'):
raise SystemExit('Supply your actual PCM WAV audio file')
with wave.open(io.BytesIO(audio), 'rb') as recording:
if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0:
raise SystemExit('Supply a nonempty PCM WAV recording')
request = {'model': 'assemblyai/universal-3-5-pro', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}}
Path('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete original response, headers and actual X-Client-Request-ID.
# Read existing owned records for recovery; do not resubmit an uncertain operation.
Eredmények fogadása és mentése
Ailoot Ultra · Hang átírása
A teljes eredeti választörzs, állapot és továbbított fejlécek. Ez a kezelő nem ad hozzá univerzális JSON-szerkezetet, szövegmezőt vagy feladatburkolót.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a tényleges X-Client-Request-ID értéket és a teljes választ. Kérdezze le az eredeti saját médiaállományokat és pontos aláírt tartalom-URL-címeiket; bizonytalan kimenetelű létrehozást soha ne küldjön be újra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőtext (when present) | Típus |
Mezőusage (when present) | Típus |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételA JSON-törzs vagy a kifejezetten megadott kanonikus modellazonosító érvénytelen. | Következő lépésŐrizze meg a választ, és javítsa a kérés megjelölt mezőjét. |
Válasz401 · authentication_error | FeltételAz Ailoot API-kulcs érvénytelen. | Következő lépésHasználja az engedélyezett Ailoot API-kulcsát. |
Válasz403 · permission_error | FeltételA kulcscsoport nem használhatja ezt a metódust. | Következő lépésŐrizze meg a visszaadott hiba részleteit. |
Válasz404 · not_found_error | FeltételA kiválasztott metódushoz nincs engedélyezett útvonal. | Következő lépésŐrizze meg a visszaadott hiba részleteit. |
Válasz422 · price_unavailable | FeltételAz elfogadott tarifa nem tudja meghatározni a szükséges bemeneti mennyiséget vagy korlátot. | Következő lépésŐrizze meg a választ; használja az elfogadott tarifa által megkövetelt bemeneti formátumot. |
Válasz503 · | FeltételA szükséges tároló, útvonal, metódusár vagy összegzárolás nem érhető el. | Következő lépésŐrizze meg a teljes eredeti választ. A bizonytalan összegzárolás nem jogosít fel az újraküldésre. |
Válasz502 · server_error | FeltételAz eredeti eredményt, a felhasználást vagy az elszámolást ellenőrizni kell. | Következő lépésŐrizze meg a tényleges kérésazonosítót és az eredeti választ. A meglévő saját rekordot kérdezze le; ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot Ultra assemblyai/universal-3-5-pro
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · AssemblyAI: Universal-3.5 Pro
- Milyen bemenetek és eredmények érhetők el?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Mely mezőket használja a kérés?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio