Lewati ke konten
Transcript Dock
MasukMulai gratis

Menu situs

Transcript Dock
API YouTube

API transkrip YouTube subtitle kreator lebih dulu, berwaktu per cue

Satu endpoint untuk video dan Shorts YouTube. Subtitle dari kreator diutamakan, dengan waktu per cue.

1.0Kemampuan

Keunggulan utama dan batasan yang menyertainya

Ambil subtitle dari kreator untuk video dan Shorts YouTube sebagai segmen berwaktu, dengan transkripsi AI di paket berbayar untuk video tanpa subtitle.

  1. Subtitle kreator lebih dulu

    Jika video sudah memiliki subtitle yang dipublikasikan, jalur subtitle kreator langsung dibaca, tanpa unduhan audio dan tanpa biaya transkripsi AI.

  2. Tautan watch, bagikan, dan Shorts

    Tautan watch standar, tautan bagikan youtu.be, dan tautan Shorts semuanya mengarah ke video yang sama, sehingga satu bentuk permintaan mencakup semuanya.

  3. Waktu segmen dan kata

    Jalur subtitle diberi waktu per cue. Transkripsi AI mengembalikan waktu per kata, sehingga Anda bisa memotong klip dan menyelaraskan linimasa.

  4. Ekspor terstruktur dalam banyak format

    Ekspor hasil JSON terpadu atau unduh file subtitle SRT dan WebVTT standar dengan format yang konsisten.

Batas operasional dan transparansi

  • Infrastruktur satu region, dideploy di us east.
  • Harga: 1 kredit per transkrip subtitle dan 2 kredit per menit transkripsi AI yang sudah dimulai, dari satu saldo.
  • Durasi media maksimum adalah 2 jam (7,200 detik) per sumber.
2.0Implementasi

Permintaan dan respons permintaan yang tepat dan apa yang dikembalikan

POST/v1/jobs

curl -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer td_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"source": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
},
"mode": "captions_only",
"caption_preference": "prefer_creator"
}'

Hasil tugas

{
"id": "7b8f9e0a-4c2d-4e6f-8a1b-3c5d7e9f1a2b",
"status": "succeeded",
"stage": null,
"result_id": "9c1d3e5f-7a9b-4c2d-8e0f-1a3b5c7d9e2f",
"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": "Sample YouTube Video",
"upload_id": null
},
"options": {
"mode": "captions_only",
"language": null,
"caption_preference": "prefer_creator"
},
"created_at": "2026-09-12T14:32:00Z"
}
3.0Pertanyaan

Pertanyaan umum

Apa yang terjadi pada subtitle, transkripsi AI, dan batasan untuk sumber ini.

Bagaimana API menangani video tanpa closed caption?

Saat mode diatur ke auto, sistem memeriksa subtitle dari kreator terlebih dahulu. Jika tidak ada, sistem mengambil audio dengan aman dan menjalankan transkripsi AI untuk menghasilkan transkrip dengan tanda waktu.

Bisakah saya meminta subtitle saja untuk mencegah biaya transkripsi AI?

Ya. Mengatur mode ke captions_only menjamin tidak ada alur transkripsi AI yang berjalan, sehingga biaya ekstraksi lebih mudah diprediksi dan rendah.

Apakah YouTube Shorts didukung?

Ya. Tautan watch youtube.com standar dan URL youtube.com/shorts sama-sama dinormalisasi dan ditranskripsikan.