AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro är AssemblyAI:s tal-till-text-modell för att omvandla ett kort ljudklipp till en färdig transkription i ett svar. Dess Sync-profil lägger till ordkonfidens, valfria tidsstämplar för ord, ordförrådshjälp och sammanhang från tidigare konversation för röstindata och push-to-talk-flöden.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Universal-3.5 Pro är AssemblyAI:s taligenkänningsmodell för att omvandla inspelat tal till text. I Sync-profilen ger ett kort ljudklipp en färdig transkription i ett svar. Detta passar röstmeddelanden, push-to-talk-indata och avgränsade samtalsturer där applikationen redan vet när inspelningen ska sluta.
Förbered ljudet som ett avgränsat klipp. AssemblyAI:s Sync-krav accepterar längder från 80 millisekunder till 120 sekunder, med en maximal filstorlek på 40 MB. De stödda formaten är WAV eller rå PCM med 16-bitars heltal med tecken och little-endian-byteordning. Ljudet kan vara mono eller stereo, där stereo mixas ned internt. Stödda samplingsfrekvenser är 8, 16, 22,05, 24, 32, 44,1 och 48 kHz. En WAV-header tillhandahåller samplingsfrekvens och kanalantal; rå PCM behöver dessa värden separat i transkriptionskonfigurationen.
Spela in hela yttrandet och håll talets början och slut intakta. En användbar egen uppgift är ett kort röstmeddelande till produktsupport med ett produktnamn, en orderidentifierare och en begäran. Behåll källklippet så att transkriptionen kan kontrolleras mot dessa viktiga detaljer. För en längre inspelning förbereder du ett arbetsflöde lämpligt för långformatstranskription i stället för att behandla kortklippets längdgräns som ett påstående om modellens övergripande ljudkapacitet.
Resultatet innehåller hela transkriptionen, en ordlista med konfidens per ord och en övergripande konfidens mellan noll och ett. Det tillhandahåller också den inskickade ljudlängden och en identifierare för begäran, vilket gör det möjligt att hålla texten kopplad till dess ursprungliga klipp. Använd ordkonfidens för att lokalisera avsnitt som bör granskas genom lyssning, särskilt namn, siffror och domänordförråd som är viktiga för applikationen.
Tidsstämplar för ord är valfria och avstängda som standard. När de begärs kan varje tidsjusterat ord ha sin start och sitt slut i millisekunder relativt klippets början. Tillverkarens profil lämnar dessa värden frånvarande när ett ord inte kan tidsjusteras i stället för att hitta på en ungefärlig tid. Tidsstämpelprecisionen är bäst för engelskt ljud. Behåll saknade tider uttryckligen när du förbereder ordmarkering, en sökbar vågform eller undertextjustering och jämför texten med inspelningen innan du använder den som ett färdigt undertextspår.
En kontextprompt beskriver vad inspelningen handlar om. Den kan ange en domän, ett scenario eller specifika detaljer som applikationen redan känner till, och dess maximala längd är 6000 tecken. Börja med en kort beskrivning som passar ljudet, som ett tekniskt supportsamtal om en viss enhet. Prompten ger igenkänningssammanhang; den är inte en begäran att skriva om talarens meddelande till ett annat dokument.
En separat lista med nyckeltermer styr igenkänningen mot specifikt ordförråd. Sync-profilen tar emot upp till 100 termer och 8000 tecken över hela listan. Använd exakt stavning för ovanliga namn, akronymer eller produkttermer och lämna vanliga väl igenkända ord utanför listan. Stora eller onödiga termlistor kan orsaka överkorrigeringar, så fokusera listan på ord som är viktiga i inspelningen. Kontextbeskrivningen och ordförrådslistan kan användas tillsammans.
Tidigare konversation kan också hjälpa till att tolka ett kort svar. Tillhandahåll tidigare yttranden i kronologisk ordning, från äldst till nyast, medan det aktuella ljudet förblir den tur som transkriberas. Den dokumenterade kontexttilldelningen är 500 turer eller totalt 16 000 tecken. Om den överskrider dessa tak eller den tillgängliga modellkontexten tas de äldsta posterna bort först. Detta är användbart när ett kort svar innehåller en identifierare eller en hänvisning vars betydelse kommer från föregående fråga.
Språkval styr igenkänningen mot ett eller flera förväntade språk. Det aktuella Sync-gränssnittet tar emot 32 språkkoder och använder engelska som standard när inget val anges. För ljud med språkväxling listar du de förväntade språken. En egen kontextprompt ersätter den hanterade standarden och åsidosätter den separata styrningen med språkkoder, så ange de förväntade språken inne i prompten när både språk- och scenariosammanhang behövs. Håll transkriptionen på de språk som faktiskt talas i stället för att behandla transkription som en översättningsinstruktion.
Modellen förekommer också i andra transkriptionsflöden från AssemblyAI, medan Sync-profilens kortklippskrav och resultatfält hör till just detta gränssnitt. Tillverkarens Dictation-flöde lägger till ett separat steg för textrensning; en transkription och ett omskrivet meddelande är olika artefakter. Bevara det igenkända talet om ett senare redigerings- eller sammanfattningssteg producerar en rensad version, så att den ursprungliga formuleringen finns kvar för jämförelse.
Användbara leveranser omfattar ett transkriberat röstmeddelande, en färdig tur för en assistent, kort sökbar ljudtext eller en tidsatt ordlista för ett granskningsgränssnitt. Kontrollera de avgörande orden mot inspelningen, bevara eventuella saknade tidsjusteringar och håll klippet länkat till den returnerade texten. Igenkänningsresultatet ger nästa applikationssteg en källunderbyggd transkription; att besvara begäran eller redigera meddelandet hör till det omgivande arbetsflödet.
Ailoot Ultra · Transkribering POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proStart
Universal-3.5 Pro är AssemblyAI:s tal-till-text-modell för att omvandla ett kort ljudklipp till en färdig transkription i ett svar. Dess Sync-profil lägger till ordkonfidens, valfria tidsstämplar för ord, ordförrådshjälp och sammanhang från tidigare konversation för röstindata och push-to-talk-flöden.
- Godkända indata
- Ljud
- Resultat
- Text
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Transkribering POST /v1/audio/transcriptions
- Indatatyper
audio- Utdatatyper
text
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser assemblyai/universal-3-5-pro | Standard— |
Fältinput_audio | Typobject | KravObligatoriskt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, input_audio |
Parametermaterial_types | Avtalaudio |
Parametermaterial_conditions | AvtalExemplet läser din faktiska, icke-tomma PCM WAV-fil, kodar filens samtliga byte som base64 och skickar input_audio.format som wav. |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · exakt task_id från en befintlig mediepost som du äger
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Ailoot-priser
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Debiteringsenhet | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Debiteringsenhet— | Avgift Indata · Indatatoken — / 1K token Utdata · Utdatatoken — / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
| Konfigurationsekund inkommande ljud | Prislista— | Debiteringsenhetper sekund indataljud | Avgift Indata · sekund inkommande ljud $0.00025 per sekund indataljud |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Transkribering
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.
Ta emot och spara resultat
Ailoot Ultra · Transkribering
Hela den ursprungliga svarskroppen, statusen och vidarebefordrade svarshuvuden. Denna hanterare lägger inte till någon universell JSON-struktur, något textfält eller något uppgiftshölje.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Om det ursprungliga svaret behöver kontrolleras
Behåll faktiskt X-Client-Request-ID och hela svaret. Läs de ursprungliga tillgångarna som du äger och deras exakta signerade innehållslänkar; skicka aldrig en osäker skapandebegäran igen.
Svarsfält
| Fält | Typ |
|---|---|
Fälttext (when present) | Typ |
Fältusage (when present) | Typ |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorJSON-kroppen eller det uttryckliga kanoniska modell-ID:t är ogiltigt. | Nästa stegBehåll svaret och korrigera det angivna fältet i begäran. |
Svar401 · authentication_error | VillkorAPI-nyckeln för Ailoot är ogiltig. | Nästa stegAnvänd din behöriga API-nyckel för Ailoot. |
Svar403 · permission_error | VillkorNyckelgruppen ger inte tillträde till denna metod. | Nästa stegBehåll de returnerade feluppgifterna. |
Svar404 · not_found_error | VillkorDen valda metoden har ingen tillåten rutt. | Nästa stegBehåll de returnerade feluppgifterna. |
Svar422 · price_unavailable | VillkorDen accepterade tariffen kan inte fastställa den mängd eller gräns för indata som krävs. | Nästa stegBehåll svaret; använd den representation av indata som den accepterade tariffen kräver. |
Svar503 · | VillkorNödvändig lagring, rutt, metodpris eller reservation är inte tillgänglig. | Nästa stegBehåll hela det ursprungliga svaret. En osäker reservation ger inte tillstånd att skicka in igen. |
Svar502 · server_error | VillkorDet ursprungliga resultatet, förbrukningen eller avräkningen kräver kontroll. | Nästa stegBehåll det faktiska begärans-ID:t och det ursprungliga svaret. Läs den befintliga posten som du äger; skicka inte skapandebegäran igen. |
Alias
Modellalias
Ailoot Ultra assemblyai/universal-3-5-pro
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · AssemblyAI: Universal-3.5 Pro
- Vilka indata och resultat finns?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Vilka fält använder begäran?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio