Geliştirici API

Sunucundan çağırabileceğin deşifre servisi

Dosyayı ya da bağlantıyı gönder, tek uçtan durumu sor, zaman damgalı ve konuşmacı etiketli metni al. Uygulamada deşifreyi yapan motorun aynısı, bu kez HTTP üzerinden. Her abonelikte var, dakika başına ek ücret yok.

Fiyatlandırmayı Görüntüle

POST /api/public/v1/transcriptions

curl -X POST https://heartotext.com/api/public/v1/transcriptions \
  -H "Authorization: Bearer h2t_live_..." \
  -H "Idempotency-Key: 7f3c9a12" \
  -F "file=@meeting.m4a" \
  -F "language=en"

{
  "id": "0f2f5f6a-2c6c-4f4e-9d1e-5d8f2a1b3c4d",
  "status": "queued",
  "title": null,
  "language": "en",
  "duration_seconds": null,
  "created_at": "2026-09-19T10:11:12+00:00",
  "updated_at": "2026-09-19T10:11:12+00:00",
  "source": { "type": "file", "name": "meeting", "url": null },
  "workspace": null,
  "progress": { "step": null, "percent": null, "indeterminate": false },
  "failure_reason": null
}

Kaydı yükle, karşılığında bir kimlik al.

Neler geliştirebilirsin

Araya insan girmeden konuşmayı metne çevirmesi gereken her şey.

Toplantı notları

Görüşme biter bitmez kaydı gönder; kimse bilgisayarını yeniden açmadan deşifre çalışma alanında hazır olsun.

Podcast hattı

Yayın işinin bir adımı olarak ana dosyadan bölüm notlarını, bölüm işaretlerini ve SRT altyazıyı üret.

Çağrı kalitesi

Destek ve satış görüşmelerini otomatik puanla: konuşmacı etiketi kimin konuştuğunu, zaman damgası ne zaman konuştuğunu söyler.

Medya arşivleri

Yılların ses ve video birikimini aranabilir metne çevir; dosya başına bir istek, adil kullanım tavanının izin verdiği hızda.

Baştan sona üç istek

Kurulacak SDK yok, bakımını üstleneceğin webhook yok. Oluştur, sor, al.

Oluştur

Dosyayı ya da bağlantıyı POST et. Anında bir kimlik ve "queued" durumu döner.

POST /transcriptions

curl -X POST https://heartotext.com/api/public/v1/transcriptions \
  -H "Authorization: Bearer h2t_live_..." \
  -H "Idempotency-Key: 7f3c9a12" \
  -F "file=@meeting.m4a" \
  -F "language=en"

{
  "id": "0f2f5f6a-2c6c-4f4e-9d1e-5d8f2a1b3c4d",
  "status": "queued",
  "title": null,
  "language": "en",
  "duration_seconds": null,
  "created_at": "2026-09-19T10:11:12+00:00",
  "updated_at": "2026-09-19T10:11:12+00:00",
  "source": { "type": "file", "name": "meeting", "url": null },
  "workspace": null,
  "progress": { "step": null, "percent": null, "indeterminate": false },
  "failure_reason": null
}

Durumu sor

Durum "completed" olana kadar kaydı GET et. Yanıt, çalışırken hangi adımda olduğunu ve yüzdeyi de taşır.

GET /transcriptions/{id}

curl https://heartotext.com/api/public/v1/transcriptions/0f2f5f6a-2c6c-4f4e-9d1e-5d8f2a1b3c4d \
  -H "Authorization: Bearer h2t_live_..."

{
  "id": "0f2f5f6a-2c6c-4f4e-9d1e-5d8f2a1b3c4d",
  "status": "completed",
  "title": null,
  "language": "en",
  "duration_seconds": 1845,
  "created_at": "2026-09-19T10:11:12+00:00",
  "updated_at": "2026-09-19T10:14:40+00:00",
  "source": { "type": "file", "name": "meeting", "url": null },
  "workspace": null,
  "progress": { "step": null, "percent": null, "indeterminate": false },
  "failure_reason": null
}

Al

Segmentleri imleçli sayfalamayla çek ya da tamamını txt, srt, vtt, pdf veya docx olarak iste.

GET /transcriptions/{id}/segments

