Transcribe API

Reichen Sie Medien für die KI-Transkription und Projekterstellung ein. Unterstützt sowohl Video- als auch Audio- Dateien.

POST/api/v1/transcribe

Schnelle Implementierung

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

Anfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`file`	File	Yes	Die zu transkribierende Mediendatei (Multipart). Unterstützt: Video (mp4, mov, avi, webm, mkv), Audio (mp3, wav, m4a, flac). Max. 2 GB.
`videoUrl`	String	No*	Externe URL des Mediums (erforderlich, wenn keine Datei im Body gesendet wird).
`name`	String	No	Benutzerdefinierter Name für das Projekt.
`languageCode`	String	No	Quellsprachcode (z. B. 'en-us'). Standardmäßig 'auto' (automatische Erkennung), wenn weggelassen.
`filterProfanity`	Boolean	No	Gibt an, ob Schimpfwörter automatisch zensiert werden sollen. Standard ist false.
`disfluencies`	Boolean	No	Gibt an, ob Füllwörter (z. B. 'äh', 'ähm') enthalten sein sollen. Standard ist false.
`medicalMode`	Boolean	No	Optimierte Transkription für medizinische Audioinhalte. Standard ist false.

Fortgeschritten: URL + KI-Einstellungen

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

Erfolgsantwort

Eine erfolgreiche Anfrage gibt den Status 200 OK mit dem Projekt und den Details zum Hintergrundjob zurück.

projectIdDie eindeutige ID für Ihr Projekt.
status'inProgress' (Transkription läuft).
Hinweis: Credits werden asynchron berechnet und von Ihrem Guthaben abgezogen, nachdem der Transkriptionsprozess abgeschlossen ist.

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

Fehlercodes

Status	Fehlercode	Beschreibung
400	missing_file	Keine Datei im Feld 'file' oder 'video' gefunden.
400	unreachable_url	Die angegebene videoUrl ist nicht erreichbar oder gab einen Fehler zurück.
400	invalid_parameter	Einer der Parameter (z. B. videoUrl) ist fehlerhaft.
400	file_read_failed	Die hochgeladene Datei konnte nicht gelesen werden oder ist beschädigt.
401	unauthorized	API-Key fehlt oder ist ungültig.
403	insufficient_balance	Sie haben nicht genügend Credits für die Verarbeitung dieser Mediendauer.
403	storage_quota_exceeded	Die Datei überschreitet das verbleibende Cloud-Speicherkontingent Ihres Plans.
413	payload_too_large	Die Datei überschreitet das absolute Systemlimit von 2 GB.
500	transcription_failed	Der Transkriptionsjob konnte nicht gestartet werden (KI-Anbieter offline).
500	server_error	Etwas ist schiefgelaufen, bitte versuchen Sie es später erneut.

Fehler-Antwortstruktur

{
  "success": false,
  "error": "insufficient_balance",
  "message": "Ihr Projekt benötigt 5 Credits, aber Ihr Guthaben beträgt 2."
}

War diese Seite hilfreich?

Transkribieren

Anfrageparameter

Erfolgsantwort

Fehlercodes