Felo APIs

YouTube Subtitling API

ดึงคำบรรยาย YouTube พร้อมพารามิเตอร์ภาษาและเวลาแบบไม่บังคับ

GET/v2/youtube/subtitling

การยืนยันตัวตน

Bearer API key

ประเภทเนื้อหา

ไม่จำเป็น

หมายเหตุเรื่องข้อจำกัด

อาจมีข้อจำกัดเฉพาะของ endpoint

Web Fetch API

YouTube Subtitling API ดึงข้อมูลคำบรรยายแบบมีโครงสร้างสำหรับวิดีโอ YouTube ออกแบบมาสำหรับ Agent เครื่องมือวิเคราะห์เนื้อหา ผลิตภัณฑ์เพื่อการศึกษา ดัชนีการค้นหา และเวิร์กโฟลว์ที่ต้องการเนื้อหาวิดีโอในรูปข้อความ

Endpoint

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

การรับรองความถูกต้อง

ส่งคีย์ API ใน header Authorization:

Authorization: Bearer YOUR_API_KEY

ดูคู่มือการรับรองความถูกต้องสำหรับรายละเอียดการสร้างและจัดการคีย์ API

ใช้กับ AI Agent

ติดตั้งแพ็กเกจ felo-ai ที่ครบถ้วนเพื่อให้ Agent ใช้การทำคำบรรยาย YouTube และ Felo Skill อื่น ๆ ที่มีให้ใช้ทั้งหมด ตัวติดตั้งจะค้นหาไดเรกทอรีแพ็กเกจทุกไดเรกทอรีที่มี SKILL.md แบบไดนามิก จึงไม่ขึ้นอยู่กับรายการ Skill แบบตายตัว ให้ติดตั้ง Skill ทั้งหมดที่ค้นพบใน Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills หรือ Hermes Agent ~/.hermes/skills ใช้คู่มือการตั้งค่า AI Agent ด้วยตนเองสำหรับการกำหนดค่าคีย์ API และการตรวจสอบเฉพาะแพลตฟอร์ม

คำขอ

พารามิเตอร์คิวรี

พารามิเตอร์	ชนิด	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
`video_code`	string	ใช่	-	ID วิดีโอ YouTube เช่น `dQw4w9WgXcQ`
`language`	string	ไม่	-	รหัสภาษาของคำบรรยาย เช่น `en` หรือ `zh-CN` หากละเว้น บริการปลายทางจะเลือกภาษาที่มีให้ใช้
`with_time`	boolean	ไม่	`false`	จะรวมฟิลด์เวลาประทับ (`start` และ `duration`) สำหรับแต่ละรายการคำบรรยายหรือไม่

บริการใช้โหมดชื่อเรื่องและถอดความแบบเต็มภายใน คุณไม่จำเป็นต้องส่งชนิดฟังก์ชันหรือพารามิเตอร์โหมด

การตอบกลับ

การตอบกลับที่สำเร็จ

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

ฟิลด์ของการตอบกลับ

ฟิลด์	ชนิด	คำอธิบาย
`status`	string	สถานะการตอบกลับ โดยปกติเป็น `ok` สำหรับคำขอที่สำเร็จ
`message`	string หรือ null	ข้อความเพิ่มเติม โดยปกติเป็น `null` สำหรับคำขอที่สำเร็จ
`data.title`	string	ชื่อวิดีโอ YouTube
`data.contents`	array	รายการคำบรรยาย
`data.contents[].start`	number	เวลาเริ่มของคำบรรยายเป็นวินาที ส่งกลับเมื่อมีข้อมูลเวลาประทับ โดยเฉพาะเมื่อ `with_time=true`
`data.contents[].duration`	number	ระยะเวลาของคำบรรยายเป็นวินาที ส่งกลับเมื่อมีข้อมูลเวลาประทับ โดยเฉพาะเมื่อ `with_time=true`
`data.contents[].text`	string	เนื้อหาข้อความของคำบรรยาย

การตอบกลับข้อผิดพลาด

สถานะ HTTP	รหัสข้อผิดพลาด	คำอธิบาย	การดำเนินการที่แนะนำ
400	`YOUTUBE_SUBTITLING_FAILED`	การตรวจสอบคำขอล้มเหลว วิดีโอไม่มีอยู่ คำบรรยายไม่พร้อมใช้งาน หรือบริการปลายทางส่งข้อผิดพลาดฝั่งไคลเอนต์	ตรวจสอบ `video_code` ความพร้อมของคำบรรยาย และ `language`
401	`UNAUTHORIZED`	คีย์ API หายไป ไม่ถูกต้อง หรือถูกเพิกถอน	ตรวจสอบคีย์ API และ header การรับรองความถูกต้องของคุณ
500	`YOUTUBE_SUBTITLING_FAILED`	ข้อผิดพลาดภายในบริการ	ลองส่งคำขออีกครั้ง ติดต่อฝ่ายสนับสนุนหากยังเกิดขึ้นต่อเนื่อง
502	`YOUTUBE_SUBTITLING_FAILED`	บริการคำบรรยาย YouTube ปลายทางล้มเหลวหรือไม่พร้อมใช้งาน	ลองใหม่ภายหลัง

ตัวอย่าง

คำขอพื้นฐาน

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

ขอภาษาที่ระบุ

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

รวมเวลาประทับ

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

รวมเวลาประทับสำหรับภาษาที่ระบุ

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"

กรณีการใช้งาน

ให้ Agent เข้าใจวิดีโอ YouTube ก่อนตอบคำถาม
สร้างดัชนีข้อความที่ค้นหาได้สำหรับเนื้อหาวิดีโอ
เตรียมข้อความต้นฉบับสำหรับเวิร์กโฟลว์การสรุปหรือการแปล
เชื่อมโยงบันทึกหรือข้อความอ้างอิงที่สร้างขึ้นกลับไปยังเวลาประทับ
วิเคราะห์วิดีโอเพื่อการศึกษาหรือการวิจัยโดยไม่ต้องดาวน์โหลดไฟล์วิดีโอ

หมายเหตุ

API นี้ไม่ดาวน์โหลดวิดีโอหรือเสียง
ส่งกลับคำบรรยายที่มีอยู่ ไม่ได้สร้างคำบรรยายสำหรับวิดีโอที่ไม่มีข้อมูลคำบรรยาย
วิดีโอบางรายการอาจไม่มีคำบรรยาย หรืออาจไม่มีภาษาที่ร้องขอ
หากละเว้น language การเลือกภาษาของคำบรรยายขึ้นอยู่กับความพร้อมใช้งานของบริการปลายทาง