# YouTube Subtitling API

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

Halaman ini mendokumentasikan API Felo `/v2` yang sedia ada, menggunakan **kelayakan akaun Felo dan peraturan kredit Pro**. Sama ada kredit ditolak bergantung pada [operasi](https://openapi.felo.ai/ms/docs/faq/billing-and-credits.md#peraturan-kredit-mengikut-keupayaan-v2). Untuk panggilan baki platform, pilih [titik akhir Felo OpenAPI](https://openapi.felo.ai/ms/docs/api-reference/openapi/overview.md) 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

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

## Pengesahan

Hantar kunci API anda dalam pengepala `Authorization`:

```http
Authorization: Bearer YOUR_API_KEY
```

Lihat [Panduan Pengesahan](https://openapi.felo.ai/ms/docs/authentication.md) 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](https://openapi.felo.ai/ms/docs/felo-skills.md) untuk konfigurasi kunci API dan pengesahan khusus platform.

## Permintaan

### Parameter Pertanyaan

| Parameter | Jenis | Diperlukan | Lalai | Penerangan |
|-----------|------|----------|---------|-------------|
| `video_code` | string | Ya | - | ID video YouTube, seperti `dQw4w9WgXcQ`. |
| `language` | string | Tidak | - | Kod bahasa sari kata, seperti `en` atau `zh-CN`. Jika tidak dinyatakan, perkhidmatan huluan memilih bahasa yang tersedia. |
| `with_time` | boolean | Tidak | `false` | Sama 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

```json
{
  "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

| Medan | Jenis | Penerangan |
|-------|------|-------------|
| `status` | string | Status respons. Biasanya `ok` untuk permintaan berjaya. |
| `message` | string or 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. Dipulangkan apabila data cap masa tersedia, terutamanya apabila `with_time=true`. |
| `data.contents[].duration` | number | Tempoh sari kata dalam saat. Dipulangkan 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 huluan memulangkan ralat sebelah klien. | Semak `video_code`, ketersediaan sari kata, dan `language`. |
| 401 | `UNAUTHORIZED` | Kunci API hilang, tidak sah, atau dibatalkan. | Sahkan kunci API dan pengepala pengesahan anda. |
| 500 | `YOUTUBE_SUBTITLING_FAILED` | Ralat perkhidmatan dalaman. | Cuba semula permintaan. Hubungi sokongan jika isu berterusan. |
| 502 | `YOUTUBE_SUBTITLING_FAILED` | Perkhidmatan sari kata YouTube huluan gagal atau tidak tersedia. | Cuba lagi kemudian. |

## Contoh

### Permintaan Asas

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

### Minta Bahasa Tertentu

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

### Sertakan Cap Masa

```bash
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

```bash
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.
