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/transcribeHı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
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
file | File | Yes | Deşifre edilecek medya dosyası (Multipart). Desteklenenler: Video (mp4, mov, avi, webm, mkv), Ses (mp3, wav, m4a, flac). Maks 2GB. |
videoUrl | String | No* | Medyanın harici URL'si (gövdede dosya sağlanmamışsa gereklidir). |
name | String | No | Proje için özel isim. |
languageCode | String | No | Kaynak dil kodu (örn. 'tr-tr'). Atlanırsa varsayılan 'auto' (otomatik algılama) olur. |
filterProfanity | Boolean | No | Küfürlü kelimelerin otomatik olarak sansürlenip sansürlenmeyeceği. Varsayılan false. |
disfluencies | Boolean | No | Dolgu kelimelerin (örn. 'ee', 'ıı') dahil edilip edilmeyeceği. Varsayılan false. |
medicalMode | Boolean | No | Sağ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ı
| Durum | Hata Kodu | Açıklama |
|---|---|---|
| 400 | missing_file | 'file' veya 'video' alanında dosya bulunamadı. |
| 400 | unreachable_url | Sağlanan videoUrl'ye ulaşılamıyor veya bir hata döndürdü. |
| 400 | invalid_parameter | Parametrelerden biri (örn. videoUrl) hatalı biçimlendirilmiş. |
| 400 | file_read_failed | Yüklenen dosya okunamadı veya bozuk. |
| 401 | unauthorized | API Anahtarı eksik veya geçersiz. |
| 403 | insufficient_balance | Bu medya süresini işlemek için yeterli krediniz yok. |
| 403 | storage_quota_exceeded | Dosya, planınızın kalan bulut depolama kotasını aşıyor. |
| 413 | payload_too_large | Dosya, sistemin mutlak 2GB yükleme sınırını aşıyor. |
| 500 | transcription_failed | Deşifre işi başlatılamadı (AI sağlayıcı kesintisi). |
| 500 | server_error | Bir ş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?