ElevenLabs: Scribe v2
ElevenLabs Scribe v2 transkribiert aufgezeichnetes Audio in über 90 Sprachen mit Wortzeitmarken, optionaler Sprecherdiarisierung und Markierungen für nichtsprachliche 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 Modell zur Stapel-Spracherkennung für aufgezeichnetes Audio, Transkription und Untertitelung, auch mit Angaben zu Geräuschen und Sprechenden. Es baut auf Scribe v1 auf und verbessert die Verarbeitung langer Aufnahmen, Pausen, Änderungen im Tonfall und längerer Stille. Das Ergebnis ist verschriftlichte Sprache mit Zeitangaben sowie optionalen Sprecher- und Audioereignis-Annotationen. Scribe v2 Realtime ist eine separate Version für Live-Transkription; dieses Modell dient der Verarbeitung vollständiger Aufnahmen.
Der Hersteller dokumentiert Erkennung in mehr als 90 Sprachen und automatische Spracherkennung, auch bei Aufnahmen mit Sprachwechseln. Ein Hinweis auf eine bekannte Sprache kann dem Modell helfen, das Audio zu interpretieren. Bereiten Sie eine klare Aufnahme vor, erhalten Sie Originalsprache und Namen und vermeiden Sie starke Übersteuerung oder unnötige Verarbeitung, die Sprachdetails entfernt. Zu den gängigen dokumentierten Eingaben gehören 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 zeitmarkierter Wörter. Wortdatensätze können Start- und Endzeiten, Sprecherkennungen und eine logarithmische Erkennungswahrscheinlichkeit enthalten. Damit eignet sich das Ergebnis für Untertitel, durchsuchbare Interviews oder einen Editor, der zur betreffenden Audiostelle zurückspringt. Bewahren Sie das zeitmarkierte Ergebnis zusammen mit dem Quellaudio auf. Bei einem Podcast kann das Arbeitsergebnis beispielsweise aus einem bearbeitbaren Transkript und einem wortweise zeitlich zugeordneten Datensatz bestehen, mit dem sich Korrekturen vor der Anordnung der Untertitel auffinden lassen.
Sprecherdiarisierung kennzeichnet bei Audio mit mehreren Personen, wer wann spricht; der Hersteller dokumentiert bis zu 32 Sprechende. Aktivieren Sie sie, wenn Sprecherwechsel wichtig sind, und geben Sie eine realistische Sprecheranzahl vor, falls diese bekannt ist. Unterscheiden Sie eine erkannte Sprecherkennzeichnung vom bestätigten Namen einer Person. Prüfen Sie bei einem Interview oder einer Besprechung Sprecherwechsel anhand der Aufnahme, besonders bei überlappenden oder ähnlich klingenden Stimmen. Eine Kennzeichnung 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 Schnittstelle des Herstellers 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 Kanalanordnung, wenn sie aussagekräftig ist. Wird eine getrennte Gesprächsaufnahme vor der Transkription zusammengeführt, kann eine nützliche Quelle für Sprecherinformationen verloren gehen. Halten Sie kanalbasierte Zuordnung von Diarisierung getrennt, die aus gemischtem Audio erschlossen wird. Die Antwort mit kombinierten Kanälen erfordert Zeitmarken und kann weder Entitätserkennung noch Schwärzung enthalten.
Schlüsselbegriff-Prompts lenken die Erkennung von Namen, Produktbegriffen und Fachwortschatz mithilfe des Kontexts. Die aktuelle Stapeldokumentation erlaubt bis zu 1'000 Begriffe mit jeweils weniger als 50 Zeichen und höchstens fünf Wörtern. Geben Sie relevante Schreibweisen statt eines breiten sachfremden Katalogs vor. Stellen Sie für ein technisches Interview die wahrscheinlich vorkommenden Produktnamen und Abkürzungen bereit und prüfen Sie sie anschliessend 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 vor einer Bereinigung den Zweck des Transkripts fest. Eine wortgetreue Aufzeichnung bewahrt den gesprochenen Wortlaut, während die dokumentierte Option «no-verbatim» Füllwörter, Fehlansätze und Sprechunflüssigkeiten für ein besser lesbares Ergebnis entfernt. Dynamische Audiomarkierungen können nichtsprachliche Ereignisse wie Lachen oder Schritte identifizieren. Ein geglättetes Transkript kann für Untertitel oder zum Lesen nützlich sein, sollte aber die Rohfassung nicht stillschweigend ersetzen, wenn Wiederholungen, Korrekturen oder nichtsprachliche Geräusche für die Aufgabe wichtig sind.
Der Hersteller dokumentiert ausserdem Entitätserkennung und experimentelle Transkriptbearbeitung. Transkriptbearbeitung lässt sich in der Herstellerschnittstelle nicht mit Entitätserkennung, Entitätenschwärzung oder Mehrkanaltranskription kombinieren. Erkannte Entitäten liefern strukturierte Positionsangaben für ausgewählte Informationen im Transkript. Die optionale Entitätenschwärzung maskiert erkannten Text durch Ersatzkennzeichnungen; sie setzt Entitätserkennung voraus, und bei aktivierter Schwärzung wird die Entitätenliste nicht zurückgegeben. Die Schwärzung erfolgt während der Transkription und verwendet einen allgemeinen Ersatzmarker, eine Kategoriekennzeichnung oder eine nummerierte Kategoriekennzeichnung. Automatische Schwärzung kann sensible Inhalte übersehen; prüfen Sie das geschwärzte Transkript daher vor der Weitergabe. Eine Bearbeitung in natürlicher Sprache liefert einen bearbeiteten Text neben dem ursprünglichen Ergebnis zurück, während ursprüngliche Zeit- und Sprecherdaten verfügbar bleiben. Halten Sie diese Arbeitsergebnisse auseinander: Eine korrigierte Schreibweise oder ein umformatierter Satz benötigt möglicherweise eine erneute Prüfung, bevor er mit dem Audio abgeglichen 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 anhand flüssigen Textes zu beurteilen. Bewahren Sie unsichere Formulierungen zur Korrektur, statt eine unhörbare Passage mit einem plausiblen Satz zu ergänzen. Das nützliche Ergebnis ist ein geprüfter Textdatensatz mit den für seinen Zweck erforderlichen Zeit- und Sprecherinformationen; ein Transkript kann danach als Eingabe für einen separaten Schritt zur Zusammenfassung, Übersetzung oder Analyse dienen.
Ailoot Ultra · Transkription POST /v1/audio/transcriptions elevenlabs/scribe-v2
elevenlabs/scribe-v2Einstieg
ElevenLabs Scribe v2 transkribiert aufgezeichnetes Audio in über 90 Sprachen mit Wortzeitmarken, optionaler Sprecherdiarisierung und Markierungen für nichtsprachliche 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, 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.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 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': '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 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 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