AssemblyAI: Universal-3.5 Pro
Universal-3.5 Pro ist AssemblyAIs Speech-to-Text-Modell, das einen kurzen Audioclip in einer einzigen Antwort in ein vollständiges Transkript umwandelt. Sein Sync-Profil ergänzt Konfidenzwerte pro Wort, optionale Wortzeitstempel, Vokabularhinweise und den bisherigen Dialogkontext für Spracheingaben und Push-to-Talk-Abläufe.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Universal-3.5 Pro ist AssemblyAIs Spracherkennungsmodell für die Umwandlung aufgezeichneter Sprache in Text. Im Sync-Profil liefert ein kurzer Audioclip in einer einzigen Antwort ein vollständiges Transkript. Dies eignet sich für Sprachnachrichten, Push-to-Talk-Eingaben und einzelne Dialogbeiträge, bei denen die Anwendung bereits weiss, wann die Aufnahme enden soll.
Bereiten Sie die Audiodaten als zeitlich begrenzten Clip vor. AssemblyAIs Sync-Anforderungen akzeptieren eine Dauer von 80 Millisekunden bis 120 Sekunden bei einer maximalen Dateigrösse von 40 MB. Unterstützt werden WAV oder rohe vorzeichenbehaftete 16-Bit-PCM-Daten in Little-Endian-Reihenfolge. Audio kann mono oder stereo sein; Stereo wird intern auf mono heruntergemischt. Unterstützte Abtastraten sind 8, 16, 22.05, 24, 32, 44.1 und 48 kHz. Ein WAV-Header liefert Abtastrate und Kanalzahl; bei rohem PCM müssen diese Werte separat in der Transkriptionskonfiguration angegeben werden.
Erfassen Sie die vollständige Äusserung und lassen Sie Anfang und Ende der gesprochenen Passage unverändert. Eine hilfreiche Ausgangsaufgabe ist eine kurze Sprachnachricht an den Produktsupport mit einem Produktnamen, einer Bestellkennung und einem Anliegen. Bewahren Sie den Quellclip auf, damit das Transkript auf diese wichtigen Details geprüft werden kann. Bereiten Sie für längere Aufnahmen einen für Langform-Transkription geeigneten Ablauf vor, statt das Zeitlimit für Kurzclips als Aussage über die Audiokapazität des gesamten Modells zu behandeln.
Das Ergebnis enthält das vollständige Transkript, eine Wortliste mit Konfidenzwerten pro Wort und einen Gesamtkonfidenzwert zwischen null und eins. Es enthält ausserdem die Dauer des eingereichten Audios und eine Anfragekennung, sodass der Text seinem ursprünglichen Clip zugeordnet bleiben kann. Nutzen Sie die Wortkonfidenz, um Stellen zu finden, die durch Anhören geprüft werden sollten, insbesondere Namen, Zahlen und für die Anwendung wichtiges Fachvokabular.
Wortzeitstempel sind optional und standardmässig deaktiviert. Auf Anforderung kann jedes zeitlich zugeordnete Wort seinen Beginn und sein Ende in Millisekunden relativ zum Clipanfang enthalten. Das Herstellerprofil lässt diese Werte fehlen, wenn ein Wort nicht zeitlich zugeordnet werden kann, statt einen ungefähren Zeitpunkt zu erfinden. Die Zeitstempelgenauigkeit ist bei englischem Audio am besten. Halten Sie fehlende Zeitangaben ausdrücklich fest, wenn Sie Worthervorhebungen, eine durchsuchbare Wellenform oder Untertitelzuordnungen vorbereiten, und vergleichen Sie den Text mit der Aufnahme, bevor Sie ihn als fertige Untertitelspur verwenden.
Ein Kontextprompt beschreibt, worum es in der Aufnahme geht. Er kann ein Fachgebiet, ein Szenario oder bestimmte der Anwendung bereits bekannte Details nennen und darf höchstens 6000 Zeichen lang sein. Beginnen Sie mit einer kurzen, zum Audio passenden Beschreibung, etwa einem technischen Supportgespräch über ein bestimmtes Gerät. Der Prompt liefert Erkennungskontext; er fordert nicht dazu auf, die Nachricht der sprechenden Person in ein anderes Dokument umzuschreiben.
Eine separate Liste von Schlüsselbegriffen lenkt die Erkennung auf bestimmtes Vokabular. Das Sync-Profil akzeptiert bis zu 100 Begriffe und insgesamt 8000 Zeichen in dieser Liste. Verwenden Sie genaue Schreibweisen für ungewöhnliche Namen, Akronyme oder Produktbegriffe und lassen Sie gewöhnliche, gut erkannte Wörter weg. Umfangreiche oder unnötige Begriffslisten können zu Überkorrekturen führen; konzentrieren Sie sich daher auf Wörter, die in der Aufnahme wichtig sind. Kontextbeschreibung und Vokabularliste können gemeinsam verwendet werden.
Auch der bisherige Dialog kann bei der Interpretation einer kurzen Antwort helfen. Stellen Sie frühere Äusserungen chronologisch von der ältesten zur neuesten bereit; das aktuelle Audio bleibt der zu transkribierende Beitrag. Das dokumentierte Kontextbudget beträgt 500 Beiträge oder insgesamt 16'000 Zeichen. Überschreitet es diese Grenzen oder den verfügbaren Modellkontext, werden die ältesten Einträge zuerst entfernt. Dies ist hilfreich, wenn eine kurze Antwort eine Kennung oder einen Verweis enthält, deren Bedeutung aus der vorhergehenden Frage hervorgeht.
Die Sprachauswahl lenkt die Erkennung auf eine oder mehrere erwartete Sprachen. Die aktuelle Sync-Schnittstelle akzeptiert 32 Sprachcodes und verwendet standardmässig Englisch, wenn keine Auswahl angegeben wird. Listen Sie bei Audio mit Sprachwechseln die erwarteten Sprachen auf. Ein eigener Kontextprompt ersetzt den verwalteten Standard und übersteuert die separate Steuerung durch Sprachcodes. Nennen Sie deshalb die erwarteten Sprachen innerhalb dieses Prompts, wenn sowohl Sprach- als auch Szenariokontext benötigt werden. Bewahren Sie das Transkript in den tatsächlich gesprochenen Sprachen, statt Transkription als Übersetzungsanweisung zu behandeln.
Das Modell kommt auch in anderen Transkriptionsabläufen von AssemblyAI vor; die Anforderungen an Kurzclips und die Ergebnisfelder des Sync-Profils gehören jedoch zu dieser konkreten Schnittstelle. Der Dictation-Ablauf des Herstellers ergänzt eine separate Textbereinigungsphase; ein Transkript und eine umgeschriebene Nachricht sind unterschiedliche Ergebnisse. Bewahren Sie die erkannte Sprache auf, wenn ein späterer Bearbeitungs- oder Zusammenfassungsschritt eine bereinigte Fassung erzeugt, damit die ursprüngliche Formulierung für Vergleiche verfügbar bleibt.
Nützliche Ergebnisse sind eine transkribierte Sprachnachricht, ein vollständiger Beitrag für einen Assistenten, kurzer durchsuchbarer Audiotext oder eine zeitlich zugeordnete Wortliste für eine Prüfoberfläche. Prüfen Sie die entscheidenden Wörter anhand der Aufnahme, bewahren Sie fehlende zeitliche Zuordnungen und halten Sie die Verbindung zwischen Clip und zurückgegebenem Text aufrecht. Das Erkennungsergebnis liefert dem nächsten Anwendungsschritt eine quellenbezogene Transkription; das Beantworten des Anliegens oder Bearbeiten der Nachricht gehört zum umgebenden Ablauf.
Ailoot Ultra · Transkription POST /v1/audio/transcriptions assemblyai/universal-3-5-pro
assemblyai/universal-3-5-proEinstieg
Universal-3.5 Pro ist AssemblyAIs Speech-to-Text-Modell, das einen kurzen Audioclip in einer einzigen Antwort in ein vollständiges Transkript umwandelt. Sein Sync-Profil ergänzt Konfidenzwerte pro Wort, optionale Wortzeitstempel, Vokabularhinweise und den bisherigen Dialogkontext für Spracheingaben und Push-to-Talk-Abläufe.
- Zulässige Eingaben
- Audio
- Ergebnisse
- Text
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Transkription POST /v1/audio/transcriptions
- Eingabe
audio- Ausgabe
text
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits assemblyai/universal-3-5-pro | Standard— |
Feldinput_audio | Typobject | AnforderungErforderlich | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input_audio |
Parametermaterial_types | Vertragaudio |
Parametermaterial_conditions | VertragDas Beispiel liest Ihre tatsächliche, nicht leere PCM-WAV-Datei, codiert sämtliche Dateibytes als base64 und sendet input_audio.format als wav. |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Exakte task_id aus einem bestehenden, Ihnen zugeordneten Medieneintrag
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Abrechnungseinheit | Gebühr |
|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Tokens Ausgabe · Ausgabetoken — / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · Cache schreiben — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationAudioeingabe-Sekunde | Tarifstaffel— | Abrechnungseinheitpro Sekunde Eingabeaudio | Gebühr Eingabe · Audioeingabe-Sekunde $0.00025 pro Sekunde Eingabeaudio |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Transkription
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.
Ergebnisse abrufen und speichern
Ailoot Ultra · Transkription
Vollständiger ursprünglicher Antwortinhalt, Status und weitergeleitete Header. Dieser Handler fügt weder eine allgemeingültige JSON-Struktur noch ein Textfeld oder eine Aufgabenhülle hinzu.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die tatsächliche X-Client-Request-ID und die vollständige Antwort auf. Lesen Sie die ursprünglichen, Ihnen zugeordneten Assets und ihre exakten signierten Inhalts-URLs; reichen Sie eine Erstellung mit unklarem Ausgang niemals erneut ein.
Antwortfelder
| Feld | Typ |
|---|---|
Feldtext (when present) | Typ |
Feldusage (when present) | Typ |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungDer JSON-Anfragetext oder die explizite kanonische Modell-ID ist ungültig. | Nächster SchrittBewahren Sie die Antwort auf und korrigieren Sie das angegebene Anfragefeld. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel von Ailoot ist ungültig. | Nächster SchrittVerwenden Sie Ihren autorisierten API-Schlüssel von Ailoot. |
Antwort403 · permission_error | BedingungDie Schlüsselgruppe lässt diese Methode nicht zu. | Nächster SchrittBewahren Sie die zurückgegebenen Fehlerdetails auf. |
Antwort404 · not_found_error | BedingungFür die ausgewählte Methode gibt es keine zugelassene Route. | Nächster SchrittBewahren Sie die zurückgegebenen Fehlerdetails auf. |
Antwort422 · price_unavailable | BedingungFür den akzeptierten Tarif lässt sich die erforderliche Eingabemenge oder deren Grenze nicht ermitteln. | Nächster SchrittBewahren Sie die Antwort auf; verwenden Sie die vom akzeptierten Tarif verlangte Eingabedarstellung. |
Antwort503 · | BedingungErforderlicher Speicher, Route, Methodenpreis oder Reservierung ist nicht verfügbar. | Nächster SchrittBewahren Sie die vollständige ursprüngliche Antwort auf. Eine Reservierung mit unklarem Zustand ist keine Erlaubnis zum erneuten Einreichen. |
Antwort502 · server_error | BedingungDas ursprüngliche Ergebnis, der Verbrauch oder die Abrechnung muss geprüft werden. | Nächster SchrittBewahren Sie die tatsächliche Anfrage-ID und die ursprüngliche Antwort auf. Lesen Sie den bestehenden, Ihnen zugeordneten Eintrag; reichen Sie die Erstellung nicht erneut ein. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra assemblyai/universal-3-5-pro
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · AssemblyAI: Universal-3.5 Pro
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:audio→text- Welche Felder verwendet die Anfrage?
POST /v1/audio/transcriptions·assemblyai/universal-3-5-pro:model,input_audio