Felo APIs

YouTube Subtitling API

Ambil subtitel YouTube dengan parameter bahasa dan stempel waktu opsional.

GET/v2/youtube/subtitling

Autentikasi

Bearer API key

Tipe konten

Tidak wajib

Catatan batas laju

Batas khusus endpoint dapat berlaku.

Web Fetch API

YouTube Subtitling API mengambil data subtitle terstruktur untuk video YouTube. API ini dirancang untuk agen, alat analisis konten, produk pendidikan, indeks pencarian, dan alur kerja yang memerlukan konten video dalam bentuk teks.

Endpoint

GET https://openapi.felo.ai/v2/youtube/subtitling

Autentikasi

Kirim kunci API Anda di header Authorization:

Authorization: Bearer YOUR_API_KEY

Lihat Panduan Autentikasi untuk detail tentang membuat dan mengelola kunci API.

Penggunaan dengan Agen AI

Pasang paket felo-ai lengkap untuk memberi Agen subtitle YouTube dan setiap Felo Skill lain yang tersedia. Installer menemukan setiap direktori paket yang berisi SKILL.md secara dinamis, sehingga tidak bergantung pada daftar Skill yang tetap. Pasang semua Skill yang ditemukan di Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills, atau Hermes Agent ~/.hermes/skills. Gunakan panduan penyiapan Agen AI manual untuk konfigurasi dan verifikasi kunci API yang spesifik per platform.

Permintaan

Parameter Kueri

Parameter	Tipe	Wajib	Default	Deskripsi
`video_code`	string	Ya	-	ID video YouTube, seperti `dQw4w9WgXcQ`.
`language`	string	Tidak	-	Kode bahasa subtitle, seperti `en` atau `zh-CN`. Jika dihilangkan, layanan downstream memilih bahasa yang tersedia.
`with_time`	boolean	Tidak	`false`	Apakah menyertakan field stempel waktu (`start` dan `duration`) untuk setiap item subtitle.

Layanan ini menggunakan mode judul-dan-transkrip lengkap secara internal. Anda tidak perlu meneruskan parameter tipe fungsi atau mode.

Respons

Respons Berhasil

{
  "status": "ok",
  "message": null,
  "data": {
    "title": "Example Video Title",
    "contents": [
      {
        "start": 0.32,
        "duration": 14.26,
        "text": "Subtitle text"
      }
    ]
  }
}

Field Respons

Field	Tipe	Deskripsi
`status`	string	Status respons. Biasanya `ok` untuk permintaan yang berhasil.
`message`	string or null	Pesan tambahan. Biasanya `null` untuk permintaan yang berhasil.
`data.title`	string	Judul video YouTube.
`data.contents`	array	Daftar item subtitle.
`data.contents[].start`	number	Waktu mulai subtitle dalam detik. Dikembalikan saat data stempel waktu tersedia, terutama ketika `with_time=true`.
`data.contents[].duration`	number	Durasi subtitle dalam detik. Dikembalikan saat data stempel waktu tersedia, terutama ketika `with_time=true`.
`data.contents[].text`	string	Konten teks subtitle.

Respons Error

Status HTTP	Kode Error	Deskripsi	Tindakan yang Disarankan
400	`YOUTUBE_SUBTITLING_FAILED`	Validasi permintaan gagal, video tidak ada, subtitle tidak tersedia, atau layanan downstream mengembalikan error sisi klien.	Periksa `video_code`, ketersediaan subtitle, dan `language`.
401	`UNAUTHORIZED`	Kunci API tidak ada, tidak valid, atau sudah dicabut.	Verifikasi kunci API dan header otorisasi Anda.
500	`YOUTUBE_SUBTITLING_FAILED`	Error layanan internal.	Coba ulang permintaan. Hubungi dukungan jika masalah berlanjut.
502	`YOUTUBE_SUBTITLING_FAILED`	Layanan subtitle YouTube downstream gagal atau tidak tersedia.	Coba lagi nanti.

Contoh

Permintaan Dasar

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Meminta Bahasa Tertentu

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer YOUR_API_KEY"

Menyertakan Stempel waktu

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Menyertakan Stempel waktu untuk Bahasa Tertentu

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=zh-CN&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kasus Penggunaan

Memungkinkan agen memahami video YouTube sebelum menjawab pertanyaan.
Membangun indeks teks yang dapat dicari untuk konten video.
Menyiapkan teks sumber untuk alur kerja peringkasan atau penerjemahan.
Memetakan catatan atau kutipan yang dihasilkan kembali ke stempel waktu.
Menganalisis video pendidikan atau riset tanpa mengunduh file video.

Catatan

API ini tidak mengunduh video atau audio.
API ini mengembalikan subtitle yang sudah ada. API tidak membuat subtitle untuk video yang tidak memiliki data subtitle.
Beberapa video mungkin tidak memiliki subtitle, atau tidak menyediakan bahasa yang diminta.
Jika language dihilangkan, pemilihan bahasa subtitle bergantung pada ketersediaan downstream.