Mulai cepat

Tiga permintaan mengubah tautan video menjadi file transkrip. Anda memerlukan kunci API: buat di halaman Kunci API. Kunci hanya ditampilkan sekali. Setiap akun mendapat 50 kredit gratis setiap bulan.

1. Kirim tautan#

mode: "captions_only" mengembalikan subtitle video dengan 1 kredit dan berfungsi di semua paket, termasuk uji coba gratis. Di paket berbayar, kirim mode: "auto" agar beralih ke transkripsi AI saat video tidak punya subtitle (2 kredit per menit yang dimulai). Idempotency-Key adalah string 8 sampai 128 karakter yang Anda pilih sendiri; mengirim kunci yang sama lagi mengembalikan tugas yang sama alih-alih membuat tugas kedua.

curl -X POST https://www.transcriptdock.com/v1/jobs \
  -H "Authorization: Bearer td_live_YOUR_KEY" \
  -H "Idempotency-Key: my-first-job" \
  -H "Content-Type: application/json" \
  -d '{ "source": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, "mode": "captions_only" }'

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "queued",
  "stage": "resolve",
  "result_id": null,
  "error": null,
  "billing": { "credits_reserved": 1, "credits_charged": 0, "kind": "captions" },
  "source": { "platform": "youtube", "media_id": "dQw4w9WgXcQ", "canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": null, "upload_id": null },
  "options": { "mode": "captions_only", "language": null, "caption_preference": "prefer_creator" },
  "created_at": "2026-09-16T10:00:00.000Z"
}

2. Tunggu hasilnya#

?wait=25 menahan permintaan hingga 25 detik dan kembali segera setelah tugas selesai. Subtitle biasanya butuh beberapa detik; transkripsi AI butuh sekitar seperempat panjang video. Jika status masih belum succeeded, failed, atau cancelled, panggil lagi.

curl "https://www.transcriptdock.com/v1/jobs/11111111-1111-4111-8111-111111111111?wait=25" \
  -H "Authorization: Bearer td_live_YOUR_KEY"

{
  "id": "11111111-1111-4111-8111-111111111111",
  "status": "succeeded",
  "stage": null,
  "result_id": "22222222-2222-4222-8222-222222222222",
  "error": null,
  "billing": { "credits_reserved": 0, "credits_charged": 1, "kind": "captions" },
  "source": { "platform": "youtube", "media_id": "dQw4w9WgXcQ", "canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": null, "upload_id": null },
  "options": { "mode": "captions_only", "language": null, "caption_preference": "prefer_creator" },
  "created_at": "2026-09-16T10:00:00.000Z"
}

3. Ambil transkripnya#

result_id adalah transkripnya. Ekspor sebagai txt, srt, vtt, atau json (teks lengkap, segmen bertanda waktu, dan waktu per kata untuk transkripsi AI). Ekspor gratis dan tanpa batas.

curl "https://www.transcriptdock.com/v1/transcripts/22222222-2222-4222-8222-222222222222/export?format=srt" \
  -H "Authorization: Bearer td_live_YOUR_KEY"

1
00:00:00,000 --> 00:00:02,400
This is the first caption
 
2
00:00:02,400 --> 00:00:04,900
This is the second caption

Langkah berikutnya#

• Mengirim tautan yang sama lagi tidak dikenai biaya: hasil yang tersimpan yang dikembalikan.
• Banyak video sekaligus: batch, hingga ukuran batch paket Anda per permintaan.
• File Anda sendiri: unggahan.
• Tanpa polling: webhook akan menghubungi Anda saat tugas selesai.
• Dari Claude, Cursor, atau agen AI lain: MCP.