Transkription erstellen
Transkribiert Audio in Text. Kompatibel mit der OpenAI /v1/audio/transcriptions API.
Akzeptiert eine Audiodatei (max. 25 MB) als multipart/form-data und gibt das Transkript im angeforderten response_format zurück. Tauschen Sie den model-String aus, um das Modell zu wechseln; verwenden Sie /v2/models/all, um Audio-Transkriptionsmodelle zu entdecken.
Sprechertrennung. Modelle, bei denen supports_diarization in /v2/models/all true ist, trennen Sprecher: Senden Sie diarize=true (optional num_speakers als Obergrenze) mit response_format=verbose_json, dann enthält die Antwort ein segments-Array mit Sprecherabschnitten. Sprecher heißen auf jedem Modell speaker_0, speaker_1, … in der Reihenfolge ihres ersten Auftretens. words (Wort-Zeitstempel) kommen hinzu, wo das Modell Wortzeiten liefert; ein Modell, das nur Sprecherabschnitte liefert, gibt segments ohne words zurück. Bei einem Modell ohne Sprechertrennung wird diarize ignoriert. timestamps_granularity, tag_audio_events und temperature sind ElevenLabs-Scribe-Optionen. Die Formate json/text geben stets nur das reine Transkript zurück. Untertitelformate wie srt und vtt werden nicht unterstützt.
Beispielaufruf
curl https://api.deutschlandgpt.de/v2/audio/transcriptions \
-X POST \
-H "Authorization: Bearer $DGPT_API_KEY"curl https://api.deutschlandgpt.de/v2/audio/transcriptions \
-X POST \
-H "Authorization: Bearer $DGPT_API_KEY"import os, requests
response = requests.post(
"https://api.deutschlandgpt.de/v2/audio/transcriptions",
headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)
print(response.json())import os, requests
response = requests.post(
"https://api.deutschlandgpt.de/v2/audio/transcriptions",
headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)
print(response.json())const response = await fetch('https://api.deutschlandgpt.de/v2/audio/transcriptions', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
},
});
console.log(await response.json());const response = await fetch('https://api.deutschlandgpt.de/v2/audio/transcriptions', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
},
});
console.log(await response.json());Antwort
{
"text": "string"
}{
"text": "string"
}Transkriptionsergebnis. Der Medientyp hängt von response_format ab.
Ebenfalls verfügbar als text/plain
Die Antwort hat eine der folgenden Formen:
Variante 1
Wird zurückgegeben, wenn response_format json ist (Standard).
textstringerforderlichDer transkribierte Text.
Variante 2
Wird zurückgegeben, wenn response_format verbose_json ist. words und segments erscheinen nur auf dem ElevenLabs-Scribe-Pfad.
textstringerforderlichDer transkribierte Text.
wordsobject[]optionalWort-Zeitstempel. Vorhanden, wo das Modell Wortzeiten liefert (ElevenLabs Scribe, außer bei timestamps_granularity none; andere Modelle mit Sprechertrennung bei diarize=true). Für ein Modell, das nur Sprecherabschnitte liefert, werden keine erfunden.
wordstringerforderlichDas transkribierte Wort oder Geräusch.
startnumberoptionalStartzeit des Tokens in Sekunden.
endnumberoptionalEndzeit des Tokens in Sekunden.
typestringerforderlichToken-Typ. audio_event markiert nicht-sprachliche Geräusche wie Lachen (siehe tag_audio_events).
speakerstringoptionalKennung des Sprechers dieses Tokens. Nur vorhanden, wenn diarize=true.
segmentsobject[]optionalSprecherabschnitte: zusammenhängende Rede eines Sprechers, mit start/end in Sekunden. Vorhanden, wenn diarize=true auf einem Modell lief, bei dem supports_diarization true ist.
speakerstringoptionalKennung des Sprechers dieses Abschnitts.
textstringerforderlichDer in diesem Abschnitt gesprochene Text.
startnumberoptionalStartzeit des Abschnitts in Sekunden.
endnumberoptionalEndzeit des Abschnitts in Sekunden.
usageobjecterforderlichaudioSecondsnumbererforderlichDauer des Eingangsaudios in Sekunden, wie vom Provider gemeldet.
costInEuronumbererforderlichVom Workspace-Guthaben für diese Anfrage abgezogener Betrag in EUR.
Antwort-Header
X-Request-IDstringEindeutige Anfrage-ID (req_<id>). In Support-Tickets angeben.
Statuscodes
Transkriptionsergebnis. Der Medientyp hängt von response_format ab.
Ungültige Anfrage — fehlende file, Datei überschreitet 25 MB oder Provider-Fehler.
Nicht autorisiert — fehlender oder ungültiger API-Key.
Nicht genügend Guthaben.
API-Key hat keine Berechtigung für dieses Modell.
Modell nicht gefunden oder für diesen Workspace nicht konfiguriert.
Serverfehler.