Jelajahi dokumentasi
Referensi API
YouTube Captions API
Ambil judul YouTube sebagai teks yang distempel waktu dan transkrip penuh. Pemutakhiran - terjemahan yang disediakan dipilih secara baku.
Buat permintaan
ID sepanjang 11 karakter dari URL video, bukan URL lengkapnya.
Kosongkan untuk mencoba en-orig, lalu en, dan mengembalikan satu trek. Atau masukkan satu hingga 10 kode berbeda yang dipisahkan koma.
https://data.flashdata.dev/v1/queries/realtimeParameter
Kirim source dan video_id di tingkat atas. Pilihan sumber termasuk dalam params. Bidang opsional dapat dihilangkan.
Isi permintaan
sourcestring / Wajib- Set ke youtube_captions.
video_idstring / Wajib- Karakter 11-YouTube video ID, seperti FUFFGCZ092b0. Menerima surat, nomor, garis bawah dan tanda hubung.Tepat 11 karakterBaku:
Tak ditataFormat yang diterima
^[A-Za-z0-9_-]{11}$ paramsobject / Opsional- Settings untuk permintaan ini.Baku:
{} callback_urlstring · nullable / Opsional- Async dan batch saja. Publik HTTPS pelengkapan URL di port 443, sampai 2,048 karakter. Tak ada kredensial pengguna atau fragmen URL. Omit, gunakan null atau string kosong untuk tanpa pemberitahuan. Dalam batch, set ini pada setiap query, di luar param.Baku:
Tak ditata
Pemilihan judul
params.languagestring | array / Opsional- Abaikan untuk Inggris (en-orig, kemudian en). Dengan auto = true, tiap kode mencoba trek -orig yang pertama, maka kode yang diminta. Eksplisit -orig kode dan auto = false tetap tepat. Permintaan array 1–10 bahasa yang berbeda.Baku:
en-orig → en params.autoboolean / Opsional- true memilih YouTube-terjemahan yang dihasilkan; false memilih uphavder-disediakan captions. Ini memilih asal dari judul, bukan bahasa deteksi atau transkripsi baru.
trueataufalseBaku:false
Respons
Realtime kembali status: done. Baca keluaran sumber pada results[0]; usage.credits Records the charge.
Baca segmen untuk teks judul dengan start/end kali dalam detik dan fullText untuk teks bergabung. languageCode dan isAutoGenerated melaporkan trek yang dipilih.
Baca hasilnya
Simpan respon JSON sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan Python perpustakaan standar dan tidak membuat permintaan baru.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {
"tracks": result.get("tracks", [result]),
"errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))Abaikan bahasa untuk lebih memilih en-orig dan kembali ke en, mengembalikan satu trek. Dengan auto = true, masing-masing kode yang diminta lebih suka trek -orig, maka kode polos; eksplisit -orig dan auto = false tetap tepat. Array mencoba setiap bahasa yang diminta dan kembali trek dan kesalahan dalam rangka. languageCode mengidentifikasi trek yang dipilih; requestedLanguageCode termasuk ketika berbeda.
Untuk daftar bahasa, periksa errors untuk melihat trek yang gagal. Jika tidak ada trek yang berhasil diambil, permintaan gagal dan kredit yang dicadangkan dikembalikan. Kegagalan ekstraksi video dan tenggat permintaan yang terlampaui juga menyebabkan permintaan gagal.
auto default untuk false untuk uphauder-disediakan takarir. Set true untuk terjemahan otomatis. The API tidak pernah switch sumber takarir.
API membaca YouTube yang sudah ada; ini tidak menghasilkan transkrip baru. Respon baku berisi normalisasi segmen JSON; Accept dapat memilih teks polos dan X-Respond-With: pilihan markdown Markdown. languageName dapat nullPenghitung segmen dipertahankan.
Beberapa bahasa
Kirim suatu array bahasa untuk menerima trek dan kesalahan bahasa permanen. Contoh ini menunjukkan bahasa Inggris tersedia dan Spanyol tidak tersedia.
{
"source": "youtube_captions",
"video_id": "jNQXAC9IVRw",
"params": {
"language": [
"en",
"es"
],
"auto": false
}
}{
"videoId": "jNQXAC9IVRw",
"isAutoGenerated": false,
"tracks": [
{
"videoId": "jNQXAC9IVRw",
"languageCode": "en",
"languageName": null,
"isAutoGenerated": false,
"segments": [
{
"start": 0,
"end": 1.5,
"text": "Hello world."
}
],
"fullText": "Hello world."
}
],
"errors": [
{
"languageCode": "es",
"code": "language_unavailable",
"message": "Uploader-provided subtitles not available for language: es"
}
]
}Semua ruas respon
| Ruas | Deskripsi |
|---|---|
sourcestring | Sumber yang diminta API. |
statusstring | dilakukan ketika permintaan realtime sukses. |
created_atstring | Waktu pembuatan respon dalam format ISO 8601. |
usage.creditsnumber | Kredit dikenakan biaya untuk permintaan, berdasarkan rencana Anda. |
results[0].videoIdstring | Video yang diminta ID. |
results[0].languageCodestring | Kode jalur judul yang dipilih sebenarnya, seperti en- orig. |
results[0].languageNamestring · nullable | Nama tampilan bahasa ketika tersedia. |
results[0].requestedLanguageCodestring · optional | Kode yang diminta ketika berbeda dari languageCode, misalnya en ketika en- orig dipilih. |
results[0].isAutoGeneratedboolean | Apakah judul yang dipilih dihasilkan secara otomatis. |
results[0].segmentsarray | Segmen judul dalam urutan kronologis. |
results[0].segments[].startnumber | Segmen mulai waktu dalam detik. |
results[0].segments[].endnumber | Segmen akhir waktu dalam hitungan detik. |
results[0].segments[].textstring | Teks judul. |
results[0].fullTextstring | Semua teks segmen bergabung ke dalam transkrip. |
results[0].tracksarray · optional | Untuk arrays bahasa saja. Trek yang tersedia dalam urutan permintaan; masing-masing memiliki ruas tunggal-trek terdaftar di atas. |
results[0].errorsarray · optional | Untuk arrays bahasa saja. Gagal bahasa dalam urutan permintaan. Kosong ketika setiap trek sukses. |
results[0].errors[].languageCodestring | Bahasa yang diminta gagal. |
results[0].errors[].codestring | language_unavailable ketika trek yang dipilih tidak ada; retrieval_failed ketika tidak dapat diunduh atau diurai. |
results[0].errors[].messagestring | Deskripsi kegagalan bahasa. |
Bidang di atas menggambarkan respon baku JSON. JSON, teks polos dan Markdown format.
Async mengembalikan satu pekerjaan penerimaan; batch kembali satu per video ID. Periksa setiap status pekerjaan dan ambil hasilnya menggunakan link yang dikembalikan.
Async & batch lifecycle
Submission mengembalikan tanda terima, bukan hasil. Async menciptakan satu pekerjaan; batch mengembalikan pekerjaan terpisah di queries[] untuk setiap permintaan diterima. Lacak dan ambil setiap pekerjaan secara independen.
Kirim ke data.flashdata.dev; membaca status pekerjaan dan hasil dari api.flashdata.dev dengan X-API-Key yang sama. Contoh dasar API terkait menggunakan Python dan cURL.
1. Simpan pekerjaan IDs
Simpan ruas permintaan sumber ini ketika beralih ke Async. Untuk Batch, masukkan setiap permintaan ke dalam daftar array dari objek JSON. Simpan setiap pekerjaan yang kembali ID.
2. Periksa status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: polling dengan penundaan dan rasa hormatRetry-Afterketika hadir.completed: Mengambil hasil.failed: memeriksajob.error.Baca job.status, bukan pengajuan status penerimaan.
Periksa status Python dan cURL
Status tugas API referensi3. Ambil hasil
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsSetelah selesai, otentikasi hasil dibaca, kemudian ambil penyimpanan 302 URL tanpa kunci API Anda. Simpan JSON dalam waktu penyelesaian 24.
Ambil hasil Python dan cURL · Format respons
Hasil download referensi API
Polling dan mengambil hasil yang sudah ada jangan mengkonsumsi kredit query. Pengungutan waktu pemungutan suara tidak membatalkan pekerjaan: menyimpan ID nya sebagai ganti mengirimkan duplikat pekerjaan yang dapat ditagih. Galat kode dan coba lagi perilaku.
Webhook penyelesaian
Berlangganan setiap kueri
Set callback_url pada tingkat atas permintaan async, atau didalam setiap query dalam batch, di luar params. Tak ada permintaan pendaftaran web-hook- terpisah yang diperlukan. permintaan Realtime tidak mengirim callbacks.
Gunakan publik HTTPS URL di port 443. FlashData POSTs pemberitahuan untuk setiap pekerjaan mencapai completed atau failed; peristiwa ini berisi taut, bukan hasil itu sendiri.
Mengakui dan memverifikasi
Kembali 2xx Setelah lama menerima acara itu. Deduplikasi oleh delivery_id, juga dikirim sebagai X-Delivery-Id. Redireksi tidak diikuti.
Gagal pengiriman coba ulang dengan backoff eksponensial, sampai 8 mencoba total dan paling banyak 24 jam setelah selesai. Tetap polling sebagai mundur.
Callbacks tidak ditandatangani. Konfirmasi tugas ID, status sumber dan terminal melalui titik akhir status yang terotentikasi sebelum memproses pemberitahuan. Pengiriman ID adalah untuk deduplikasi, bukan bukti keaslian.
Contoh acara webhook dan ruas
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_captions",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Ruas | Deskripsi |
|---|---|
delivery_idstring | Identifikasi pengiriman stabil. Pemberitahuan duplikat memakai nilai ini; ini juga dikirim dalam header X-Delivery-Id. |
idstring | Job ID. |
sourcestring | Sumber data yang diminta. |
statusstring | selesai atau gagal. |
linksarray | Status dan hasil link. Pemberitahuan tidak termasuk isi hasil atau kunci API. |
links[].relstring | diri atau hasil. |
links[].hrefstring | Manajemen Absolute API URL; otentikasi dengan kunci API Anda. |
links[].methodstring | GET. |
Bulk pemrosesan berkas
Upload satu video ID per baris dan membuat pekerjaan Bulk dengan sumber: youtube_captions. Pilihan bersama berlaku untuk setiap ID dalam berkas.
Opsi sumber: bahasa, otomatis. Menempatkan mereka dalam pilihan ketika menciptakan Bulk pekerjaan.
Ambil koleksi lengkap sebagai bagian hasil manifest dan gzip- terkompresi NDJSON. Sumber data juga dapat memberikan bagian hasil ke penyimpanan awan Anda dengan mengatur options.result_storage ketika membuat pekerjaan Bulk. Simpan manifes dan bagian dalam 24 jam setelah seluruh Bulk pekerjaan selesai.
Bulk memproses API · Python dan cURL · permintaan Batch JSON
Bangun Bulk alur kerja bagi sumber ini · Jeda, lanjutkan dan pulihkan
Galat saat pemulihan
Sebuah video dapat memiliki terjemahan otomatis tetapi tidak ada trek manual, atau kurang bahasa yang diminta Anda. Periksa ketersediaan judul menggunakan Metadata dan pilih bahasa dan asal-usul secara sengaja sebelum penyerahan baru.
Periksa bahasa judul yang tersedia dengan Metadata. Permintaan baru menggunakan kredit query; mengubah trek tidak mengubah pekerjaan yang ada.
Untuk otentikasi, keseimbangan, format persyaratan, dan rate-batasi kegagalan, gunakan referensi galat bersama. Tenggat pengiriman mungkin masih menciptakan suatu pekerjaan; periksa pekerjaan yang telah ada sebelum mencoba kembali.
Kesalahan dan kode status · Kapan untuk mencoba lagi · Batas rate
Panduan langkah-demi-langkah: Ambil taktimestamp takarir
Harga
| Rencana | Laju penggunaanper 1.000 permintaan standar | Berlangganan | Periode kredit yang disertakan setiap billing |
|---|---|---|---|
| Bayar sesuai penggunaan | US$0,50 | Tanpa biaya bulanan | Isi ulang sesuai kebutuhan |
| Micro | US$0,40 | US$49,00 / bulan | 1.000 kredit (US$50,00 dari penggunaan API) included ded |
| Starter | US$0,35 | US$199,00 / bulan | 4.000 kredit (US$200,00 dari penggunaan API) included ded |
| Pro | US$0,30 | US$499,00 / bulan | 10.000 kredit (US$500,00 dari penggunaan API) included ded |
| Scale | US$0,25 | US$999,00 / bulan | 20.000 kredit (US$1.000,00 dari penggunaan API) included ded |
| Business | US$0,20 | US$1.999,00 / bulan | 40.000 kredit (US$2.000,00 dari penggunaan API) included ded |
Satu paket akun. Kredit bersama untuk ketiga produk. Penggunaan yang tercakup dalam kredit paket tidak ditagih lagi.
Harga saat ini dan batas rencana