Genel bakış

Ne işe yarar

Bir kayıt gönderirsiniz — yüklediğiniz bir dosya ya da herkese açık bir bağlantı — API de karşılığında zaman bilgili, konuşmacı etiketli bir deşifre metni verir. Deşifreyi, uygulamaların kullandığı motorun aynısı yapar; doğruluk da, diller de, konuşmacı ayrımı da birebir aynı.

curl https://heartotext.com/api/public/v1/transcriptions \
  -H "Authorization: Bearer $H2T_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F file=@meeting.m4a \
  -F language=en

Kimler kullanabilir

Yalnızca abonelere. API, ücretli Hear2Text aboneliğine dahil: ayrı bir API planı, dakika başına ücret ya da ücretsiz kademe yok. Hesap abone değilse her istek 403 subscription_required döner.

Abonelik biterse anahtarlarınız yerinde kalır. İstekler aynı 403’le reddedilir; abonelik yeniden etkinleşir etkinleşmez istekler de geçmeye başlar. Yani ödemesi geçmeyen bir kart, entegrasyonu baştan yazmanız anlamına gelmez. Misafir hesaplar hiçbir koşulda anahtar tutamaz.

API’nin yapısı

• Ana adres: https://heartotext.com/api/public/v1
• Kimlik doğrulama: Authorization: Bearer h2t_live_… başlığıyla; anahtarı profilinizden oluşturursunuz ve yalnızca bir kez görürsünüz.
• Yalnızca sunucudan. CORS bilerek kapalı. Tarayıcıya koyduğunuz anahtar, herkesin anahtarıdır.
• v1’de webhook yok. Kaydı oluşturup durumunu sorarsınız. Durum sorgulama sayfası, bunu istek harcamadan nasıl yapacağınızı anlatıyor.
• Veritabanı kimliği yok. Kayıtlara opak bir id ile, dillere ISO koduyla, çalışma alanlarına adıyla ulaşırsınız.
• Her hata aynı biçimde döner: { "error", "message" }.
• Makineler için: OpenAPI 3.1 belgesi ve bir Postman koleksiyonu — ikisi de bu sayfalarla aynı kaynaktan üretiliyor.

Buradan sonra

• Hızlı başlangıç — Üç istek: kaydı oluşturun, durumunu sorgulayın, deşifre metnini okuyun.
• Kimlik doğrulama ve anahtarlar — Anahtarı nasıl oluşturursunuz, nerede durur, abonelik biterse ne olur.
• Deşifre oluşturma — Dosyalar ve bağlantılar, desteklenen kaynaklar, diller, sınırlar.
• Durum sorgulama — v1 webhook göndermez. Beklerken istek harcamamanın yolu.
• Sonuçlar — Segmentler, konuşmacılar ve dışa aktarma biçimleri.
• Hatalar — Her hatada dönen aynı gövde ve API’nin verebileceği kodların tamamı.
• Hız sınırları ve adil kullanım — Rakamlar, başlıklar ve 429 aldığınızda ne yapmanız gerektiği.
• Idempotency — Bir oluşturma isteğini, aynı kaydı ikinci kez açmadan yeniden denemek.
• Sürümler ve kullanımdan kaldırma — v1 içinde ne değişebilir, değişmeden önce size ne söz veriyoruz.
• Değişiklik günlüğü — API’de yapılan her değişiklik, en yenisi üstte.
• API referansı — Bütün endpointler, OpenAPI belgesinden üretilir.