ElevenLabs: Scribe v2
ElevenLabs Scribe v2 transkrybuje nagrany dźwięk w ponad 90 językach, ze znacznikami czasu na poziomie słów, opcjonalną diaryzacją mówców i znacznikami zdarzeń innych niż mowa. Służy do długich nagrań, napisów i edytowalnych transkrypcji, oferując kontekstowe terminy kluczowe oraz wybór transkrypcji dosłownej lub wygładzonej.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
ElevenLabs Scribe v2 to model rozpoznawania mowy w trybie wsadowym do nagranego dźwięku, transkrypcji i tworzenia napisów, w tym napisów dla niesłyszących. Rozwija Scribe v1, lepiej obsługując długie nagrania, pauzy, zmiany tonu i dłuższą ciszę. Wynikiem jest zapis mowy z informacjami o czasie i opcjonalnymi oznaczeniami mówców oraz zdarzeń dźwiękowych. Scribe v2 Realtime to osobna edycja transkrypcji na żywo; zadaniem tego modelu jest przetwarzanie kompletnych nagrań.
Producent dokumentuje rozpoznawanie ponad 90 języków i automatyczne wykrywanie języka, w tym w nagraniach, w których języki się zmieniają. Podpowiedź znanego języka może pomóc modelowi zinterpretować dźwięk. Przygotuj wyraźne nagranie, zachowaj oryginalny język i nazwy oraz unikaj silnego przesterowania lub zbędnego przetwarzania usuwającego szczegóły mowy. Do popularnych udokumentowanych formatów wejściowych należą WAV, MP3, FLAC, M4A, AAC, OGG, Opus i WebM. Wybierz reprezentację wejścia obsługiwaną przez implementację transkrypcji i zachowaj nagranie źródłowe do weryfikacji.
Standardowa odpowiedź zawiera rozpoznany tekst, informacje o wykrytym języku i sekwencję słów ze znacznikami czasu. Rekordy słów mogą obejmować czas początku i końca, identyfikatory mówców i logarytm prawdopodobieństwa rozpoznania. Dzięki temu wynik nadaje się do napisów, przeszukiwalnych wywiadów lub edytora pozwalającego wrócić do właściwego miejsca w dźwięku. Zachowaj wynik ze znacznikami czasu wraz ze źródłowym nagraniem. W przypadku podcastu materiałem końcowym może być na przykład edytowalna transkrypcja i zapis wyrównany na poziomie słów, który pomaga znajdować miejsca do poprawienia przed ułożeniem napisów.
Diaryzacja mówców oznacza, kto i kiedy mówi w nagraniu wieloosobowym; producent dokumentuje obsługę maksymalnie 32 mówców. Włącz ją, gdy zmiany wypowiadających się osób są istotne, i podaj rozsądną liczbę mówców, jeśli jest znana. Odróżniaj wykrytą etykietę mówcy od zweryfikowanego imienia i nazwiska osoby. W wywiadzie lub spotkaniu sprawdzaj zmiany mówców na podstawie nagrania, zwłaszcza gdy głosy nakładają się lub brzmią podobnie. Etykieta pomaga uporządkować transkrypcję; sama nie potwierdza tożsamości mówcy.
Nagranie z jednym mówcą na kanał ma inną strukturę niż kilka głosów zmiksowanych w jednym kanale. Interfejs producenta może niezależnie przetwarzać do pięciu kanałów i zwracać osobne transkrypcje lub transkrypcję łączną uporządkowaną według czasu, z indeksami kanałów. Zachowaj ten układ kanałów, gdy ma znaczenie. Sprowadzenie rozdzielonego nagrania rozmowy do jednego kanału przed transkrypcją może usunąć użyteczne źródło informacji o mówcach. Odróżniaj przypisanie na podstawie kanału od diaryzacji wywnioskowanej ze zmiksowanego dźwięku. Odpowiedź łącząca kanały wymaga znaczników czasu i nie może zawierać wykrywania ani maskowania encji.
Podpowiadanie terminów kluczowych ukierunkowuje rozpoznawanie nazw, terminów produktowych i słownictwa specjalistycznego z wykorzystaniem kontekstu. Aktualna dokumentacja trybu wsadowego dopuszcza do 1 000 terminów, każdy krótszy niż 50 znaków i zawierający najwyżej pięć słów. Podawaj istotne zapisy zamiast obszernego, niepowiązanego katalogu. Dla wywiadu technicznego podaj nazwy produktów i skróty, które prawdopodobnie się pojawią, a następnie sprawdź je przy ich znacznikach czasu w wyniku. Terminy kluczowe wpływają na rozpoznawanie; nie są instrukcjami wstawienia terminu, którego nagranie nie potwierdza.
Określ cel transkrypcji przed zastosowaniem wygładzania. Zapis dosłowny zachowuje wypowiedziane sformułowania, a udokumentowana opcja no-verbatim usuwa wypełniacze, urwane początki wypowiedzi i niepłynności, tworząc bardziej czytelny wynik. Dynamiczne oznaczanie dźwięku może identyfikować zdarzenia inne niż mowa, takie jak śmiech lub kroki. Wygładzona transkrypcja może być użyteczna do napisów lub czytania, ale nie powinna po cichu zastępować surowego zapisu, gdy powtórzenia, korekty lub dźwięki inne niż mowa mają znaczenie dla zadania.
Producent dokumentuje także wykrywanie encji i eksperymentalną edycję transkrypcji. W interfejsie producenta edycji transkrypcji nie można łączyć z wykrywaniem encji, maskowaniem encji ani transkrypcją wielokanałową. Wykryte encje zapewniają uporządkowane pozycje wybranych informacji w transkrypcji. Opcjonalne maskowanie encji zastępuje wykryty tekst etykietami; zależy od wykrywania encji, a po włączeniu maskowania lista encji nie jest zwracana. Maskowanie odbywa się podczas transkrypcji z użyciem ogólnego znacznika zastępczego, etykiety kategorii lub numerowanej etykiety kategorii. Automatyczne maskowanie może przeoczyć wrażliwą treść, dlatego sprawdź zamaskowaną transkrypcję przed jej udostępnieniem. Edycja zlecona w języku naturalnym zwraca zmieniony tekst obok oryginalnego wyniku, pozostawiając dostępny oryginalny zapis czasu i mówców. Zachowuj te materiały oddzielnie: poprawiona pisownia lub przeformatowane zdanie mogą wymagać ponownego sprawdzenia przed wyrównaniem z dźwiękiem lub wykorzystaniem w dalszym wyodrębnianiu danych. Te funkcje przetwarzają transkrypcję; nie potwierdzają, że każdy istotny szczegół został rozpoznany poprawnie.
Aby ukończyć transkrypcję, sprawdź nazwy, liczby, negacje i zmiany mówców, wracając do odpowiednich miejsc nagrania. Zwracaj uwagę na ciche fragmenty, nakładające się głosy i zmiany języka, zamiast oceniać jakość wyłącznie po płynności tekstu. Pozostaw niepewne sformułowania do poprawienia, zamiast uzupełniać niesłyszalny fragment wiarygodnie brzmiącym zdaniem. Użytecznym wynikiem jest sprawdzony zapis tekstowy z informacjami o czasie i mówcach potrzebnymi do zamierzonego zastosowania; transkrypcja może następnie stać się wejściem do osobnego etapu podsumowania, tłumaczenia lub analizy.
Ailoot Ultra · Transkrypcja POST /v1/audio/transcriptions elevenlabs/scribe-v2
elevenlabs/scribe-v2Start
ElevenLabs Scribe v2 transkrybuje nagrany dźwięk w ponad 90 językach, ze znacznikami czasu na poziomie słów, opcjonalną diaryzacją mówców i znacznikami zdarzeń innych niż mowa. Służy do długich nagrań, napisów i edytowalnych transkrypcji, oferując kontekstowe terminy kluczowe oraz wybór transkrypcji dosłownej lub wygładzonej.
- Akceptowane dane wejściowe
- Audio
- Wyniki
- Tekst
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Transkrypcja POST /v1/audio/transcriptions
- Wejście
audio- Wyjście
text
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity elevenlabs/scribe-v2 | Domyślnie— |
Poleinput_audio | Typobject | WymaganieWymagane | Wartości i limity | Domyślnie— |
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, input_audio |
Parametrmaterial_types | Kontraktaudio |
Parametrmaterial_conditions | KontraktPrzykład odczytuje Twój rzeczywisty, niepusty plik PCM WAV, koduje wszystkie bajty pliku jako base64 i wysyła input_audio.format z wartością wav. |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · dokładne task_id z istniejącego rekordu multimediów należących do użytkownika
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cennik
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Stawki Ailoot
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Jednostka rozliczeniowa | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Jednostka rozliczeniowa— | Opłata Wejście · Tokeny wejściowe — / 1K tokenów Wyjście · Tokeny wyjściowe — / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
| Konfiguracjasekunda wejściowego audio | Tabela stawek— | Jednostka rozliczeniowaza sekundę dźwięku wejściowego | Opłata Wejście · sekunda wejściowego audio $0.0001222222222222 za sekundę dźwięku wejściowego |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
Ailoot Ultra · Transkrypcja
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.
Odbieranie i zapisywanie wyników
Ailoot Ultra · Transkrypcja
Kompletna treść oryginalnej odpowiedzi, status i przekazane nagłówki. Ta funkcja obsługująca nie dodaje uniwersalnej struktury JSON, pola tekstowego ani obudowy zadania.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Zachowaj wszystkie ukończone wyniki
Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.
Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj rzeczywiste X-Client-Request-ID i kompletną odpowiedź. Odczytuj pierwotne zasoby należące do użytkownika i ich dokładne podpisane adresy URL treści; nigdy nie ponawiaj niepewnego utworzenia.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Poletext (when present) | Typ |
Poleusage (when present) | Typ |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekTreść JSON lub jawny kanoniczny identyfikator modelu są nieprawidłowe. | Następny krokZachowaj odpowiedź i popraw wskazane pole żądania. |
Odpowiedź401 · authentication_error | WarunekKlucz API Ailoot jest nieprawidłowy. | Następny krokUżyj swojego autoryzowanego klucza API Ailoot. |
Odpowiedź403 · permission_error | WarunekGrupa klucza nie ma uprawnień do tej metody. | Następny krokZachowaj zwrócone szczegóły błędu. |
Odpowiedź404 · not_found_error | WarunekWybrana metoda nie ma dopuszczonej ścieżki. | Następny krokZachowaj zwrócone szczegóły błędu. |
Odpowiedź422 · price_unavailable | WarunekZaakceptowana taryfa nie może uzyskać wymaganej ilości danych wejściowych lub ich górnej granicy. | Następny krokZachowaj odpowiedź; użyj reprezentacji danych wejściowych wymaganej przez zaakceptowaną taryfę. |
Odpowiedź503 · | WarunekWymagany magazyn, ścieżka, cena metody lub rezerwacja są niedostępne. | Następny krokZachowaj kompletną oryginalną odpowiedź. Niepewna rezerwacja nie uprawnia do ponownego wysłania. |
Odpowiedź502 · server_error | WarunekPierwotny wynik, dane użycia lub rozliczenie wymagają sprawdzenia. | Następny krokZachowaj rzeczywisty identyfikator żądania i oryginalną odpowiedź. Odczytuj istniejący rekord należący do użytkownika; nie wysyłaj ponownie żądania utworzenia. |
Aliasy
Aliasy modelu
Ailoot Ultra elevenlabs/scribe-v2
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · ElevenLabs: Scribe v2
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:audio→text- Jakich pól używa żądanie?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:model,input_audio