ElevenLabs: Scribe v2
ElevenLabs Scribe v2 transkribiert aufgezeichnetes Audio in mehr als 90 Sprachen mit Zeitangaben auf Wortebene, optionaler Sprecherzuordnung und Markierungen nichtsprachlicher Ereignisse. Es ist für lange Aufnahmen, Untertitel und bearbeitbare Transkripte ausgelegt und bietet kontextbezogene Schlüsselbegriffe sowie die Wahl zwischen wortgetreuer und bereinigter Transkription.
Ü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.
ElevenLabs Scribe v2 ist das Spracherkennungsmodell zur Stapelverarbeitung für aufgezeichnetes Audio, Transkription sowie Untertitel mit und ohne Zusatzinformationen. Es baut auf Scribe v1 auf und verarbeitet lange Aufnahmen, Pausen, Tonfalländerungen und längere Stille besser. Das Ergebnis ist verschriftlichte Sprache mit Zeitinformationen und optionalen Anmerkungen zu Sprechern und Audioereignissen. Scribe v2 Realtime ist eine eigene Ausgabe zur Live-Transkription; dieses Modell dient der Verarbeitung vollständiger Aufnahmen.
Der Hersteller dokumentiert Erkennung in mehr als 90 Sprachen und automatische Erkennung der Sprache, auch bei Aufnahmen mit Sprachwechseln. Ein Hinweis auf die bekannte Sprache kann dem Modell bei der Interpretation des Audios helfen. Bereiten Sie eine klare Aufnahme vor, bewahren Sie Originalsprache und Namen und vermeiden Sie starke Übersteuerung oder unnötige Bearbeitung, die Sprachdetails entfernt. Zu den gängigen dokumentierten Eingabeformaten zählen WAV, MP3, FLAC, M4A, AAC, OGG, Opus und WebM. Wählen Sie eine von der Transkriptionsimplementierung unterstützte Eingabedarstellung und bewahren Sie die Quellaufnahme zur Prüfung auf.
Die Standardantwort enthält den erkannten Text, Informationen zur erkannten Sprache und eine Folge zeitlich zugeordneter Wörter. Wortdatensätze können Start- und Endzeiten, Sprecherkennungen und einen logarithmischen Erkennungswahrscheinlichkeitswert enthalten. Diese Angaben machen das Ergebnis für Untertitel, durchsuchbare Interviews oder einen Editor nützlich, der zur relevanten Tonstelle springt. Bewahren Sie das zeitlich zugeordnete Ergebnis zusammen mit dem Quellaudio auf. Bei einem Podcast kann das Arbeitsergebnis beispielsweise ein bearbeitbares Transkript und ein wortweise zugeordneter Datensatz sein, der das Auffinden von Korrekturen vor der Untertitelanordnung unterstützt.
Die Sprecherzuordnung kennzeichnet bei Audio mit mehreren Personen, wer wann spricht; der Hersteller dokumentiert bis zu 32 Sprecher. Aktivieren Sie sie, wenn Sprecherwechsel wichtig sind, und geben Sie eine sinnvolle Sprecheranzahl an, falls sie bekannt ist. Unterscheiden Sie eine erkannte Sprecherbezeichnung vom verifizierten Namen einer Person. Prüfen Sie bei einem Interview oder einer Besprechung die Sprecherwechsel anhand der Aufnahme, insbesondere bei überlappenden oder ähnlich klingenden Stimmen. Eine Bezeichnung hilft, das Transkript zu ordnen; sie belegt die Identität der sprechenden Person nicht unabhängig.
Eine Aufnahme mit einer Person pro Kanal hat eine andere Struktur als mehrere in einem Kanal gemischte Stimmen. Die Herstellerschnittstelle kann bis zu fünf Kanäle unabhängig verarbeiten und separate Transkripte oder ein nach Zeit geordnetes kombiniertes Transkript mit Kanalindizes zurückgeben. Bewahren Sie diese Kanalaufteilung, wenn sie aussagekräftig ist. Werden getrennte Kanäle einer Gesprächsaufnahme vor der Transkription zusammengeführt, kann eine nützliche Quelle für Sprecherinformationen verloren gehen. Halten Sie kanalbasierte Zuordnung von der aus gemischtem Audio erschlossenen Sprecherzuordnung getrennt. Die kombinierte Kanalantwort erfordert Zeitstempel und kann keine Entitätserkennung oder Entitätenschwärzung enthalten.
Schlüsselbegriffe steuern die Erkennung von Namen, Produktbegriffen und Fachvokabular anhand des Kontexts. Die aktuelle Batch-Dokumentation erlaubt bis zu 1.000 Begriffe, wobei jeder Begriff weniger als 50 Zeichen und höchstens fünf Wörter umfasst. Geben Sie relevante Schreibweisen statt eines breiten, sachfremden Katalogs vor. Liefern Sie für ein technisches Interview die voraussichtlich vorkommenden Produktnamen und Abkürzungen und prüfen Sie diese anschließend an ihren Zeitmarken im Ergebnis. Schlüsselbegriffe beeinflussen die Erkennung; sie sind keine Anweisungen, einen Begriff einzufügen, wenn die Aufnahme ihn nicht stützt.
Legen Sie den Zweck des Transkripts vor einer Bereinigung fest. Eine wortgetreue Aufzeichnung bewahrt den gesprochenen Wortlaut, während die dokumentierte Option „no-verbatim“ für nicht wortgetreue Transkription Füllwörter, Fehlansätze und Stockungen für bessere Lesbarkeit entfernt. Dynamische Audiomarkierungen können nichtsprachliche Ereignisse wie Lachen oder Schritte kennzeichnen. Ein geglättetes Transkript kann für Untertitel oder zum Lesen nützlich sein, sollte die Rohaufzeichnung aber nicht stillschweigend ersetzen, wenn Wiederholungen, Korrekturen oder nichtsprachliche Geräusche für die Aufgabe wichtig sind.
Der Hersteller dokumentiert außerdem Entitätserkennung und experimentelle Transkriptbearbeitung. In der Herstellerschnittstelle lässt sich Transkriptbearbeitung nicht mit Entitätserkennung, Entitätenschwärzung oder Mehrkanaltranskription kombinieren. Erkannte Entitäten liefern strukturierte Positionsangaben für ausgewählte Informationen im Transkript. Optionale Entitätenschwärzung maskiert erkannten Text mit Ersatzbezeichnungen; sie hängt von der Entitätserkennung ab, und bei aktivierter Schwärzung wird die Entitätenliste nicht zurückgegeben. Die Schwärzung erfolgt während der Transkription mit einer allgemeinen Ersatzmarkierung, einer Kategorienbezeichnung oder einer nummerierten Kategorienbezeichnung. Automatische Schwärzung kann sensible Inhalte übersehen; prüfen Sie daher das geschwärzte Transkript vor der Weitergabe. Eine Bearbeitung in natürlicher Sprache gibt einen bearbeiteten Text neben dem ursprünglichen Ergebnis zurück und lässt die ursprünglichen Zeitangaben und Sprecherdaten verfügbar. Halten Sie diese Arbeitsergebnisse auseinander: Eine korrigierte Schreibweise oder ein umformatierter Satz kann eine erneute Prüfung benötigen, bevor er dem Audio zugeordnet oder in einer nachgelagerten Extraktion verwendet wird. Diese Funktionen verarbeiten das Transkript; sie belegen nicht, dass jedes wichtige Detail korrekt erkannt wurde.
Prüfen Sie für ein fertiges Transkript Namen, Zahlen, Verneinungen und Sprecherwechsel, indem Sie zu den entsprechenden Audiostellen zurückkehren. Achten Sie auf leise Abschnitte, Überlappungen und Sprachwechsel, statt die Qualität nur nach flüssigem Text zu beurteilen. Bewahren Sie unsicheren Wortlaut zur Korrektur auf, statt eine unhörbare Passage mit einem plausiblen Satz zu ergänzen. Das nützliche Ergebnis ist eine geprüfte Textaufzeichnung mit den für den beabsichtigten Zweck benötigten Zeit- und Sprecherinformationen; ein Transkript kann anschließend als Eingabe für einen getrennten Zusammenfassungs-, Übersetzungs- oder Analyseschritt dienen.
Ailoot Ultra · Transkription POST /v1/audio/transcriptions elevenlabs/scribe-v2
elevenlabs/scribe-v2Einstieg
ElevenLabs Scribe v2 transkribiert aufgezeichnetes Audio in mehr als 90 Sprachen mit Zeitangaben auf Wortebene, optionaler Sprecherzuordnung und Markierungen nichtsprachlicher Ereignisse. Es ist für lange Aufnahmen, Untertitel und bearbeitbare Transkripte ausgelegt und bietet kontextbezogene Schlüsselbegriffe sowie die Wahl zwischen wortgetreuer und bereinigter Transkription.
- 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 elevenlabs/scribe-v2 | 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, kodiert die vollständigen Dateibytes als base64 und übermittelt 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 Mediendatensatz
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 |
|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Tokens Ausgabe · Ausgabetoken — / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · In Cache schreiben — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationAudioeingabesekunde | Tarifstaffel— | Abrechnungseinheitpro Sekunde Eingabeaudio | Gebühr Eingabe · Audioeingabesekunde $0.0001222222222222 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 abschließenden 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': 'elevenlabs/scribe-v2', '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 ein allgemeingültiges JSON-Format noch ein Textfeld oder eine äußere Aufgabenstruktur 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 deren exakte signierte Inhalts-URLs; übermitteln Sie eine Erstellung mit unklarem Ergebnis niemals erneut.
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-Inhalt 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 Ailoot API-Schlüssel ist ungültig. | Nächster SchrittVerwenden Sie Ihren autorisierten Ailoot API-Schlüssel. |
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 ist keine Route zugelassen. | Nächster SchrittBewahren Sie die zurückgegebenen Fehlerdetails auf. |
Antwort422 · price_unavailable | BedingungDer akzeptierte Tarif kann seine erforderliche Eingabemenge oder Obergrenze nicht ermitteln. | Nächster SchrittBewahren Sie die Antwort auf; verwenden Sie die vom akzeptierten Tarif erforderte Eingabedarstellung. |
Antwort503 · | BedingungErforderlicher Speicher, Route, Methodenpreis oder Reservierung ist nicht verfügbar. | Nächster SchrittBewahren Sie die vollständige ursprüngliche Antwort auf. Eine unklare Reservierung berechtigt nicht zur erneuten Übermittlung. |
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 Datensatz; übermitteln Sie die Erstellung nicht erneut. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra elevenlabs/scribe-v2
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · ElevenLabs: Scribe v2
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:audio→text- Welche Felder verwendet die Anfrage?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:model,input_audio