SRTGen.com LogoSRTGen.com

Deşifre API'si

AI deşifresi ve proje oluşturma için medya gönderin. Hem Video hem de Ses dosyalarını destekler.

POST/api/v1/transcribe
Hızlı Uygulama
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

İstek Parametreleri

ParametreTürGerekliAçıklama
fileFileYes

Deşifre edilecek medya dosyası (Multipart).

Desteklenenler: Video (mp4, mov, avi, webm, mkv), Ses (mp3, wav, m4a, flac). Maks 2GB.

videoUrlStringNo*Medyanın harici URL'si (gövdede dosya sağlanmamışsa gereklidir).
nameStringNoProje için özel isim.
languageCodeStringNo

Kaynak dil kodu (örn. 'tr-tr'). Atlanırsa varsayılan 'auto' (otomatik algılama) olur.

filterProfanityBooleanNoKüfürlü kelimelerin otomatik olarak sansürlenip sansürlenmeyeceği. Varsayılan false.
disfluenciesBooleanNoDolgu kelimelerin (örn. 'ee', 'ıı') dahil edilip edilmeyeceği. Varsayılan false.
medicalModeBooleanNoSağlık/tıbbi sesler için optimize edilmiş deşifre. Varsayılan false.
Gelişmiş: URL + AI Ayarları
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

Başarı Yanıtı

Başarılı bir istek, proje ve arka plan işi detaylarıyla birlikte 200 OK durumu döndürür.

  • projectIdProjeniz için benzersiz tanımlayıcı.
  • status'inProgress' (deşifre devam ediyor).
  • Not: Krediler, deşifre işlemi kesinleştikten sonra bakiyenizden asenkron olarak hesaplanır ve düşülür.
{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

Hata Kodları

DurumHata KoduAçıklama
400missing_file'file' veya 'video' alanında dosya bulunamadı.
400unreachable_urlSağlanan videoUrl'ye ulaşılamıyor veya bir hata döndürdü.
400invalid_parameterParametrelerden biri (örn. videoUrl) hatalı biçimlendirilmiş.
400file_read_failedYüklenen dosya okunamadı veya bozuk.
401unauthorizedAPI Anahtarı eksik veya geçersiz.
403insufficient_balanceBu medya süresini işlemek için yeterli krediniz yok.
403storage_quota_exceededDosya, planınızın kalan bulut depolama kotasını aşıyor.
413payload_too_largeDosya, sistemin mutlak 2GB yükleme sınırını aşıyor.
500transcription_failedDeşifre işi başlatılamadı (AI sağlayıcı kesintisi).
500server_errorBir şeyler ters gitti, lütfen daha sonra tekrar deneyin.
Hata Yanıt Yapısı
{
  "success": false,
  "error": "insufficient_balance",
  "message": "Projeniz 5 kredi gerektiriyor ancak bakiyeniz 2."
}
bu sayfa yardımcı oldu mu?
Deşifre API'si | SRTGen.com