logo
Entwicklung
Suchen
Voice to Text

Voice to Text

Wandeln Sie eingehende Audiodateien per Spracherkennung in Text um – für effiziente Audio-zu-Text-Transkription.

Anfragemethode

POST

Anfrage-URL

https://api-${endpoint}.gptbots.ai/v1/audio-to-text

Authentifizierung der Anfrage

Bitte beachten Sie die Übersicht in der API-Referenz.

Anfrage

Beispielanfrage

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/audio-to-text' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: multipart/form-data' \ -F 'file=@/Pfad/zu/Ihrer/Audio/Datei.mp3'
                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/audio-to-text' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: multipart/form-data' \
-F 'file=@/Pfad/zu/Ihrer/Audio/Datei.mp3'

                    
Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld Typ Beschreibung
Authorization Bearer ${API Key} Verwenden Sie Authorization: Bearer ${API Key} zur Authentifizierung. Den API Key erhalten Sie auf der API-Key-Seite.
Content-Type multipart/form-data Datentyp, muss auf multipart/form-data gesetzt werden.

Anfrageparameter

Feld Typ Erforderlich Beschreibung
file Byte[] Ja Audiodatei, maximal 25 MB. Unterstützte Formate: m4a, mp3, webm, mp4, mpga, wav, mpeg

Antwort

Beispielantwort

{ "text": "Hallo, kann ich Ihnen irgendwie helfen?" }
                      
                      {
  "text": "Hallo, kann ich Ihnen irgendwie helfen?"
}

                    
Dieser Codeblock im schwebenden Fenster

Erfolgsantwort

Feld Typ Beschreibung
text string Erkannter Text.

Fehlerantwort

Feld Typ Beschreibung
code int Fehlercode.
message string Fehlerdetails.

Fehlercodes

Code Nachricht
40000 Ungültiger Parameter
40127 Entwicklerauthentifizierung fehlgeschlagen
40325 Ungültiger Dateityp, nur „m4a“, „mp3“, „webm“, „mp4“, „mpga“, „wav“, „mpeg“ werden unterstützt
50000 Interner Serverfehler
20059 Bot gelöscht
200116 Multi-modale Spracheingabe ist nicht aktiviert
40353 Die Funktion ist nur nach einem Upgrade des Pakets verfügbar.
40326 Beschränkt auf 25 MB
20022 Guthaben nicht ausreichend