Hızlı başlangıç — Hear2Text API

Önce bir anahtar

Giriş yapın, Profil → API sayfasını açıp bir anahtar oluşturun. Anahtarı yalnızca bir kez görürsünüz; üretimdeki diğer gizli bilgilerinizi nerede saklıyorsanız onu da orada saklayın. Aşağıdaki örneklerin hepsi anahtarın H2T_API_KEY içinde olduğunu varsayar.

1. Kaydı başlatın

Ya bir dosya yükleyin ya da bir url gönderin, kaynağı biz indirelim. Yanıt hemen döner; içinde status: "queued" yazar — asıl iş yanıt gittikten sonra yapılır.

curl https://heartotext.com/api/public/v1/transcriptions \
  -H "Authorization: Bearer $H2T_API_KEY" \
  -H "Idempotency-Key: 9f1c2b7a-1f2e-4a0c-9f0b-2c1d3e4f5a6b" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/episode-42.mp3","language":"en"}'

201 Created

{
  "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": "url", "name": null, "url": "https://example.com/episode-42.mp3" },
  "workspace": null,
  "progress": { "step": null, "percent": null, "indeterminate": false },
  "failure_reason": null
}

2. Durumunu sorgulayın

Kaydın status alanı completed ya da failed olana kadar durumunu sormayı sürdürün. Beş saniyede bir sormak fazlasıyla yeterli; önerdiğimiz aralıklar için durum sorgulama sayfasına bakın.

curl https://heartotext.com/api/public/v1/transcriptions/$ID \
  -H "Authorization: Bearer $H2T_API_KEY"

3. Deşifre metnini okuyun

Segmentler okuma sırasıyla, sayfa sayfa gelir. next_cursor değerini, has_more true olduğu sürece izleyin. Metnin tamamını tek dosya olarak isterseniz /export endpoint’i de var.

curl "https://heartotext.com/api/public/v1/transcriptions/$ID/segments?limit=200" \
  -H "Authorization: Bearer $H2T_API_KEY"

# or as a file
curl "https://heartotext.com/api/public/v1/transcriptions/$ID/export?format=srt" \
  -H "Authorization: Bearer $H2T_API_KEY" -o episode-42.srt

200 OK

{
  "data": [
    { "index": 0, "start": 0.0, "end": 4.2, "speaker": "A", "text": "Welcome back to the show." },
    { "index": 1, "start": 4.2, "end": 9.8, "speaker": "B", "text": "Glad to be here." }
  ],
  "has_more": true,
  "next_cursor": "eyJvIjoyMDB9"
}

Hepsi bu kadar

Entegrasyon bundan ibaret. Bu sayfalarda anlatılan geri kalan her şey aynı işi iyi yapmakla ilgili: idempotency anahtarlarıyla güvenle yeniden denemek, hız sınırlarının içinde kalmak ve er geç karşılaşacağınız hataları doğru ele almak.