YouTube Subtitling API

YouTube Subtitling API lấy dữ liệu phụ đề có cấu trúc cho một video YouTube. API này được thiết kế cho agent, công cụ phân tích nội dung, sản phẩm giáo dục, chỉ mục tìm kiếm và các quy trình cần nội dung video dưới dạng văn bản.

Endpoint

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

Xác thực

Gửi khóa API của bạn trong header Authorization:

Authorization: Bearer YOUR_API_KEY

Xem Hướng dẫn xác thực để biết chi tiết về cách tạo và quản lý khóa API.

Dùng với AI Agent

Cài gói felo-ai đầy đủ để cung cấp cho một Agent khả năng phụ đề YouTube và mọi Felo Skill khác hiện có. Trình cài đặt tự động khám phá mọi thư mục gói có chứa SKILL.md, nên nó không phụ thuộc vào một danh sách Skill cố định. Hãy cài mọi Skill được phát hiện vào Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills hoặc Hermes Agent ~/.hermes/skills. Dùng hướng dẫn thiết lập AI Agent thủ công để biết cách cấu hình khóa API và xác minh riêng cho từng nền tảng.

Yêu cầu

Tham số truy vấn

Dịch vụ dùng chế độ tiêu đề và bản ghi đầy đủ ở bên trong. Bạn không cần truyền tham số loại chức năng hay chế độ.

Phản hồi

Phản hồi thành công

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

Các trường phản hồi

Phản hồi lỗi

Ví dụ

Yêu cầu cơ bản

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

Yêu cầu một ngôn ngữ cụ thể

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

Bao gồm dấu thời gian

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

Bao gồm dấu thời gian cho một ngôn ngữ cụ thể

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"

Trường hợp sử dụng

• Giúp một agent hiểu video YouTube trước khi trả lời câu hỏi.
• Xây dựng chỉ mục văn bản có thể tìm kiếm cho nội dung video.
• Chuẩn bị văn bản nguồn cho các quy trình tóm tắt hoặc dịch.
• Đối chiếu ghi chú hoặc trích dẫn được tạo với dấu thời gian.
• Phân tích video giáo dục hoặc nghiên cứu mà không cần tải tệp video.

Ghi chú

• API này không tải video hay âm thanh.
• Nó trả về phụ đề hiện có. Nó không tạo phụ đề cho các video không có dữ liệu phụ đề.
• Một số video có thể không có phụ đề, hoặc không cung cấp ngôn ngữ được yêu cầu.
• Nếu bỏ qua language, việc chọn ngôn ngữ phụ đề phụ thuộc vào sự khả dụng ở hạ nguồn.