AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro is het spraak-naar-tekstmodel van AssemblyAI dat een korte audioclip in één antwoord omzet in een volledig transcript. Het Sync-profiel voegt woordbetrouwbaarheid, optionele woordtijdstempels, woordenschathints en context uit eerdere gesprekken toe voor spraakinvoer en push-to-talk-workflows.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Universal-3.5 Pro is het spraakherkenningsmodel van AssemblyAI voor het omzetten van opgenomen spraak in tekst. In het Sync-profiel levert een korte audioclip in één antwoord een volledig transcript op. Dit is geschikt voor spraakberichten, push-to-talk-invoer en afzonderlijke gespreksbeurten waarbij de toepassing al weet wanneer de opname moet eindigen.
Bereid de audio als een afgebakende clip voor. De Sync-vereisten van AssemblyAI aanvaarden een duur van 80 milliseconden tot 120 seconden, met een maximale bestandsgrootte van 40 MB. De ondersteunde formaten zijn WAV of ruwe signed 16-bit little-endian PCM. Audio kan mono of stereo zijn, waarbij stereo intern wordt teruggemengd. Ondersteunde samplefrequenties zijn 8, 16, 22,05, 24, 32, 44,1 en 48 kHz. Een WAV-header levert de samplefrequentie en het aantal kanalen; bij ruwe PCM moeten die waarden afzonderlijk in de transcriptieconfiguratie worden opgegeven.
Neem de volledige uiting op en houd het begin en einde van de spraak intact. Een bruikbare eigen taak is een kort spraakbericht voor productondersteuning met een productnaam, een bestel-ID en een verzoek. Bewaar de bronclip, zodat het transcript aan die belangrijke details kan worden getoetst. Bereid voor een langere opname een workflow voor die geschikt is voor lange transcriptie, in plaats van de duurlimiet voor korte clips als een modelbrede claim over audiocapaciteit te beschouwen.
Het resultaat bevat het volledige transcript, een woordenlijst met betrouwbaarheid per woord en een algemene betrouwbaarheid tussen nul en één. Het geeft ook de duur van de ingediende audio en een verzoek-ID, waardoor de tekst met de oorspronkelijke clip verbonden kan blijven. Gebruik woordbetrouwbaarheid om passages te vinden die een luistercontrole verdienen, vooral namen, cijfers en domeinwoordenschat die voor de toepassing van belang zijn.
Woordtijdstempels zijn optioneel en standaard uitgeschakeld. Wanneer ze worden gevraagd, kan elk uitgelijnd woord zijn begin en einde in milliseconden ten opzichte van het begin van de clip bevatten. Het profiel van de fabrikant laat die waarden weg wanneer een woord niet kan worden uitgelijnd, in plaats van een geschatte timing te verzinnen. Tijdstempels zijn het nauwkeurigst voor Engelstalige audio. Behoud ontbrekende timings expliciet bij het voorbereiden van woordmarkering, een doorzoekbare golfvorm of ondertiteluitlijning en vergelijk de tekst met de opname voordat je die als een afgewerkt ondertitelspoor gebruikt.
Een contextuele prompt beschrijft waarover de opname gaat. Die kan een domein, scenario of specifieke details benoemen die de toepassing al kent en heeft een maximale lengte van 6.000 tekens. Begin met een korte beschrijving die bij de audio past, zoals een technisch ondersteuningsgesprek over een bepaald toestel. De prompt levert herkenningscontext; het is geen verzoek om de boodschap van de spreker naar een ander document te herschrijven.
Een afzonderlijke lijst met sleuteltermen stuurt de herkenning naar specifieke woordenschat. Het Sync-profiel aanvaardt maximaal 100 termen en 8.000 tekens voor die volledige lijst. Gebruik exacte spellingen voor ongebruikelijke namen, afkortingen of producttermen en laat gewone, goed herkende woorden uit de lijst. Grote of overbodige termenlijsten kunnen overcorrecties veroorzaken. Richt de lijst dus op woorden die in de opname van belang zijn. De contextbeschrijving en woordenlijst kunnen samen worden gebruikt.
Eerder gesprek kan ook helpen om een kort antwoord te interpreteren. Lever eerdere uitingen in chronologische volgorde aan, van oud naar nieuw, terwijl de huidige audio de te transcriberen beurt blijft. Het gedocumenteerde contextbudget is 500 beurten of in totaal 16.000 tekens. Als het die grenzen of de beschikbare modelcontext overschrijdt, worden de oudste vermeldingen eerst verwijderd. Dit is nuttig wanneer een kort antwoord een identificatie of verwijzing bevat waarvan de betekenis uit de voorafgaande vraag komt.
Taalkeuze stuurt de herkenning naar één of meerdere verwachte talen. De huidige Sync-interface aanvaardt 32 taalcodes en gebruikt standaard Engels als geen keuze is opgegeven. Som voor audio met taalwisselingen de verwachte talen op. Een eigen contextuele prompt vervangt de beheerde standaard en krijgt voorrang op de afzonderlijke sturing via taalcodes. Benoem de verwachte talen dus in die prompt wanneer zowel taal- als scenariocontext nodig is. Behoud het transcript in de werkelijk gesproken talen, in plaats van transcriptie als een vertaalinstructie te behandelen.
Het model komt ook voor in andere transcriptieworkflows van AssemblyAI, terwijl de vereisten voor korte clips en resultaatvelden van het Sync-profiel bij deze specifieke interface horen. De Dictation-workflow van de fabrikant voegt een afzonderlijke tekstopschoningsstap toe; een transcript en een herschreven bericht zijn verschillende resultaten. Behoud de herkende spraak wanneer een latere bewerkings- of samenvattingsstap een opgeschoonde versie produceert, zodat de oorspronkelijke bewoordingen voor vergelijking beschikbaar blijven.
Bruikbare opleveringen omvatten een getranscribeerd spraakbericht, een volledige beurt voor een assistent, korte doorzoekbare audiotekst of een getimede woordenlijst voor een beoordelingsinterface. Controleer de doorslaggevende woorden aan de hand van de opname, behoud ontbrekende uitlijningen en houd de clip verbonden met de teruggestuurde tekst. Het herkenningsresultaat geeft de volgende toepassingsstap een op de bron gebaseerde transcriptie; het verzoek beantwoorden of het bericht bewerken behoort tot de omringende workflow.
Ailoot Ultra · Transcriptie POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proAan de slag
Universal-3.5 Pro is het spraak-naar-tekstmodel van AssemblyAI dat een korte audioclip in één antwoord omzet in een volledig transcript. Het Sync-profiel voegt woordbetrouwbaarheid, optionele woordtijdstempels, woordenschathints en context uit eerdere gesprekken toe voor spraakinvoer en push-to-talk-workflows.
- Toegestane invoer
- Audio
- Resultaten
- Tekst
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Transcriptie POST /v1/audio/transcriptions
- Invoer
audio- Uitvoer
text
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten assemblyai/universal-3-5-pro | Standaard— |
Veldinput_audio | Typeobject | VereisteVereist | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input_audio |
Parametermaterial_types | Contractaudio |
Parametermaterial_conditions | ContractHet voorbeeld leest je werkelijke, niet-lege PCM WAV-bestand, codeert alle bytes van het bestand als base64 en verstuurt input_audio.format als wav. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · exacte task_id uit een bestaande mediaregistratie die je toebehoort
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Rekeneenheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Rekeneenheid— | Kosten Invoer · Invoertokens — / 1K tokens Uitvoer · Uitvoertokens — / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| Configuratieseconde audio-invoer | Tariefstaffel— | Rekeneenheidper seconde audio-invoer | Kosten Invoer · seconde audio-invoer $0.00025 per seconde audio-invoer |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Transcriptie
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.
Resultaten ophalen en opslaan
Ailoot Ultra · Transcriptie
Volledige oorspronkelijke antwoordinhoud, status en doorgestuurde headers. Deze handler voegt geen universele JSON-structuur, tekstveld of taakomhulling toe.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de werkelijke X-Client-Request-ID en het volledige antwoord. Raadpleeg de oorspronkelijke assets die je toebehoren en hun exacte ondertekende inhouds-URL's; dien een aanmaakaanvraag met onzekere uitkomst nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldtext (when present) | Type |
Veldusage (when present) | Type |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeDe JSON-inhoud of de expliciete canonieke model-ID is ongeldig. | Volgende stapBewaar het antwoord en corrigeer het aangegeven aanvraagveld. |
Antwoord401 · authentication_error | VoorwaardeDe Ailoot API-sleutel is ongeldig. | Volgende stapGebruik je geautoriseerde Ailoot API-sleutel. |
Antwoord403 · permission_error | VoorwaardeDe groep van de sleutel heeft geen toegang tot deze methode. | Volgende stapBewaar de teruggestuurde foutdetails. |
Antwoord404 · not_found_error | VoorwaardeDe geselecteerde methode heeft geen toegelaten route. | Volgende stapBewaar de teruggestuurde foutdetails. |
Antwoord422 · price_unavailable | VoorwaardeVoor het geaccepteerde tarief kan de vereiste invoerhoeveelheid of grenswaarde niet worden bepaald. | Volgende stapBewaar het antwoord; gebruik de invoerweergave die het geaccepteerde tarief vereist. |
Antwoord503 · | VoorwaardeDe vereiste opslag, route, methodeprijs of reservering is niet beschikbaar. | Volgende stapBewaar het volledige oorspronkelijke antwoord. Een onzekere reservering geeft geen toestemming om opnieuw in te dienen. |
Antwoord502 · server_error | VoorwaardeHet oorspronkelijke resultaat, het verbruik of de afrekening moet worden gecontroleerd. | Volgende stapBewaar de werkelijke aanvraag-ID en het oorspronkelijke antwoord. Raadpleeg de bestaande registratie die je toebehoort; dien de aanmaakaanvraag niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra assemblyai/universal-3-5-pro
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · AssemblyAI: Universal-3.5 Pro
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Welke velden gebruikt het verzoek?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio