OpenAI: GPT Transcribe
GPT Transcribe zamienia nagraną mowę na tekst w jej oryginalnym języku, z promptami kontekstowymi, dosłownymi podpowiedziami słów kluczowych i wskazaniem wielu języków. OpenAI dokumentuje transkrypcję gotowych plików, strumieniowane wyniki pliku i transkrypcję po zatwierdzeniu tur audio Realtime.
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.
GPT Transcribe to model OpenAI zamieniający mowę na tekst dla ukończonych plików audio, strumieniowanych transkrypcji plików i zatwierdzonych tur audio w sesjach Realtime. Przyjmuje audio z opcjonalnym kontekstem tekstowym i zwraca rozpoznany tekst. Producent przeznacza go do dokładnej transkrypcji nagranej mowy w oryginalnym języku, w tym słownictwa dziedzinowego, nagrań wielojęzycznych i przełączania języków. Przydatnym wyjściem jest transkrypcja powiązana z nagraniem, z metadanymi wykrytych języków, gdy model potrafi przewidzieć je wiarygodnie.
Przygotowanie ukończonego nagrania
Przepływ transkrypcji plików OpenAI przyjmuje pliki do 25 MB. Aktualny opis punktu końcowego wymienia formaty wejściowe FLAC, MP3, MP4, MPEG, MPGA, M4A, OGG, WAV i WebM oraz zaleca metadane wystarczające do rozpoznania formatu, w tym odpowiednie rozszerzenie nazwy pliku i typ zawartości. Dla większego nagrania poradnik zaleca kompresję lub podział na pliki po 25 MB lub mniej. Unikaj przecinania zdania, ponieważ usunięcie otaczającej mowy może zmniejszyć dokładność rozpoznawania. Zachowaj kolejność części i ich pozycje w oryginalnym nagraniu.
Dla spotkania, wywiadu lub nagranej prezentacji dostarcz rzeczywiste audio i określ temat oraz terminologię, która może paść. Przydatnym wynikiem jest rozpoznane brzmienie wypowiedzi, a nie wywnioskowane podsumowanie dyskusji. Zachowaj identyfikator nagrania przy zwróconym tekście, aby osoba sprawdzająca nazwę, liczbę lub niepewną frazę mogła wrócić do właściwego źródła. Transkrypcja może następnie służyć jako materiał do osobnego podsumowania, tłumaczenia lub pracy redakcyjnej.
Kontekst, słowa kluczowe i oczekiwane języki
Producent rozróżnia trzy rodzaje wskazówek. Prompt dostarcza swobodnego kontekstu o temacie lub okolicznościach nagrania. Słowa kluczowe podają dosłowne wyrazy lub frazy oczekiwane w mowie. Lista languages określa spodziewane języki wypowiedzi. W dwujęzycznej dyskusji o produkcie opisz sytuację w prompcie, podaj odpowiednie nazwy produktów jako słowa kluczowe i wskaż oczekiwane języki. Są to podpowiedzi dla rozpoznawania, a nie polecenia wstawiania słownictwa, którego nikt nie wypowiedział.
GPT Transcribe używa pola languages w liczbie mnogiej zamiast starszego pola language w liczbie pojedynczej; OpenAI podaje, że nie należy wysyłać obu. Poradnik przyjmuje obsługiwane kody ISO 639-1, wybrane kody ISO 639-3 oraz regionalne chińskie kody lokalizacji, odrzucając wartości nieobsługiwane lub niepoprawnie zapisane. Każde słowo kluczowe musi mieścić się w jednym wierszu i nie może zawierać nawiasu ostrokątnego, znaku powrotu karetki ani znaku nowego wiersza. Nieprawidłowe słowo kluczowe lub zbyt długi prompt mogą spowodować odrzucenie całego żądania. Zachowaj istotny kontekst i sprawdź, czy sugerowane nazwy rzeczywiście występują w audio, zamiast traktować listę podpowiedzi jako transkrypcję.
Wyjście JSON i przewidywania wykrytych języków
Udokumentowany wynik pliku ma postać JSON zawierającą transkrypcję i wykryte języki. Te przewidywania językowe są wyjściem modelu, a nie kopią dostarczonych podpowiedzi językowych. Pusta lista języków jest poprawnym wynikiem, gdy model nie potrafi dokonać wiarygodnego rozpoznania; nie dowodzi ciszy w nagraniu ani niepowodzenia transkrypcji. Przechowuj rozpoznany tekst i metadane językowe oddzielnie, aby dalsze przetwarzanie mogło używać każdego elementu zgodnie z jego znaczeniem.
Strumieniowanie transkrypcji pliku
Ukończony plik może podczas przetwarzania zwracać tekst transkrypcji stopniowo. OpenAI dokumentuje zdarzenia transcript.text.delta dla częściowego tekstu oraz transcript.text.done dla pełnej transkrypcji pliku; zdarzenie końcowe zawiera również wykryte języki. Strumieniowane jest tu wyjście już dostarczonego nagrania. Przydaje się to do wyświetlania postępu przy długim przesłanym pliku, podczas gdy zdarzenie końcowe ustala tekst do zachowania jako ukończony wynik.
Zatwierdzone tury w sesjach Realtime
GPT Transcribe ma również wyspecjalizowany przepływ Realtime przez WebSocket. Audio jest dopisywane do bufora wejściowego, po czym aplikacja jawnie zatwierdza turę audio. Transkrypcja zaczyna się dla tego zatwierdzonego fragmentu i może emitować przyrosty tekstu przed zdarzeniem zakończenia, z informacjami o wykrytych językach. Model automatycznie wykorzystuje wcześniejsze przepisane tury jako kontekst w tym przepływie sesji producenta. Różni się to od ciągłego emitowania tekstu napisów na żywo podczas napływu audio z mikrofonu; OpenAI nazywa ten ciągły przepływ GPT Live Transcribe.
Dla kilku tur zachowaj identyfikator elementu wejściowego przy odpowiedniej transkrypcji. OpenAI ostrzega, że zdarzenia zakończenia różnych tur nie muszą przychodzić w kolejności wypowiedzi, więc przypisuj każdy końcowy wynik do jego zatwierdzonego wejścia zamiast układać rozmowę wyłącznie według czasu zakończenia. Przydatnym artefaktem jest uporządkowana transkrypcja złożona z właściwych końcowych elementów, w której tekst pośredni oznacza postęp, a nie osobną ukończoną wypowiedź.
Wyspecjalizowane wyjścia i istotne ograniczenia
Ten profil nie zapewnia uniwersalnego kontraktu napisów, znaczników czasu, tłumaczenia ani etykiet mówców. Poradnik migracji OpenAI rozróżnia te wyspecjalizowane możliwości: natywne formaty napisów i czas poszczególnych słów wymagają zgodnego modelu i formatu, natomiast etykiety mówców korzystają z GPT-4o Transcribe Diarize. Wynik pliku GPT Transcribe to JSON, który nie zastępuje bezpośrednio SRT, VTT ani odpowiedzi z rozbudowanymi znacznikami czasu. Dokładna karta modelu nie publikuje liczbowego limitu kontekstu ani maksymalnego wyjścia, więc nie należy zakładać okna tokenów modelu czatowego dla transkrypcji audio.
Sprawdź trudne słownictwo, liczby, akcenty, szum tła i zmiany języka względem nagrania. Upewnij się, że istotne podpowiedzi poprawiły rozpoznawanie bez wprowadzania niewypowiedzianych terminów i że końcowa transkrypcja obejmuje koniec audio. W wyniku wielojęzycznym zachowaj wypowiedziane słowa przed przygotowaniem tłumaczenia. Te kontrole sprawiają, że transkrypcja nadaje się na materiał źródłowy, jednocześnie jasno oddzielając wskazówki kontekstowe, wykryte języki i rozpoznaną mowę.
Ailoot Ultra · Transkrypcja POST /v1/audio/transcriptions openai/gpt-transcribe
openai/gpt-transcribeStart
GPT Transcribe zamienia nagraną mowę na tekst w jej oryginalnym języku, z promptami kontekstowymi, dosłownymi podpowiedziami słów kluczowych i wskazaniem wielu języków. OpenAI dokumentuje transkrypcję gotowych plików, strumieniowane wyniki pliku i transkrypcję po zatwierdzeniu tur audio Realtime.
- 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 openai/gpt-transcribe | 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.00015 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': 'openai/gpt-transcribe', '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 openai/gpt-transcribe
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · OpenAI: GPT Transcribe
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/audio/transcriptions·openai/gpt-transcribe:audio→text- Jakich pól używa żądanie?
POST /v1/audio/transcriptions·openai/gpt-transcribe:model,input_audio