AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro è il modello di riconoscimento vocale di AssemblyAI che trasforma una breve clip audio in una trascrizione completa in un'unica risposta. Il profilo Sync aggiunge attendibilità delle parole, timestamp facoltativi per parola, suggerimenti lessicali e contesto della conversazione precedente per input vocali e flussi push-to-talk.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Universal-3.5 Pro è il modello di riconoscimento vocale di AssemblyAI per convertire il parlato registrato in testo. Nel profilo Sync, una breve clip audio produce una trascrizione completa in un'unica risposta. È adatto a messaggi vocali, input push-to-talk e turni conversazionali distinti in cui l'applicazione sa già quando la registrazione deve terminare.
Prepara l'audio come una clip delimitata. I requisiti Sync di AssemblyAI accettano durate da 80 millisecondi a 120 secondi, con una dimensione massima del file di 40 MB. I formati supportati sono WAV o PCM grezzo con segno a 16 bit little-endian. L'audio può essere mono o stereo, con riduzione interna dello stereo a mono. Le frequenze di campionamento supportate sono 8, 16, 22,05, 24, 32, 44,1 e 48 kHz. Un'intestazione WAV fornisce la frequenza di campionamento e il numero di canali; per il PCM grezzo questi valori devono essere forniti separatamente nella configurazione di trascrizione.
Acquisisci l'enunciato completo e mantieni intatti l'inizio e la fine del parlato. Un compito originale utile è un breve messaggio vocale di assistenza su un prodotto, contenente il nome del prodotto, un identificatore d'ordine e una richiesta. Conserva la clip di origine, così da poter verificare la trascrizione rispetto a questi dettagli importanti. Per una registrazione più lunga, prepara un flusso adatto alla trascrizione estesa, anziché trattare il limite di durata delle clip brevi come un'affermazione sulla capacità audio complessiva del modello.
Il risultato contiene la trascrizione completa, un elenco di parole con attendibilità per ciascuna e un'attendibilità complessiva fra zero e uno. Fornisce anche la durata dell'audio inviato e un identificatore della richiesta, consentendo di mantenere il testo associato alla clip originale. Usa l'attendibilità per parola per individuare i passaggi che meritano una verifica all'ascolto, soprattutto nomi, numeri e lessico di settore importanti per l'applicazione.
I timestamp delle parole sono facoltativi e disattivati per impostazione predefinita. Quando richiesti, ogni parola allineata può riportare il proprio inizio e la propria fine in millisecondi rispetto all'inizio della clip. Il profilo del produttore lascia assenti questi valori quando una parola non può essere allineata, anziché inventare un tempo approssimativo. La precisione dei timestamp è migliore per l'audio in inglese. Mantieni espliciti i tempi mancanti quando prepari l'evidenziazione delle parole, una forma d'onda ricercabile o l'allineamento dei sottotitoli e confronta il testo con la registrazione prima di usarlo come traccia di sottotitoli finita.
Un prompt contestuale descrive l'argomento della registrazione. Può indicare un settore, uno scenario o dettagli specifici già noti all'applicazione e ha una lunghezza massima di 6000 caratteri. Parti da una descrizione breve adatta all'audio, come una conversazione di assistenza tecnica su un determinato dispositivo. Il prompt fornisce contesto al riconoscimento; non è una richiesta di riscrivere il messaggio di chi parla trasformandolo in un documento diverso.
Un elenco separato di termini chiave orienta il riconoscimento verso un lessico specifico. Il profilo Sync accetta fino a 100 termini e 8000 caratteri complessivi nell'elenco. Usa le grafie esatte per nomi insoliti, acronimi o termini di prodotto e lascia fuori dall'elenco le parole comuni ben riconosciute. Elenchi grandi o non necessari possono causare correzioni eccessive, quindi concentrati sulle parole importanti nella registrazione. La descrizione del contesto e l'elenco lessicale possono essere usati insieme.
Anche la conversazione precedente può aiutare a interpretare una risposta breve. Fornisci gli enunciati precedenti in ordine cronologico, dal più vecchio al più recente, mentre l'audio attuale rimane il turno da trascrivere. Il budget di contesto documentato è di 500 turni o 16.000 caratteri totali. Se supera questi limiti o il contesto disponibile del modello, le voci più vecchie vengono rimosse per prime. Questo è utile quando una breve risposta contiene un identificatore o un riferimento il cui significato deriva dalla domanda precedente.
La selezione della lingua orienta il riconoscimento verso una o più lingue previste. L'interfaccia Sync attuale accetta 32 codici lingua e usa l'inglese come valore predefinito quando non viene fornita una selezione. Per l'audio con passaggi fra lingue, elenca le lingue previste. Un prompt contestuale personalizzato sostituisce quello predefinito gestito e prevale sull'orientamento separato tramite codici lingua; indica quindi le lingue previste all'interno del prompt quando servono sia il contesto linguistico sia quello dello scenario. Mantieni la trascrizione nelle lingue effettivamente parlate, anziché trattare la trascrizione come un'istruzione di traduzione.
Il modello compare anche in altri flussi di trascrizione AssemblyAI, mentre i requisiti per clip brevi e i campi di risultato del profilo Sync appartengono a questa specifica interfaccia. Il flusso Dictation del produttore aggiunge una fase separata di pulizia del testo; una trascrizione e un messaggio riscritto sono elaborati diversi. Conserva il parlato riconosciuto se una fase successiva di revisione o sintesi produce una versione ripulita, così che la formulazione originale resti disponibile per il confronto.
I risultati utili comprendono un messaggio vocale trascritto, un turno completo per un assistente, testo ricercabile di un breve audio o un elenco di parole temporizzate per un'interfaccia di revisione. Verifica le parole decisive rispetto alla registrazione, conserva gli eventuali allineamenti mancanti e mantieni la clip collegata al testo restituito. Il risultato del riconoscimento fornisce al passaggio applicativo successivo una trascrizione fondata sulla fonte; rispondere alla richiesta o modificare il messaggio spetta al flusso circostante.
Ailoot Ultra · Trascrizione POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proIntroduzione
Universal-3.5 Pro è il modello di riconoscimento vocale di AssemblyAI che trasforma una breve clip audio in una trascrizione completa in un'unica risposta. Il profilo Sync aggiunge attendibilità delle parole, timestamp facoltativi per parola, suggerimenti lessicali e contesto della conversazione precedente per input vocali e flussi push-to-talk.
- Input accettati
- Audio
- Risultati
- Testo
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Trascrizione POST /v1/audio/transcriptions
- Tipi di input
audio- Tipi di output
text
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti assemblyai/universal-3-5-pro | Predefinito— |
Campoinput_audio | Tipoobject | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input_audio |
Parametromaterial_types | Contrattoaudio |
Parametromaterial_conditions | ContrattoL'esempio legge il tuo file PCM WAV reale e non vuoto, codifica tutti i byte del file in base64 e invia input_audio.format con valore wav. |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id esatto di un record multimediale esistente di tua proprietà
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariffe
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe Ailoot
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Unità di fatturazione | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Unità di fatturazione— | Costo Input · Token in input — / 1K token Output · Token in output — / 1K token Input · Lettura dalla cache — / 1K token Input · Scrittura nella cache — / 1K token Input · Scrittura nella cache, 1 ora — / 1K token |
| Configurazionesecondo audio in ingresso | Listino delle tariffe— | Unità di fatturazioneper secondo di audio in input | Costo Input · secondo audio in ingresso $0.00025 per secondo di audio in input |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Trascrizione
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.
Ricevi e salva i risultati
Ailoot Ultra · Trascrizione
Corpo completo della risposta originale, stato e intestazioni inoltrate. Questo gestore non aggiunge alcuna struttura JSON universale, campo di testo o struttura contenitore dell'attività.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati
Conserva ogni risposta, file e parte di contenuto restituiti per intero.
Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.
Se occorre verificare la risposta originale
Conserva l'X-Client-Request-ID effettivo e la risposta completa. Consulta le risorse originali di tua proprietà e i relativi URL firmati esatti del contenuto; non inviare mai nuovamente una creazione dall'esito incerto.
Campi della risposta
| Campo | Tipo |
|---|---|
Campotext (when present) | Tipo |
Campousage (when present) | Tipo |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneIl corpo JSON o l'ID canonico esplicito del modello non è valido. | Passaggio successivoConserva la risposta e correggi il campo della richiesta indicato. |
Risposta401 · authentication_error | CondizioneLa chiave API Ailoot non è valida. | Passaggio successivoUsa la tua chiave API Ailoot autorizzata. |
Risposta403 · permission_error | CondizioneIl gruppo della chiave non è autorizzato a utilizzare questo metodo. | Passaggio successivoConserva i dettagli dell'errore restituiti. |
Risposta404 · not_found_error | CondizioneIl metodo selezionato non dispone di una rotta autorizzata all'utilizzo. | Passaggio successivoConserva i dettagli dell'errore restituiti. |
Risposta422 · price_unavailable | CondizioneLa tariffa accettata non può ottenere la quantità in ingresso o il limite richiesto. | Passaggio successivoConserva la risposta; usa la rappresentazione dell'input richiesta dalla tariffa accettata. |
Risposta503 · | CondizioneL'archiviazione richiesta, la rotta, il prezzo del metodo o la riserva dell'importo non sono disponibili. | Passaggio successivoConserva l'intera risposta originale. Una riserva dell'importo dall'esito incerto non autorizza un nuovo invio. |
Risposta502 · server_error | CondizioneIl risultato originale, i dati di utilizzo o il conguaglio dell'addebito richiedono una verifica. | Passaggio successivoConserva l'ID effettivo della richiesta e la risposta originale. Consulta il record esistente di tua proprietà; non inviare nuovamente la richiesta di creazione. |
Alias
Alias del modello
Ailoot Ultra assemblyai/universal-3-5-pro
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · AssemblyAI: Universal-3.5 Pro
- Quali input e risultati sono disponibili?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Quali campi usa la richiesta?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio