AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro er AssemblyAI’s tale-til-tekst-model til at omdanne et kort lydklip til en færdig transskription i ét svar. Sync-profilen tilføjer ordkonfidens, valgfrie ordtidsstempler, ordforrådshints og kontekst fra tidligere samtale til stemmeinput og push-to-talk-forløb.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Universal-3.5 Pro er AssemblyAI’s talegenkendelsesmodel til at konvertere optaget tale til tekst. I Sync-profilen producerer et kort lydklip en færdig transskription i ét svar. Det passer til talebeskeder, push-to-talk-input og særskilte samtaleture, hvor applikationen allerede ved, hvornår optagelsen skal slutte.
Forbered lyden som et afgrænset klip. AssemblyAI’s Sync-krav accepterer varigheder fra 80 millisekunder til 120 sekunder med en maksimal filstørrelse på 40 MB. De understøttede formater er WAV eller rå 16-bit PCM med fortegn i little-endian-format. Lyd kan være mono eller stereo, hvor stereo internt nedmikses. Understøttede samplingfrekvenser er 8, 16, 22,05, 24, 32, 44,1 og 48 kHz. En WAV-header angiver samplingfrekvens og antal kanaler; rå PCM kræver, at disse værdier angives separat i transskriptionskonfigurationen.
Optag hele ytringen, og bevar begyndelsen og slutningen af talen intakt. En nyttig selvstændig opgave er en kort talebesked til produktsupport med et produktnavn, en ordreidentifikator og en anmodning. Gem kildeklippet, så transskriptionen kan kontrolleres mod disse vigtige detaljer. Til en længere optagelse skal du forberede et forløb egnet til længere transskription frem for at behandle varighedsgrænsen for korte klip som en påstand om modellens samlede lydkapacitet.
Resultatet indeholder den fulde transskription, en ordliste med konfidens pr. ord og en samlet konfidens mellem nul og én. Det angiver også den indsendte lydvarighed og en anmodningsidentifikator, så teksten kan holdes knyttet til sit oprindelige klip. Brug ordkonfidens til at lokalisere passager, der fortjener gennemlytning, især navne, tal og fagord, der betyder noget for applikationen.
Ordtidsstempler er valgfrie og slået fra som standard. Når der anmodes om dem, kan hvert tidsjusteret ord have start og slut i millisekunder i forhold til klippets begyndelse. Producentens profil udelader disse værdier, når et ord ikke kan tidsjusteres, frem for at opfinde en omtrentlig timing. Tidsstemplernes nøjagtighed er bedst til engelsk lyd. Bevar manglende tidspunkter eksplicit, når du forbereder ordmarkering, en søgbar bølgeform eller undertekstjustering, og sammenlign teksten med optagelsen, før den bruges som et færdigt undertekstspor.
En kontekstprompt beskriver, hvad optagelsen handler om. Den kan angive et fagområde, et scenarie eller bestemte detaljer, som applikationen allerede kender, og dens maksimale længde er 6000 tegn. Begynd med en kort beskrivelse, der passer til lyden, såsom en teknisk supportsamtale om en bestemt enhed. Prompten leverer genkendelseskontekst; den er ikke en anmodning om at omskrive talerens besked til et andet dokument.
En separat keyterm-liste styrer genkendelsen mod bestemt ordforråd. Sync-profilen accepterer op til 100 termer og 8000 tegn på tværs af listen. Brug nøjagtig stavning til usædvanlige navne, akronymer eller produkttermer, og udelad almindelige, velgenkendte ord. Store eller unødvendige termlister kan give overkorrektioner, så fokusér listen på ord, der betyder noget i optagelsen. Kontekstbeskrivelsen og ordforrådslisten kan bruges sammen.
Tidligere samtale kan også hjælpe med at fortolke et kort svar. Vedlæg tidligere ytringer i kronologisk rækkefølge fra ældst til nyest, mens den aktuelle lyd forbliver turen, der transskriberes. Den dokumenterede kontekstramme er 500 ture eller 16.000 tegn i alt. Hvis den overskrider disse lofter eller den tilgængelige modelkontekst, fjernes de ældste poster først. Det er nyttigt, når et kort svar indeholder en identifikator eller en henvisning, hvis betydning kommer fra det foregående spørgsmål.
Sprogvalg styrer genkendelsen mod ét eller flere forventede sprog. Den aktuelle Sync-grænseflade accepterer 32 sprogkoder og bruger engelsk som standard, når intet valg angives. Til lyd med sprogskift skal du angive de forventede sprog. En brugerdefineret kontekstprompt erstatter den administrerede standard og tilsidesætter den separate styring med sprogkoder, så angiv de forventede sprog inde i prompten, når både sprog- og scenariekontekst behøves. Bevar transskriptionen på de sprog, der faktisk tales, frem for at behandle transskription som en oversættelsesinstruktion.
Modellen optræder også i andre AssemblyAI-transskriptionsforløb, mens Sync-profilens krav til korte klip og resultatfelter tilhører netop denne grænseflade. Producentens Dictation-forløb tilføjer et separat trin til tekstoprydning; en transskription og en omskrevet besked er forskellige slutprodukter. Bevar den genkendte tale, hvis et senere redigerings- eller opsummeringstrin producerer en renset version, så den oprindelige ordlyd fortsat er tilgængelig til sammenligning.
Nyttige leverancer omfatter en transskriberet talebesked, en færdig tur til en assistent, kort søgbar lydtekst eller en tidsangivet ordliste til en gennemgangsgrænseflade. Kontrollér de afgørende ord mod optagelsen, bevar eventuelle manglende tidsjusteringer, og hold klippet knyttet til den returnerede tekst. Genkendelsesresultatet giver næste applikationstrin en kildeunderbygget transskription; besvarelse af anmodningen eller redigering af beskeden tilhører det omgivende forløb.
Ailoot Ultra · Transskription POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proStart
Universal-3.5 Pro er AssemblyAI’s tale-til-tekst-model til at omdanne et kort lydklip til en færdig transskription i ét svar. Sync-profilen tilføjer ordkonfidens, valgfrie ordtidsstempler, ordforrådshints og kontekst fra tidligere samtale til stemmeinput og push-to-talk-forløb.
- Accepterede input
- Lyd
- Resultater
- Tekst
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Transskription POST /v1/audio/transcriptions
- Inputtyper
audio- Outputtyper
text
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser assemblyai/universal-3-5-pro | Standard— |
Feltinput_audio | Typeobject | KravPåkrævet | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, input_audio |
Parametermaterial_types | Kontraktaudio |
Parametermaterial_conditions | KontraktEksemplet læser din faktiske, ikke-tomme PCM WAV-fil, koder samtlige bytes i filen som base64 og sender input_audio.format som wav. |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · præcist task_id fra en eksisterende mediepost, du ejer
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Ailoot-takster
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Afregningsenhed | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Afregningsenhed— | Beløb Input · Inputtokens — / 1K tokens Output · Outputtokens — / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
| Konfigurationsekund inputlyd | Takstplan— | Afregningsenhedpr. sekund lydinput | Beløb Input · sekund inputlyd $0.00025 pr. sekund lydinput |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Transskription
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.
Hent og gem resultater
Ailoot Ultra · Transskription
Hele det oprindelige svarindhold, status og videresendte headere. Denne handler tilføjer hverken en universel JSON-struktur, et tekstfelt eller en opgaveindpakning.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle færdige resultater
Gem hvert fuldstændigt returneret svar, hver fil og hver indholdsdel.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Behold det faktiske X-Client-Request-ID og hele svaret. Læs de oprindelige aktiver, du ejer, og deres præcise signerede indholds-URL’er; indsend aldrig en oprettelse med usikkert udfald igen.
Svarfelter
| Felt | Type |
|---|---|
Felttext (when present) | Type |
Feltusage (when present) | Type |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseJSON-indholdet eller det eksplicitte kanoniske model-ID er ugyldigt. | Næste trinBehold svaret, og ret det angivne forespørgselsfelt. |
Svar401 · authentication_error | BetingelseAiloot API-nøglen er ugyldig. | Næste trinBrug din autoriserede Ailoot API-nøgle. |
Svar403 · permission_error | BetingelseNøglens gruppe giver ikke adgang til denne metode. | Næste trinBehold de returnerede fejloplysninger. |
Svar404 · not_found_error | BetingelseDen valgte metode har ingen rute med adgangstilladelse. | Næste trinBehold de returnerede fejloplysninger. |
Svar422 · price_unavailable | BetingelseDen accepterede tarif kan ikke hente den påkrævede inputmængde eller grænse. | Næste trinBehold svaret; brug den inputrepræsentation, som den accepterede tarif kræver. |
Svar503 · | BetingelsePåkrævet lager, rute, metodepris eller reservation er utilgængelig. | Næste trinBehold hele det oprindelige svar. En usikker reservation giver ikke tilladelse til at indsende igen. |
Svar502 · server_error | BetingelseDet oprindelige resultat, forbrug eller den oprindelige afregning skal kontrolleres. | Næste trinBehold det faktiske forespørgsels-ID og det oprindelige svar. Læs den eksisterende post, du ejer; indsend ikke oprettelsen igen. |
Aliaser
Modelaliaser
Ailoot Ultra assemblyai/universal-3-5-pro
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · AssemblyAI: Universal-3.5 Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Hvilke felter bruger anmodningen?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio