API ถอดความ YouTube
ส่งคำขอเดียว ได้ข้อความถอดความทั้งหมด จ่ายเฉพาะวิดีโอที่คุณดึง
รับคีย์ API ฟรีของคุณเริ่มต้นอย่างรวดเร็ว
- ลงชื่อเข้าใช้และสร้างคีย์ API ในแดชบอร์ด API คุณจะได้รับ 10 เครดิตฟรี (5 การถอดความ)
- ส่งคีย์ในส่วนหัว X-API-Key พร้อม URL ของ YouTube หรือ ID วิดีโอ
- ซื้อแพ็กเครดิตเมื่อต้องการเพิ่ม หรือเปิดการเติมเงินอัตโนมัติ
curl -X POST https://sum.video/api/v1/transcript \
-H "X-API-Key: sv_live_your_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'คำขอ
POST /api/v1/transcript
url: URL ของ YouTube (ลิงก์ watch, youtu.be, shorts, embed หรือ live) ใช้ค่านี้หรือ video_idvideo_id: ID วิดีโอ YouTube 11 ตัวอักษรlang: ภาษาคำบรรยายที่ต้องการ เช่น en, de หรือ pt-BR ค่าเริ่มต้นคือ en หากไม่มีภาษานั้น จะส่งแทร็กต้นฉบับกลับมาและการตอบกลับจะระบุภาษาจริงformat: json (ส่วนพร้อมเวลา ค่าเริ่มต้น), text หรือ srt
import requests
response = requests.post(
"https://sum.video/api/v1/transcript",
headers={"X-API-Key": "sv_live_your_key"},
json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
timeout=120,
)
print(response.json()["text"])const response = await fetch("https://sum.video/api/v1/transcript", {
method: "POST",
headers: { "X-API-Key": process.env.SUMVIDEO_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();การตอบกลับ
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"is_generated": false,
"credits_used": 2,
"credits_remaining": 98,
"segments": [
{ "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
]
}ข้อผิดพลาด
| 401 | invalid_key | ไม่มีคีย์ API คีย์ไม่ถูกต้อง หรือถูกเพิกถอน |
| 400 | invalid_input | ไม่สามารถอ่าน URL หรือ ID วิดีโอได้ |
| 402 | insufficient_credits | ยอดเงินของคุณต่ำกว่า 2 เครดิต |
| 402 | budget_exceeded | คุณใช้ถึงขีดจำกัดเครดิตรายเดือนที่ตั้งไว้แล้ว |
| 404 | no_transcript | วิดีโอไม่มีคำบรรยาย หรือเป็นวิดีโอส่วนตัว กำลังถ่ายทอดสด หรือถูกลบ ไม่คิดเงิน |
| 429 | rate_limited | มากกว่า 60 คำขอต่อนาทีต่อคีย์ รอ Retry-After วินาที |
| 502 | upstream_error | YouTube ไม่ตอบกลับทันเวลา ไม่คิดเงิน ลองใหม่ภายหลัง |
ตรวจสอบยอดเงิน
curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"ราคา
การถอดความแต่ละครั้งใช้ 2 เครดิต เครดิตไม่มีวันหมดอายุ สมาชิก Pro ได้รับโบนัส 100 เครดิตทุกเดือน
| แพ็ก | เครดิต | การถอดความ | ราคา | ต่อการถอดความ |
|---|---|---|---|---|
| Starter | 100 | 50 | US$4.49 | US$0.090 |
| Pro | 500 | 250 | US$13.99 | US$0.056 |
| Scale | 2,000 | 1,000 | US$37.99 | US$0.038 |
| Business | 5,000 | 2,500 | US$74.99 | US$0.030 |
เติมเงินอัตโนมัติ งบประมาณ และการแจ้งเตือน
- การเติมเงินอัตโนมัติจะซื้อแพ็กด้วยบัตรที่บันทึกไว้เมื่อยอดเงินต่ำกว่าเกณฑ์ที่คุณเลือก
- งบประมาณการเติมเงินรายเดือนจำกัดยอดที่การเติมเงินอัตโนมัติใช้ได้ และขีดจำกัดเครดิตรายเดือนจะหยุดคำขอเมื่อถึงขีดจำกัด
- การแจ้งเตือนทางอีเมลจะบอกคุณเมื่อยอดเงินต่ำ เมื่อใช้ถึง 80% ของขีดจำกัดรายเดือน หรือเมื่อการเติมเงินล้มเหลว
ขีดจำกัดและการใช้งานอย่างเป็นธรรม
60 คำขอต่อนาทีต่อคีย์ สูงสุด 5 คีย์ที่ใช้งานอยู่ต่อบัญชี API ส่งคืนคำบรรยายที่มีอยู่แล้วบน YouTube ไม่ได้ถอดเสียงจากเสียง คุณมีหน้าที่ใช้ข้อความถอดความให้สอดคล้องกับสิทธิ์ของเจ้าของวิดีโอและข้อกำหนดของ YouTube
คำถามที่พบบ่อย
- ฉันต้องจ่ายอีกครั้งสำหรับวิดีโอเดิมหรือไม่
- ใช่ ทุกคำขอที่สำเร็จใช้ 2 เครดิต แต่วิดีโอที่ขอซ้ำจะตอบจากแคชของเราในระดับมิลลิวินาที
- จะเกิดอะไรขึ้นเมื่อวิดีโอไม่มีคำบรรยาย
- คุณจะได้รับข้อผิดพลาด no_transcript และไม่มีการหักเครดิต
- เข้ากันได้กับ API ถอดความอื่นหรือไม่
- คำขอและการตอบกลับใช้รูปแบบ url, lang และ segments ที่ใช้กันทั่วไป การย้ายมาใช้จึงมักแค่เปลี่ยน URL หลักและคีย์