OpenAI: GPT Transcribe
GPT Transcribe wandelt aufgezeichnete Sprache in Text in der Originalsprache um und unterstützt Kontext-Prompts, Hinweise mit wörtlichen Schlüsselbegriffen sowie Hinweise auf mehrere Sprachen. OpenAI dokumentiert die Transkription abgeschlossener Dateien, gestreamte Dateiergebnisse und die Transkription nach bestätigten Audiobeiträgen in Realtime.
Ü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.
GPT Transcribe ist OpenAIs Spracherkennungsmodell mit Textausgabe für abgeschlossene Audiodateien, gestreamte Dateitranskripte und bestätigte Audiobeiträge in Realtime-Sitzungen. Es nimmt Audio mit optionalem Textkontext entgegen und gibt erkannten Text zurück. Der Hersteller positioniert es für die genaue Transkription aufgezeichneter Sprache in ihrer Originalsprache, einschliesslich Fachvokabular, mehrsprachiger Aufnahmen und Sprachwechsel. Das nützliche Ergebnis ist ein mit der Aufnahme verknüpftes Transkript, ergänzt um Metadaten zur erkannten Sprache, wenn das Modell eine zuverlässige Vorhersage treffen kann.
Eine abgeschlossene Aufnahme vorbereiten
OpenAIs Ablauf zur Dateitranskription akzeptiert Uploads bis zu 25 MB. Die aktuelle Endpunktreferenz nennt die Eingabeformate FLAC, MP3, MP4, MPEG, MPGA, M4A, OGG, WAV und WebM. Sie empfiehlt ausreichende Dateimetadaten zur Formaterkennung, einschliesslich einer passenden Dateinamenserweiterung und eines Inhaltstyps. Für eine grössere Aufnahme empfiehlt der Leitfaden eine Komprimierung oder Aufteilung in Dateien von höchstens 25 MB. Schneiden Sie nicht mitten im Satz, weil fehlende umgebende Sprache die Erkennung ungenauer machen kann. Bewahren Sie die Reihenfolge der Teile und ihre Positionen in der Originalaufnahme.
Stellen Sie für eine Besprechung, ein Interview oder eine aufgezeichnete Präsentation das tatsächliche Audio bereit und benennen Sie das Thema sowie voraussichtlich gesprochene Fachbegriffe. Ein nützliches Ergebnis ist der erkannte Wortlaut statt einer erschlossenen Zusammenfassung des Gesprächs. Bewahren Sie die Kennung der Aufnahme zusammen mit dem zurückgegebenen Text, damit jemand bei der Prüfung eines Namens, einer Zahl oder einer unsicheren Formulierung zur richtigen Quelle zurückkehren kann. Ein Transkript kann anschliessend als Material für einen separaten Zusammenfassungs-, Übersetzungs- oder Redaktionsablauf dienen.
Kontext, Schlüsselbegriffhinweise und erwartete Sprachen
Der Hersteller unterscheidet drei Arten von Hinweisen. Ein Prompt liefert frei formulierten Kontext zum Thema oder zur Situation der Aufnahme. Schlüsselbegriffe nennen wörtlich erwartete Wörter oder Ausdrücke. Eine Sprachenliste bezeichnet die erwarteten gesprochenen Sprachen. Beschreiben Sie bei einem zweisprachigen Produktgespräch die Situation im Prompt, führen Sie die relevanten Produktnamen als Schlüsselbegriffe auf und geben Sie die erwarteten Sprachen an. Dies sind Erkennungshinweise, keine Anweisungen, Vokabular einzufügen, das niemand gesprochen hat.
GPT Transcribe verwendet das Feld languages im Plural statt des älteren Felds language im Singular; laut OpenAI dürfen nicht beide gesendet werden. Der Leitfaden akzeptiert unterstützte ISO 639-1-Codes, ausgewählte ISO 639-3-Codes und regionale chinesische Locale-Codes. Nicht unterstützte oder fehlerhaft formatierte Werte werden abgewiesen. Jeder Schlüsselbegriff muss in einer einzigen Zeile bleiben und darf weder eine spitze Klammer noch einen Wagenrücklauf oder Zeilenvorschub enthalten. Ein ungültiger Schlüsselbegriff oder ein zu langer Prompt kann zur Ablehnung der gesamten Anfrage führen. Halten Sie den Kontext relevant und prüfen Sie, ob die als Hinweis genannten Namen tatsächlich im Audio vorkommen, statt die Hinweisliste als Transkript zu behandeln.
JSON-Ausgabe und Vorhersagen erkannter Sprachen
Das dokumentierte Dateiergebnis ist JSON mit dem Transkript und den erkannten Sprachen. Diese Sprachvorhersagen sind eine Modellausgabe und keine Kopie der bereitgestellten Sprachhinweise. Eine leere Sprachenliste ist ein gültiges Ergebnis, wenn das Modell keine zuverlässige Vorhersage treffen kann; sie belegt weder eine stille Aufnahme noch eine fehlgeschlagene Transkription. Halten Sie den erkannten Text und die Sprachmetadaten getrennt, damit nachfolgende Verarbeitungsschritte beides seiner jeweiligen Bedeutung entsprechend nutzen können.
Ein Dateitranskript streamen
Eine abgeschlossene Datei kann während ihrer Verarbeitung schrittweise Transkripttext liefern. OpenAI dokumentiert Ereignisse vom Typ transcript.text.delta für Teiltext und transcript.text.done für das vollständige Dateitranskript; das abschliessende Ereignis enthält ausserdem erkannte Sprachen. Dabei wird die Ausgabe einer bereits bereitgestellten Aufnahme gestreamt. Dies eignet sich zur Fortschrittsanzeige bei einem langen Upload, während das abschliessende Ereignis den Text festlegt, der als vollständiges Ergebnis bewahrt werden soll.
Bestätigte Audiobeiträge in Realtime-Sitzungen
GPT Transcribe besitzt ausserdem einen spezialisierten Realtime-Ablauf über WebSocket. Audio wird an den Eingabepuffer angehängt, anschliessend bestätigt die Anwendung ausdrücklich einen Audiobeitrag. Die Transkription beginnt für diesen bestätigten Block und kann vor dem Abschlussereignis Textänderungen ausgeben, einschliesslich Informationen zur erkannten Sprache. In diesem Sitzungsablauf des Herstellers nutzt das Modell frühere transkribierte Beiträge automatisch als Kontext. Das unterscheidet sich davon, fortlaufend Live-Untertitel auszugeben, während Mikrofon-Audio eingeht; OpenAI nennt für diesen kontinuierlichen Ablauf GPT Live Transcribe.
Bewahren Sie bei mehreren Beiträgen die Kennung des Eingabeelements zusammen mit dem zugehörigen Transkript. OpenAI weist darauf hin, dass Abschlussereignisse verschiedener Beiträge nicht in der Reihenfolge des Gesprochenen eintreffen müssen. Ordnen Sie daher jedes Endergebnis seiner bestätigten Eingabe zu, statt ein Gespräch allein nach Abschlusszeiten anzuordnen. Das nützliche Ergebnis ist ein geordnetes Transkript aus den richtigen abschliessenden Elementen. Zwischenstände gelten als Fortschritt und nicht als separate abgeschlossene Äusserung.
Spezialisierte Ausgaben und wesentliche Grenzen
Dieses Profil legt keinen universellen Ausgabeumfang für Untertitel, Zeitstempel, Übersetzung oder Sprecherkennzeichnungen fest. OpenAIs Migrationsleitfaden unterscheidet diese spezialisierten Funktionen: Native Untertitelformate und Zeitangaben für einzelne Wörter benötigen ein kompatibles Modell und Format, während Sprecherkennzeichnungen GPT-4o Transcribe Diarize verwenden. Das Dateiergebnis von GPT Transcribe ist JSON und kein direkter Ersatz für eine Antwort im SRT- oder VTT-Format oder eine Antwort mit ausführlichen Zeitstempeln. Seine genaue Modellkarte veröffentlicht keine zahlenmässige Kontext- oder Maximalausgabegrenze. Ein Tokenfenster eines Chatmodells darf deshalb nicht für die Audiotranskription vorausgesetzt werden.
Prüfen Sie schwieriges Vokabular, Zahlen, Akzente, Hintergrundgeräusche und Sprachwechsel anhand der Aufnahme. Prüfen Sie, ob relevante Hinweise die Erkennung verbessert haben, ohne ungesprochene Begriffe einzuführen, und ob das abschliessende Transkript das Ende des Audios enthält. Bewahren Sie bei einem mehrsprachigen Ergebnis den gesprochenen Wortlaut, bevor Sie eine übersetzte Fassung erstellen. Diese Prüfungen machen das Transkript als Quellenmaterial nützlich und halten dabei Kontexthinweise, erkannte Sprachen und den tatsächlich erkannten Wortlaut klar auseinander.
Ailoot Ultra · Transkription POST /v1/audio/transcriptions openai/gpt-transcribe
openai/gpt-transcribeEinstieg
GPT Transcribe wandelt aufgezeichnete Sprache in Text in der Originalsprache um und unterstützt Kontext-Prompts, Hinweise mit wörtlichen Schlüsselbegriffen sowie Hinweise auf mehrere Sprachen. OpenAI dokumentiert die Transkription abgeschlossener Dateien, gestreamte Dateiergebnisse und die Transkription nach bestätigten Audiobeiträgen in Realtime.
- 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 openai/gpt-transcribe | 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.00015 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': '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.
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 openai/gpt-transcribe
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · OpenAI: GPT Transcribe
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/audio/transcriptions·openai/gpt-transcribe:audio→text- Welche Felder verwendet die Anfrage?
POST /v1/audio/transcriptions·openai/gpt-transcribe:model,input_audio