Transkripsiyon API'si | speech to text API
Transkripsiyon ve yapay zeka analizi — tek API isteğinde
Dosyayı tek POST ile gönder — yanıtta konuşmacılara ayrılmış metin ve kendi şablonuna göre yapay zeka raporu gelir.
POST /transcriptions?reports=summary
curl -X POST "https://app.specala.ai/api/v1/developer/transcriptions?reports=summary" \-H "Authorization: Bearer sk_live_…" \-H 'Content-Disposition: attachment; filename="call-48213.mp3"' \-H "X-External-Id: deal-48213" \--data-binary @call-48213.mp3Yanıtcompleted1 dk 34 sn
{"status": "completed","language": "tr","duration_seconds": 1384.2,"segments": [{ "start": 0.0, "speaker_name": "Konuşmacı 1","text": "Merhaba Jennifer, ben Crumbwell'den Marcus." },{ "start": 6.9, "speaker_name": "Konuşmacı 2","text": "Merhaba. Kafemiz için bir deneme teslimatı istiyoruz." },{ "start": 13.1, "speaker_name": "Konuşmacı 1","text": "Numuneleri perşembe, fiyat listesini bugün gönderiyoruz." }],"prompt_results": [{ "slug": "summary", "status": "completed","text": "Kafe, deneme teslimatı: numuneler perşembe, fiyat listesi bugün." }]}Çağrı raporu
Özet
- Müşteri bir kafe, deneme teslimatı istiyor.
- Anlaşılan: numuneler perşembe, fiyat listesi bugün.
Görevler
- İki kutu numune gönder
- Fiyat listesini gönder
- Pazartesi ara
- 2 GB
- tek istekte dosya
- 10 sa
- kayıt başına
- 99
- dil, otomatik algılanır
- ~4 dk
- bir saatlik ses için
- 73
- ses ve video formatı
CRM ve telefon sistemi
Call transcription API: santralden fırsat kartına
Kayıtla birlikte CRM'inden ya da santralinden fırsat numarasını, kendi alanlarını ve temsilcinin ID'sini gönder — analiz bunlara bağlı olarak döner.
01 | Santralin ya da CRM'in
Çağrı bitti, kayıt hazır
call-48213.mp323:04 | 21.4 MB02 | İstek
Dosya, fırsat numarası ve temsilciyle birlikte gider
POST /transcriptions?reports=call-checklistX-External-Id: deal-48213X-Author: external:hubspot:172903 | Yanıt
Konuşmacılara ayrılmış metin
"status": "completed","external_id": "deal-48213","segments": [ … ]04 | Yanıt
Kontrol listene göre bir rapor
"slug": "call-checklist","text": "İhtiyacı belirledi: evet\nFiyatı söyledi: hayır"05 | Senin kodun
Analiz fırsat kartına düşer
GET /transcriptions?external_id=deal-48213# fırsatın tüm çağrıları tek istekte
Zaten kullandığın CRM'e ve telefon sistemine uyar
HubSpot
Salesforce
Pipedrive
Twilio
Aircall
RingCentral- API'si olan her sistem
CRM bağlantısı
Her çağrı fırsatını ve temsilcisini bilir
Aynı istekte üç başlık, ve kayıt ilk saniyeden CRM'ine bağlanır: onu fırsat numarasıyla bulursun, kendi alanlarına göre filtrelersin ve doğru temsilciye düşer.
İstek
curl -X POST "https://app.specala.ai/api/v1/developer/transcriptions?reports=call-checklist" \-H "Authorization: Bearer sk_live_…" \-H 'Content-Disposition: attachment; filename="call-48213.mp3"' \-H "X-External-Id: deal-48213" \-H 'X-Metadata: {"pipeline":"b2b","source":"aircall"}' \-H "X-Author: external:hubspot:1729" \--data-binary @call-48213.mp3Yanıt
{"status": "completed","external_id": "deal-48213","metadata": { "pipeline": "b2b", "source": "aircall" },"author": { "id": "9c2d4e6f-…", "name": "Marcus" }}Uygulama
Yönetim paneli yazmana gerek yok
API ile yüklenen her şey Specala AI'de görünür: yönetici analizleri okur, çağrılarda arama yapar ve yapay zeka asistanına sorar — tarayıcıda ve masaüstü uygulamasında.
Kendi yapay zeka raporların
Senin prompt'un, her görüşme için senin raporun
Uygulamada bir prompt yaz, rapor bir kimlik alsın. Onu reports parametresinde gönder; transkriptle birlikte senin kurallarınla hazırlanmış rapor gelsin: çağrı kontrol listesi, itiraz analizi, CRM kartı.
Ayarlar → Yapay zeka raporları
- Ad
- Çağrı kontrol listesi
- Kimlik
call-checklist- Prompt
- Sen bir satış müdürüsün. Çağrıyı kontrol listesine göre incele: temsilci kendini tanıttı mı, ihtiyacı belirledi mi, fiyatı söyledi mi, bir sonraki adımda anlaştı mı? Her madde için evet ya da hayır de ve bir alıntı ver.
İstek
curl -X POST "https://app.specala.ai/api/v1/developer/transcriptions?reports=call-checklist" \-H "Authorization: Bearer sk_live_…" \-H 'Content-Disposition: attachment; filename="call-48213.mp3"' \--data-binary @call-48213.mp3Yanıt201 Createdqueuedprocessingcompleted
{"status": "completed","prompt_results": [{ "slug": "call-checklist", "name": "Çağrı kontrol listesi","text": "Kendini tanıttı: evet, “Ben Crumbwell'den Marcus”\nİhtiyacı belirledi: evet, “Deneme teslimatına ihtiyacımız var”\nFiyatı söyledi: hayır\nSonraki adım: evet, “Pazartesi konuşalım”" }]}Yapay zeka raporları
Yapay zeka analizi bir istek parametresidir
?reports= ekle; transkript özet ve görevlerle birlikte gelsin — dil modeline ayrı bir çağrı gerekmeden.
İstek
curl -X POST "https://app.specala.ai/api/v1/developer/transcriptions?reports=summary" \-H "Authorization: Bearer sk_live_…" \-H 'Content-Disposition: attachment; filename="call-48213.mp3"' \--data-binary @call-48213.mp3Yanıt
{"status": "completed","prompt_results": [{ "slug": "summary", "name": "Özet","text": "Müşteri bir kafe, deneme teslimatı istiyor. Numuneler perşembe, fiyat listesi bugün." }]}Arama ve dışa aktarma
Her görüşmeyi tek bir istekle bul
Kayıtları fırsat numarasına, kendi alanlarına, tarihe ve duruma göre filtrele — kendi veritabanın ve indekslerin olmadan. Arşiv mi lazım? 100 transkripte kadarını tek bir ZIP olarak al.
İstek
curl "https://app.specala.ai/api/v1/developer/transcriptions" \-H "Authorization: Bearer sk_live_…"Yanıt
{"items": [{ "title": "Deneme teslimatı","external_id": "deal-48213", "metadata": { "manager": "marcus" },"created_at": "2026-09-18T10:12:00Z" },{ "title": "Takip araması","external_id": "deal-48213", "metadata": { "manager": "marcus" },"created_at": "2026-09-11T10:12:00Z" },{ "title": "Sözleşme yenileme","external_id": "deal-47990", "metadata": { "manager": "anna" },"created_at": "2026-09-17T10:12:00Z" },{ "title": "Bean & Leaf kafe","external_id": "deal-48102", "metadata": { "manager": "marcus" },"created_at": "2026-09-16T10:12:00Z" },{ "title": "Yeni müşteri","external_id": "deal-48240", "metadata": { "manager": "anna" },"created_at": "2026-09-10T10:12:00Z" }]}Güvenlik
Müşterilerinin kayıtları senin kontrolünde kalır
Anahtarlar varsayılan olarak salt okunur
Yükleme, silme ve rapor izinleri anahtar oluşturulurken verilir ve sonradan değişmez.
Transkriptler şifrelenir
Her çalışma alanı için ayrı bir şifreleme anahtarı.
Kaynak kayıt saklanmaz
Dosya işleme sırasında silinir — yalnızca metin kalır.
Silme iz bırakmaz
Tek istek, transkripti ve raporları sunucularımızdan tüm üyeler için siler.
Yapay zeka ajanları
Ajanın bağlantıyı kendi kurar
OpenAPI spesifikasyonu, model için tek dosya halinde dokümantasyon ve bir MCP sunucusu: Claude Code, Cursor ve ChatGPT kayıtlarınla doğrudan çalışır.
MCP sunucusuClaude Code, Cursor, ChatGPT
terminal
claude mcp add --transport http specala-ai https://mcp.specala.ai/mcpOpenAPI 3.1istemci üreteçleri ve ajanlar için
terminal
curl https://specala.ai/openapi.jsonTek dosyada dokümantasyonmodele tek seferde ver
terminal
curl https://specala.ai/docs/llms-full.txtWhisper API'den ne farkı var
Herkese açık dokümantasyona göre karşılaştırdık — daha iyi olmadığımız satır dahil.
| Kriter | Specala AI | Whisper API (OpenAI) |
|---|---|---|
| Ne döner | konuşmacılara ayrılmış metin ve yapay zeka raporu | metin |
| Aynı istekte yapay zeka raporu | evet, kendi şablonunla da | hayır, ayrı bir model çağrısı |
| Dosya boyutu | 2 GB ve 10 saate kadar | 25 MB'a kadar |
| Konuşmacılar | varsayılan olarak ayrılır | ayrı bir model |
| Diller | 99, otomatik algılanır | onlarca |
| Hazır olduğunu nasıl anlarsın | durumu sorgularsın | yanıt hemen gelir, kuyruk yok |
| Ekip için arayüz | evet: kayıtlar uygulamada görünür | yok |
Whisper API bilgileri, OpenAI'nin Eylül 2026 itibarıyla herkese açık dokümantasyonundan alınmıştır.
Plan dakikaları
API, uygulamayla aynı dakikaları harcar — konuşmacı ayrımı dahil.
Pro ve Expert planları
API erişimi her iki plana da dahildir.
Kartla ödeme
Aylık ya da yıllık faturalandırma.
İlk transkriptin — beş dakikada
Anahtar oluştur
Uygulamada: Ayarlar → API ve MCP. Anahtar yalnızca bir kez gösterilir.
AuthorizationAuthorization: Bearer sk_live_…Dosya gönder
İstek gövdesinde dosyayla tek POST. Karşılığında kaydın ID'sini alırsın.
curlcurl -X POST "https://app.specala.ai/api/v1/developer/transcriptions" \-H "Authorization: Bearer sk_live_…" \-H 'Content-Disposition: attachment; filename="call-48213.mp3"' \--data-binary @call-48213.mp3Sonucu al
Durum completed olana kadar 5–10 saniyede bir sorgula.
status.shcurl "https://app.specala.ai/api/v1/developer/transcriptions/$UUID" \-H "Authorization: Bearer sk_live_…"
SSS
Sorular ve yanıtlar
Specala AI speech recognition API neler yapabilir?
Konuşma tanıma API'si (speech recognition API, bazı ekipler voice recognition API der) tek istekte 2 GB ve 10 saate kadar ses ve video kabul eder, zaman damgalı ve konuşmacılara ayrılmış metin döndürür. Arka planda 99 dil için otomatik konuşma tanıma (automatic speech recognition) çalışır ve dil otomatik algılanır. İstersen yapay zeka raporları hazırlar: özet, görevler ya da ekibinin şablonuna göre bir rapor. Fırsat numarası ve temsilci kayıtla birlikte gider: API, CRM ve telefon sistemi entegrasyonları için tasarlandı. API referansı
Ücreti ne kadar, ücretsiz erişim var mı?
API, planındaki dakikaları harcar. API erişimi Pro ve Expert planlarıyla gelir; ücretsiz plana dahil değildir, yani bu ücretsiz bir speech to text API değil. Specala AI fiyatları
Bir kayıt ne kadar hızlı işlenir?
Bir saatlik ses yaklaşık 4 dakika sürer: bu, iki haftadaki 28 bin kaydın medyanıdır; yüklemenin bitmesinden konuşmacılara ayrılmış metnin hazır olmasına kadar. Kısa kayıtlar saniyeler içinde hazır olur. Garanti edilen bir işleme süresi yoktur.
Hangi formatlar, hangi dosya boyutu?
73 ses ve video uzantısı — mp3, wav, m4a, ogg, flac, mp4, mov, mkv, webm ve daha fazlası; videodaki ses otomatik ayıklanır. 2 GB ve 10 saate kadar bir dosya istek gövdesi olarak gider: bu audio transcription API ne multipart form ister ne de parçalı yükleme.
Transkripti hangi formatlarda dışa aktarabilirim?
Markdown, txt ve JSON olarak. Markdown, YAML üst bilgisiyle (başlık, tarih, dil, konuşmacılar, konular) ve yapay zeka raporlarıyla gelir; doğrudan Obsidian'a ya da bilgi tabanına girer. txt düz metindir; JSON zaman damgalarını ve konuşmacı kimliklerini korur. 100 transkripte kadar arşiv tek bir ZIP olarak iner. SRT, DOCX ve PDF API üzerinden yok; bunlar uygulamada var. Transkripti dışa aktar
CRM'den ya da telefon sisteminden gelen çağrılar için uygun mu?
Evet — API tam da bunun için tasarlandı: CRM'inden ya da telefon sisteminden gelen çağrıların otomatik transkripsiyonu onun ana senaryosu. Dosyayla birlikte fırsat numarasını (X-External-Id), satış hattı, kaynak ya da kuyruk gibi kendi alanlarını (X-Metadata) ve temsilciyi (X-Author) gönderirsin: kayıt onun listesine düşer, sonra bir fırsatın tüm çağrılarını tek istekle bulursun. Kontrol listene göre hazırlanan rapor aynı yanıtta gelir — geriye onu fırsat kartına koymak kalır. Hazır bağlayıcı yok: bu bir call transcription API ve onu CRM'e ya da santrale geliştiricin bağlar.
Çağrı transkripsiyonunu nasıl otomatikleştiririm?
Üç adım. CRM'in ya da santralin, çağrının bittiğini handler'ına bildirir; handler kaydı fırsat numarası ve temsilciyle birlikte API'ye gönderir; durum completed olunca metni ve raporu alıp fırsat kartına koyar. Toplantıların, mülakatların ve sesli notların otomatik transkripsiyonu da aynı şekilde çalışır. Kod yazmadan bunu n8n ya da Make içinde HTTP istek düğümleriyle kurabilirsin — ayrı bir uygulamaya gerek yok. Sonuç: kayıtları tek tek dinlemek yerine kontrol listene göre yapay zeka destekli çağrı analizi. Dosya yükleme ve entegrasyon başlıkları
Google Cloud Speech-to-Text ya da Amazon Transcribe'dan farkı ne?
Bir Google speech to text API ya da AWS Transcribe API tanınan metni döndürür, gerisi sana kalır: konuşmacılar, analiz, fırsatla ilişkilendirme. Bu API satış entegrasyonları için tasarlandı: aynı istek konuşmacılara ayrılmış metni ve kontrol listene göre hazırlanmış yapay zeka raporunu getirir, kayıt da CRM'indeki fırsata ve temsilciye hemen bağlanır. Anahtar ise bulut konsolu olmadan, uygulama ayarlarında bir dakikada oluşturulur.
Whisper API'den farkı ne?
OpenAI'ın Whisper API'si 25 MB'a kadar dosya alır ve konuşmacı ayrımı için ayrı bir model ister — whisper diarization temel çağrının parçası değildir. Burada 2 GB dosya limiti, varsayılan olarak konuşmacılar, aynı istekte yapay zeka raporları ve CRM'indeki fırsata ve temsilciye bağlı kayıtlar var. Whisper'ı Python'da kendin çalıştırıyorduysan (openai-whisper, faster-whisper), burada GPU'ya da kendi iş kuyruğuna da ihtiyacın yok. Whisper kuyruk olmadan hemen yanıt verir; burada durumu sorgularsın.
SDK var mı?
Ayrı bir SDK yok. İstemci üretmek için OpenAPI 3.1 spesifikasyonu ve her referans sayfasında curl, Python ve JavaScript ile hazır örnekler var — speech to text API düz HTTP istekleriyle kullanılır. Python'da speech to text tek bir httpx isteğidir; kendi modellerin gerekmez. Hızlı başlangıç
Veriler nerede saklanır ve nasıl silerim?
Transkriptler ve raporlar, her çalışma alanı için ayrı bir anahtarla şifrelenmiş olarak saklanır. Kaynak dosya işleme sırasında silinir. Tek bir DELETE isteği kaydı sunucularımızdan tüm üyeler için kalıcı olarak siler.
MCP sunucusunu nasıl bağlarım?
Claude Code için tek komutla ya da Claude, ChatGPT ve Cursor'daki bağlayıcı üzerinden — OAuth ile giriş, aynı hesap. REST (transcription API) kodun için, MCP ise asistanın için. Specala AI MCP sunucusu
API
İlk kaydını bugün gönder
Anahtar, uygulama ayarlarında bir dakikada oluşturulur.