Felo APIs

YouTube Subtitling API

Dapatkan sari kata YouTube dengan parameter bahasa dan cap masa pilihan.

GET/v2/youtube/subtitling

Pengesahan

Bearer API key

Jenis kandungan

Tidak diperlukan

Nota had kadar

Had khusus endpoint mungkin terpakai.

Web Fetch API

YouTube Subtitling API mengambil data sari kata berstruktur untuk video YouTube. Ia direka untuk ejen, alat analisis kandungan, produk pendidikan, indeks carian, dan aliran kerja yang memerlukan kandungan video dalam bentuk teks.

Endpoint

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

Pengesahan

Hantar kunci API anda dalam pengepala Authorization:

Authorization: Bearer YOUR_API_KEY

Lihat Panduan Pengesahan untuk butiran tentang mencipta dan mengurus kunci API.

Guna dengan Ejen AI

Pasang pakej lengkap felo-ai untuk memberikan Ejen sari kata YouTube dan setiap Felo Skill lain yang tersedia. Pemasang menemui secara dinamik setiap direktori pakej yang mengandungi SKILL.md, jadi ia tidak bergantung pada senarai Skill tetap. Pasang semua Skill yang ditemui dalam ~/.codex/skills Codex, ~/.claude/skills Claude Code, ~/.agents/skills OpenClaw, atau ~/.hermes/skills Hermes Agent. Gunakan panduan persediaan Ejen AI manual untuk konfigurasi dan pengesahan kunci API khusus platform.

Permintaan

Parameter Pertanyaan

Parameter	Jenis	Wajib	Lalai	Penerangan
`video_code`	string	Ya	-	ID video YouTube, seperti `dQw4w9WgXcQ`.
`language`	string	Tidak	-	Kod bahasa sari kata, seperti `en` atau `zh-CN`. Jika ditinggalkan, perkhidmatan hiliran memilih bahasa yang tersedia.
`with_time`	boolean	Tidak	`false`	Sama ada untuk menyertakan medan cap masa (`start` dan `duration`) bagi setiap item sari kata.

Perkhidmatan ini menggunakan mod tajuk dan transkrip penuh secara dalaman. Anda tidak perlu menghantar jenis fungsi atau parameter mod.

Respons

Respons Berjaya

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

Medan Respons

Medan	Jenis	Penerangan
`status`	string	Status respons. Biasanya `ok` untuk permintaan berjaya.
`message`	string atau null	Mesej tambahan. Biasanya `null` untuk permintaan berjaya.
`data.title`	string	Tajuk video YouTube.
`data.contents`	array	Senarai item sari kata.
`data.contents[].start`	number	Masa mula sari kata dalam saat. Dikembalikan apabila data cap masa tersedia, terutamanya apabila `with_time=true`.
`data.contents[].duration`	number	Tempoh sari kata dalam saat. Dikembalikan apabila data cap masa tersedia, terutamanya apabila `with_time=true`.
`data.contents[].text`	string	Kandungan teks sari kata.

Respons Ralat

Status HTTP	Kod Ralat	Penerangan	Tindakan Disyorkan
400	`YOUTUBE_SUBTITLING_FAILED`	Pengesahan permintaan gagal, video tidak wujud, sari kata tidak tersedia, atau perkhidmatan hiliran mengembalikan ralat sebelah klien.	Semak `video_code`, ketersediaan sari kata, dan `language`.
401	`UNAUTHORIZED`	Kunci API tiada, tidak sah, atau telah dibatalkan.	Sahkan kunci API dan pengepala kebenaran anda.
500	`YOUTUBE_SUBTITLING_FAILED`	Ralat perkhidmatan dalaman.	Cuba semula permintaan. Hubungi sokongan jika isu berterusan.
502	`YOUTUBE_SUBTITLING_FAILED`	Perkhidmatan sari kata YouTube hiliran gagal atau tidak tersedia.	Cuba semula kemudian.

Contoh

Permintaan Asas

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"

Sertakan Cap Masa

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

Sertakan Cap Masa 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"

Kes Penggunaan

Membolehkan ejen memahami video YouTube sebelum menjawab soalan.
Membina indeks teks boleh cari untuk kandungan video.
Menyediakan teks sumber untuk aliran kerja ringkasan atau terjemahan.
Memetakan nota atau petikan yang dijana kembali kepada cap masa.
Menganalisis video pendidikan atau penyelidikan tanpa memuat turun fail video.

Nota

API ini tidak memuat turun video atau audio.
Ia mengembalikan sari kata sedia ada. Ia tidak menjana sari kata untuk video yang tiada data sari kata.
Sesetengah video mungkin tiada sari kata, atau mungkin tidak menyediakan bahasa yang diminta.
Jika language ditinggalkan, pemilihan bahasa sari kata bergantung pada ketersediaan hiliran.