Felo API PlatformFelo API Platform

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.

Halaman ini mendokumentasikan API Felo /v2 yang sedia ada, menggunakan kelayakan akaun Felo dan peraturan kredit Pro. Sama ada kredit ditolak bergantung pada operasi. Untuk panggilan baki platform, pilih titik akhir Felo OpenAPI yang disokong; bentuk permintaan dan respons boleh berbeza.

API Sarikata YouTube 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 sebagai teks.

Titik Akhir

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.

Gunakan dengan Ejen AI

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

Permintaan

Parameter Pertanyaan

ParameterJenisDiperlukanLalaiPenerangan
video_codestringYa-ID video YouTube, seperti dQw4w9WgXcQ.
languagestringTidak-Kod bahasa sari kata, seperti en atau zh-CN. Jika tidak dinyatakan, perkhidmatan huluan memilih bahasa yang tersedia.
with_timebooleanTidakfalseSama ada hendak menyertakan medan cap masa (start dan duration) untuk setiap item sari kata.

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

Respons

Respons Berjaya

{
  "status": 200,
  "code": "OK",
  "request_id": "example-request-id",
  "data": {
    "title": "Example Video Title",
    "contents": [
      {
        "start": 0.32,
        "duration": 14.26,
        "text": "Subtitle text"
      }
    ]
  }
}

Medan Respons

MedanJenisPenerangan
statusstringStatus respons. Biasanya ok untuk permintaan berjaya.
messagestring or nullMesej tambahan. Biasanya null untuk permintaan berjaya.
data.titlestringTajuk video YouTube.
data.contentsarraySenarai item sari kata.
data.contents[].startnumberMasa mula sari kata dalam saat. Dipulangkan apabila data cap masa tersedia, terutamanya apabila with_time=true.
data.contents[].durationnumberTempoh sari kata dalam saat. Dipulangkan apabila data cap masa tersedia, terutamanya apabila with_time=true.
data.contents[].textstringKandungan teks sari kata.

Respons Ralat

Status HTTPKod RalatPeneranganTindakan Disyorkan
400YOUTUBE_SUBTITLING_FAILEDPengesahan permintaan gagal, video tidak wujud, sari kata tidak tersedia, atau perkhidmatan huluan memulangkan ralat sebelah klien.Semak video_code, ketersediaan sari kata, dan language.
401UNAUTHORIZEDKunci API hilang, tidak sah, atau dibatalkan.Sahkan kunci API dan pengepala pengesahan anda.
500YOUTUBE_SUBTITLING_FAILEDRalat perkhidmatan dalaman.Cuba semula permintaan. Hubungi sokongan jika isu berterusan.
502YOUTUBE_SUBTITLING_FAILEDPerkhidmatan sari kata YouTube huluan gagal atau tidak tersedia.Cuba lagi kemudian.

Contoh

Permintaan Asas

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

Minta 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

  • Bantu ejen memahami video YouTube sebelum menjawab soalan.
  • Bina indeks teks yang boleh dicari untuk kandungan video.
  • Sediakan teks sumber untuk aliran kerja ringkasan atau terjemahan.
  • Pautkan nota atau petikan yang dijana semula kepada cap masa.
  • Analisis video pendidikan atau penyelidikan tanpa memuat turun fail video.

Nota

  • API ini tidak memuat turun video atau audio.
  • Ia memulangkan sari kata sedia ada. Ia tidak menjana sari kata untuk video yang tidak mempunyai data sari kata.
  • Sesetengah video mungkin tiada sari kata, atau mungkin tidak menyediakan bahasa yang diminta.
  • Jika language tidak dinyatakan, pemilihan bahasa sari kata bergantung pada ketersediaan huluan.

Perlukan bantuan?