curl "https://heartotext.com/api/public/v1/transcriptions/0f2f5f6a-2c6c-4f4e-9d1e-5d8f2a1b3c4d/segments?limit=100" \
  -H "Authorization: Bearer h2t_live_..."

{
  "data": [
    { "index": 0, "start": 61.0, "end": 65.0, "speaker": "A", "text": "Hello" }
  ],
  "has_more": true,
  "next_cursor": "eyJvIjoxMDB9"
}

Ana Özellikler

Konuşmacı etiketleri

Her segment, sesin kendisinden çıkarılan konuşmacı bilgisini taşır.

Zaman damgalı segmentler

Her segmentte başlangıç ve bitiş saniyesi; altyazıya da oynatıcıda konumlanmaya da hazır.

Otomatik dil tespiti

Dili belirtmeden gönder, kendisi bulsun; istersen ISO koduyla sabitle.

Dışa aktarma biçimleri

Aynı kayıttan txt, srt, vtt, pdf ve docx — yeniden çalıştırmaya gerek kalmadan.

Güvenli yeniden deneme

Oluşturma isteğine Idempotency-Key koy; aynı istek tekrar gelirse ikinci bir kayıt açılmaz, ilk yanıt döner.

Tek hata biçimi

Her hata, sabit bir hata kodu ve insanın okuyabileceği bir mesaj taşıyan JSON gövdesidir.

Yalnızca abonelere

Her Hear2Text aboneliğinde var

API ayrı bir ürün değil, ayrı faturası da yok. Ücretli planların hepsi açar; dakika başına API fiyatı ya da ücretsiz API kademesi yok. Aboneliğin biterse anahtarın durur, yenilediğinde kaldığı yerden çalışır.

Aylık

$9,99/ay

Yıllık

$89,99/yıl

Aylığa vurursan $7,50 eder.

Anahtarları profilindeki API sekmesinden oluşturur ve iptal edersin. Anahtar yalnızca oluşturulduğu anda bir kez gösterilir.

Sınırlar

Bunlar API’nin gerçekten uyguladığı sınırlar, sayfanın yazıldığı gün not edilmiş rakamlar değil.

Sınır	Değer
Tek kayıt için en uzun süre	6 saat
Günlük ses (adil kullanım)	1200 dakika
Aynı anda işlenen kayıt	5
En büyük yükleme	512 MB
Anahtar başına dakikadaki istek	120
Hesap başına saatte yeni kayıt	60
Hesap başına günde yeni kayıt	500

Hız sınırını aşarsan Retry-After başlığıyla 429 alırsın; isteğin kaybolmaz, ek ücret de çıkmaz.

Sıkça Sorulan Sorular

API ne kadar?

Aboneliğinin dışında hiçbir şey. Dakika başına API ücreti ya da ayrı bir geliştirici planı yok — ücretli Hear2Text aboneliği, yukarıdaki adil kullanım sınırları içinde API erişimini kapsıyor.

Ücretsiz kademe ya da deneme anahtarı var mı?

Yok. API yalnızca abonelere açık. Deşifrenin kendisini uygulamada ücretsiz deneyebilirsin; abone olduğun anda API de açılır.

Kayıt bitince webhook gönderiyor musunuz?

v1’de hayır. Durumu uçtan soruyorsun; bu hem ucuz, hem de dışarı açık bir geri çağırma adresi barındırmanı gerektirmiyor. Webhook listede var.

API üzerinden çeviri ya da yapay zekâ asistanı kullanabilir miyim?

v1’de hayır. Çeviri ve asistan şimdilik uygulamada kalıyor; API deşifre, segmentler ve dışa aktarmayı kapsıyor.

API’yi tarayıcıdan çağırabilir miyim?

Hayır. CORS bilerek kapalı: API anahtarı sunucunda durur, ziyaretçinin okuyabileceği bir sayfada değil.

Aboneliğimi iptal edersem anahtarlarıma ne olur?

Kimlik doğrulaması durur, her istek 403 subscription_required döner. Anahtarlar profilinde kalır; yeniden abone olursan tekrar çalışır.

Geliştirmeye başla

Referans, hata listesi ve kopyala-yapıştır örnekler dokümantasyonda.

Dokümantasyonu oku API anahtarlarına git