Utwórz transkrypcję

ID modelu do użycia w transkrypcji.

Plik do transkrypcji (minimalna długość audio: 100 ms). Obsługiwane są wszystkie główne formaty audio i wideo. Podaj dokładnie jeden z parametrów file lub cloud_storage_url. Plik musi mieć mniej niż 5,0 GB.

Wartość language_code ISO-639-1 lub ISO-639-3 odpowiadająca językowi pliku audio. Jeśli jest znana z wyprzedzeniem, może czasem poprawić jakość transkrypcji. Domyślnie ma wartość null, a język jest wtedy wykrywany automatycznie.

Instrukcja w języku naturalnym zastosowana do końcowej transkrypcji (maks. 2000 znaków). Edytowany tekst jest zwracany w ‘edited_transcript’ obok oryginalnej transkrypcji. Nie można łączyć z entity_detection, entity_redaction ani use_multi_channel. Użycie tego parametru wiąże się z dodatkową opłatą 30% podstawowego kosztu transkrypcji, naliczaną za co najmniej 10 sekund audio.

Czy oznaczać w transkrypcji zdarzenia audio, takie jak (śmiech), (kroki) itp.

Szczegółowość znaczników czasu w transkrypcji. „word” podaje znaczniki czasu na poziomie słów, a „character” — na poziomie znaków dla każdego słowa.

Czy oznaczać, który mówca aktualnie mówi w przesłanym pliku.

Próg diarizacji stosowany podczas diarizacji mówców. Wyższa wartość oznacza mniejsze prawdopodobieństwo, że jeden mówca zostanie rozpoznany jako dwóch różnych, ale większe prawdopodobieństwo, że dwóch różnych mówców zostanie rozpoznanych jako jeden (mniej przewidywanych mówców). Niska wartość oznacza większe prawdopodobieństwo, że jeden mówca zostanie rozpoznany jako dwóch różnych, ale mniejsze prawdopodobieństwo, że dwóch różnych mówców zostanie rozpoznanych jako jeden (więcej przewidywanych mówców). Można ustawić tylko, gdy diarize=True i num_speakers=None. Domyślnie None — wtedy wybieramy próg na podstawie model_id (zwykle 0.22).

Lista dodatkowych formatów eksportu transkrypcji.

The format of input audio. Options are ‘pcm_s16le_16’ or ‘other’ For pcm_s16le_16, the input audio must be 16-bit PCM at a 16kHz sample rate, single channel (mono), and little-endian byte order. Latency will be lower than with passing an encoded waveform.

[Wycofane] Ten parametr jest wycofany i zostanie usunięty w przyszłości. Zamiast niego użyj ‘source_url’. Adres HTTPS pliku do transkrypcji. Musisz podać dokładnie jeden z parametrów file lub cloud_storage_url. Plik musi być dostępny przez HTTPS i mieć mniej niż 2 GB. Akceptujemy każdy prawidłowy adres HTTPS, w tym adresy dostawców pamięci w chmurze (AWS S3, Google Cloud Storage, Cloudflare R2 itd.), CDN-ów i innych źródeł HTTPS. Adresy URL mogą być podpisane wstępnie lub zawierać tokeny uwierzytelniające w parametrach zapytania.

URL pliku audio lub wideo do transkrypcji. Obsługuje hostowane pliki wideo i audio, adresy URL filmów YouTube i TikTok oraz inne usługi hostingu wideo.

Czy wysyłać wynik transkrypcji do skonfigurowanych webhooków zamiany mowy na tekst. Jeśli ustawione, żądanie zwróci odpowiedź wcześniej bez transkrypcji, która zostanie dostarczona później przez webhook.

Opcjonalne ID konkretnego webhooka, na który ma zostać wysłany wynik transkrypcji. Działa tylko, gdy webhook ma wartość true. Jeśli nie zostanie podane, transkrypcja zostanie wysłana do wszystkich skonfigurowanych webhooków zamiany mowy na tekst.

Określa losowość wyniku transkrypcji. Przyjmuje wartości od 0.0 do 2.0, gdzie wyższe wartości dają bardziej zróżnicowane i mniej deterministyczne wyniki. Jeśli pominiesz tę opcję, użyjemy temperatury zależnej od wybranego modelu, zwykle 0.

Jeśli podano, nasz system dołoży starań, by generowanie było deterministyczne, więc powtarzane żądania z tym samym seedem i parametrami powinny zwracać ten sam wynik. Determinizm nie jest gwarantowany. Musi być liczbą całkowitą od 0 do 2147483647.

Czy plik audio zawiera wiele kanałów, z których każdy zawiera jednego mówcę. Po włączeniu każdy kanał jest transkrybowany niezależnie. Domyślnie dla każdego kanału zwracana jest osobna transkrypcja; ustaw multichannel_output_style=‘combined’, aby otrzymać jedną transkrypcję ze wszystkimi kanałami połączonymi i uporządkowanymi według czasu. Każde słowo w odpowiedzi zawiera pole ‘channel_index’, wskazujące kanał, na którym zostało wypowiedziane. Obsługiwanych jest maksymalnie 5 kanałów. Każdy kanał jest rozliczany niezależnie za pełny czas trwania audio, więc koszt rośnie liniowo wraz z liczbą kanałów.

Określa format odpowiedzi, gdy włączone jest use_multi_channel. ‘separate’ (domyślnie) zwraca jedną transkrypcję na kanał w polu ‘transcripts’. ‘combined’ łączy wszystkie kanały w jedną transkrypcję, której słowa są sortowane według czasu rozpoczęcia, a każde zawiera ‘channel_index’ — zgodnie z formatem odpowiedzi dla jednego kanału. ‘combined’ wymaga znaczników czasu (timestamps_granularity nie może mieć wartości ‘none’) i nie obsługuje wykrywania encji ani redakcji.

Opcjonalne metadane do uwzględnienia w odpowiedzi webhooka. Powinien to być ciąg JSON reprezentujący obiekt o maksymalnej głębokości 2 poziomów i rozmiarze do 16 KB. Przydatne do śledzenia wewnętrznych identyfikatorów, referencji zadań i innych informacji kontekstowych.

Wykrywa encje w transkrypcji. Może mieć wartość ‘all’, aby wykrywać wszystkie encje, pojedynczy typ encji lub kategorię albo listę typów encji/kategorii. Kategorie to ‘pii’, ‘phi’, ‘pci’, ‘other’, ‘offensive_language’. Po włączeniu wykryte encje zostaną zwrócone w polu ‘entities’ wraz z tekstem, typem i pozycjami znaków.

Jeśli ma wartość true, transkrypcja nie będzie zawierać wypełniaczy, fałszywych rozpoczęć ani dźwięków niemowy. Obsługiwane tylko przez model scribe_v2.

Czy używać biblioteki mówców do rozpoznawania znanych mówców podczas diarizacji. Gdy opcja jest włączona, a diarize ma wartość true, wykryci mówcy zostaną dopasowani do mówców zarejestrowanych w bibliotece mówców workspace.

Czy wykrywać role mówców (agent lub klient). Wymaga diarize=true. Nie można używać z use_multi_channel=true. Po włączeniu wartości speaker_id będą wynosić ‘agent’ i ‘customer’ zamiast ‘speaker_0’, ‘speaker_1’ itd. Użycie wiąże się z dodatkową opłatą 10% podstawowego kosztu transkrypcji.

Redaguje encje z tekstu transkrypcji. Akceptuje ten sam format co entity_detection: ‘all’, kategorię (‘pii’, ‘phi’) lub konkretne typy encji. Musi być podzbiorem entity_detection. Gdy redakcja jest włączona, pole entities nie zostanie zwrócone.

Jak formatować zredagowane encje. „redacted” zastępuje je przez {REDACTED}, „entity_type” przez {ENTITY_TYPE}, a „enumerated_entity_type” przez {ENTITY_TYPE_N}, gdzie N numeruje każde wystąpienie. Używane tylko, gdy ustawiono entity_redaction.

Lista kluczowych terminów, które pomogą ukierunkować transkrypcję. Terminy mogą być słowami lub frazami, które model ma rozpoznawać dokładniej. Liczba terminów nie może przekraczać 1000. Każdy termin musi mieć mniej niż 50 znaków. Termin może zawierać maksymalnie 5 słów (po normalizacji). Na przykład [“hello”, “world”, “technical term”]. Następujące znaki nie są obsługiwane: <, >, {, }, [, ], \. Użycie tego parametru wiąże się z dodatkową opłatą 20% podstawowego kosztu transkrypcji. Gdy podasz ponad 100 terminów, minimalny rozliczany czas na żądanie wynosi 20 sekund.