AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro is het spraak-naar-tekstmodel van AssemblyAI om een korte audioclip in één antwoord om te zetten in een volledig transcript. Het Sync-profiel voegt woordbetrouwbaarheid, optionele woordtijdstempels, woordenschathints en eerdere gesprekscontext 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 om opgenomen spraak naar tekst om te zetten. In het Sync-profiel levert een korte audioclip in één antwoord een volledig transcript op. Dit past bij spraakberichten, push-to-talk-invoer en afzonderlijke gespreksbeurten waarbij de applicatie al weet wanneer de opname moet eindigen.
Bereid de audio voor als afgebakende clip. De Sync-eisen van AssemblyAI accepteren 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 naar mono wordt gemixt. Ondersteunde samplefrequenties zijn 8, 16, 22.05, 24, 32, 44.1 en 48 kHz. Een WAV-header levert de samplefrequentie en het aantal kanalen; voor ruwe PCM moeten die waarden apart in de transcriptieconfiguratie worden opgegeven.
Neem de volledige uiting op en houd het begin en einde van de spraak intact. Een bruikbare oorspronkelijke taak is een kort spraakbericht aan productsupport met een productnaam, orderidentificatie en verzoek. Bewaar de bronclip, zodat het transcript op die belangrijke details kan worden gecontroleerd. Bereid voor een langere opname een workflow voor lange transcripties voor, in plaats van de duurlimiet voor korte clips als een uitspraak over de audiocapaciteit van het hele model te behandelen.
Het resultaat bevat het volledige transcript, een woordenlijst met betrouwbaarheid per woord en een algemene betrouwbaarheid tussen nul en één. Het levert ook de duur van de ingestuurde audio en een verzoek-ID, waarmee je de tekst bij de oorspronkelijke clip kunt bewaren. Gebruik woordbetrouwbaarheid om passages te vinden die luistercontrole verdienen, vooral namen, getallen en domeinwoordenschat die voor de applicatie belangrijk zijn.
Woordtijdstempels zijn optioneel en staan standaard uit. Wanneer ze worden aangevraagd, kan elk uitgelijnd woord het begin en einde in milliseconden ten opzichte van het begin van de clip bevatten. Het profiel van de maker laat die waarden weg wanneer een woord niet kan worden uitgelijnd, in plaats van een geschatte timing te verzinnen. Tijdstempels zijn het nauwkeurigst bij Engelse audio. Behoud ontbrekende timings expliciet bij het voorbereiden van woordmarkering, een doorzoekbare golfvorm of ondertiteluitlijning en vergelijk de tekst met de opname voordat je deze als voltooid ondertitelspoor gebruikt.
Een contextprompt beschrijft waar de opname over gaat. Deze kan een domein, scenario of specifieke details noemen die de applicatie al kent en heeft een maximale lengte van 6000 tekens. Begin met een korte beschrijving die bij de audio past, zoals een technisch supportgesprek over een bepaald apparaat. De prompt levert herkenningscontext; het is geen verzoek om het bericht van de spreker te herschrijven tot een ander document.
Een afzonderlijke lijst met sleuteltermen stuurt de herkenning richting specifieke woordenschat. Het Sync-profiel accepteert maximaal 100 termen en in totaal 8000 tekens in die lijst. Gebruik exacte spellingen voor ongebruikelijke namen, afkortingen of producttermen en laat gewone, goed herkende woorden uit de lijst. Grote of onnodige termenlijsten kunnen overcorrecties veroorzaken. Richt de lijst daarom op woorden die in de opname belangrijk zijn. De contextbeschrijving en woordenlijst kunnen samen worden gebruikt.
Eerder gesprek kan ook helpen een kort antwoord te interpreteren. Lever eerdere uitingen aan in chronologische volgorde, van oud naar nieuw, terwijl de huidige audio de te transcriberen beurt blijft. De gedocumenteerde contextruimte bedraagt 500 beurten of in totaal 16,000 tekens. Als deze die limieten of de beschikbare modelcontext overschrijdt, worden de oudste items als eerste verwijderd. Dit is nuttig wanneer een kort antwoord een identificatie of verwijzing bevat waarvan de betekenis uit de voorafgaande vraag komt.
Taalselectie stuurt de herkenning naar één of meer verwachte talen. De huidige Sync-interface accepteert 32 taalcodes en gebruikt standaard Engels wanneer er geen selectie wordt aangeleverd. Geef bij audio met taalwisselingen de verwachte talen op. Een aangepaste contextprompt vervangt de beheerde standaard en gaat boven de afzonderlijke sturing met taalcodes. Benoem daarom de verwachte talen in die prompt wanneer zowel taal- als scenariocontext nodig zijn. Houd het transcript in de daadwerkelijk gesproken talen, in plaats van transcriptie als vertaalinstructie te behandelen.
Het model komt ook voor in andere transcriptieworkflows van AssemblyAI, terwijl de eisen voor korte clips en resultaatvelden van het Sync-profiel bij deze specifieke interface horen. De Dictation-workflow van de maker voegt een afzonderlijke fase voor tekstopmaak en opschoning toe; een transcript en een herschreven bericht zijn verschillende werkstukken. Bewaar de herkende spraak wanneer een latere bewerkings- of samenvattingsstap een opgeschoonde versie oplevert, zodat de oorspronkelijke formulering beschikbaar blijft voor vergelijking.
Bruikbare eindproducten zijn onder meer een getranscribeerd spraakbericht, een voltooide beurt voor een assistent, korte doorzoekbare audiotekst of een woordenlijst met timing voor een controle-interface. Controleer de doorslaggevende woorden aan de hand van de opname, behoud ontbrekende uitlijningen en houd de clip gekoppeld aan de teruggegeven tekst. Het herkenningsresultaat geeft de volgende applicatiestap een transcriptie die op een bron is gebaseerd; het verzoek beantwoorden of het bericht bewerken hoort bij 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 om een korte audioclip in één antwoord om te zetten in een volledig transcript. Het Sync-profiel voegt woordbetrouwbaarheid, optionele woordtijdstempels, woordenschathints en eerdere gesprekscontext 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
- Invoertypen
audio- Uitvoertypen
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 uw eigen niet-lege PCM WAV-bestand, codeert alle bestandsbytes 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 bestaand mediarecord dat u bezit
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 is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij 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 antwoordbody, status en doorgestuurde headers. Deze handler voegt geen universele JSON-structuur, tekstveld of taakenvelop 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 het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de daadwerkelijke X-Client-Request-ID en het volledige antwoord. Lees de oorspronkelijke assets die u bezit en hun exacte ondertekende inhouds-URLs; dien een onzekere aanmaak 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-body of expliciete canonieke model-ID is ongeldig. | Volgende stapBewaar het antwoord en corrigeer het aangegeven verzoekveld. |
Antwoord401 · authentication_error | VoorwaardeDe Ailoot API-sleutel is ongeldig. | Volgende stapGebruik uw geautoriseerde Ailoot API-sleutel. |
Antwoord403 · permission_error | VoorwaardeDe sleutelgroep laat deze methode niet toe. | Volgende stapBewaar de geretourneerde foutdetails. |
Antwoord404 · not_found_error | VoorwaardeDe geselecteerde methode heeft geen toegelaten route. | Volgende stapBewaar de geretourneerde foutdetails. |
Antwoord422 · price_unavailable | VoorwaardeHet geaccepteerde tarief kan de vereiste invoerhoeveelheid of bovengrens niet verkrijgen. | Volgende stapBewaar het antwoord; gebruik de invoerweergave die het geaccepteerde tarief vereist. |
Antwoord503 · | VoorwaardeVereiste 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, gebruik of de afrekening moet worden gecontroleerd. | Volgende stapBewaar de daadwerkelijke verzoek-ID en het oorspronkelijke antwoord. Lees het bestaande record dat u bezit; dien de aanmaak 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