AI Analiz
Bu doküman, harici sistemlerden ses dosyalarının yüklenmesi ve metne dönüştürülmesi (transkripsiyon) işlemi için kullanılan API uç noktasını tarif eder.
1. Genel Bilgiler
Bu servis, multipart/form-data formatında gönderilen ses kayıtlarını ve çağrı detaylarını kabul eder. Yüklenen dosyalar işleme sırasına alınır ve metne dönüştürülür.
- URL: https://ai.sanalsantral.com.tr/api/transcribe
- Method:
POST - Content-Type:
multipart/form-data
2. Kimlik Doğrulama
API kullanımı için size sağlanan company_id ve api_key bilgilerini her istekte göndermeniz gerekmektedir.
3. Parametreler
Aşağıdaki parametreler form-data gövdesi (body) içerisinde gönderilmelidir.
| Parametre | Tip | Zorunluluk | Açıklama |
|---|---|---|---|
| file | File | Zorunlu | Yüklenecek ses dosyası. (Örn: .wav, .mp3) |
| company_id | Number | Zorunlu | Şirket ID'niz. |
| api_key | String | Zorunlu | Size özel tanımlanmış API anahtarı. |
| sure | Number | Zorunlu | Çağrının saniye cinsinden süresi. |
| baslangic_zamani | String | Opsiyonel | Çağrının başlangıç tarihi/zamanı (ISO formatı önerilir). |
| src | String | Opsiyonel | Arayan numara bilgisi. |
| dst | String | Opsiyonel | Aranan numara bilgisi. |
| metadata | String | Opsiyonel | Çağrı ile ilgili ek JSON verisi veya notlar. |
4. Örnek cURL İsteği
Aşağıdaki örnekte audio.wav dosyasının API'ye nasıl gönderileceği gösterilmiştir.
curl --location 'https://api.sanalsantral.com.tr/api/transcribe' \
--header 'Content-Type: multipart/form-data' \
--form 'file=@"/path/to/your/audio.wav"' \
--form 'company_id="12345"' \
--form 'api_key="test_123456789"' \
--form 'src="05551112233"' \
--form 'dst="02123334455"' \
--form 'sure="120"' \
--form 'baslangic_zamani="2026-01-05T14:30:00"'