YouTube Transcript API

בקשה אחת, תמלול מלא. משלמים רק על הסרטונים שמושכים.

התחלה מהירה

1. התחברו וצרו מפתח API בלוח הבקרה של ה-API. תקבלו 10 קרדיטים חינם (5 תמלולים).
2. שלחו את המפתח בכותרת X-API-Key יחד עם כתובת YouTube או מזהה סרטון.
3. כשצריך עוד, קנו חבילת קרדיטים או הפעילו טעינה אוטומטית.

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: כתובת YouTube (קישור watch, youtu.be, shorts, embed או live). השתמשו בזה או ב-video_id.
• video_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 }
  ]
}

שגיאות

בדיקת יתרה

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

מחירים

כל תמלול עולה 2 קרדיטים. הקרדיטים לא פגים. מנויי Pro מקבלים 100 קרדיטים בונוס בכל חודש.

טעינה אוטומטית, תקציבים והתראות

• טעינה אוטומטית קונה חבילה בכרטיס השמור כשהיתרה יורדת מתחת לסף שבחרתם.
• תקציב טעינה חודשי מגביל כמה הטעינה האוטומטית יכולה להוציא, ומגבלת קרדיטים חודשית עוצרת בקשות כשמגיעים אליה.
• התראות במייל מודיעות כשהיתרה נמוכה, כשמגיעים ל-80% מהמגבלה החודשית או כשטעינה נכשלת.

מגבלות ושימוש הוגן

60 בקשות בדקה לכל מפתח, עד 5 מפתחות פעילים לחשבון. ה-API מחזיר כתוביות שכבר קיימות ב-YouTube; הוא לא מתמלל אודיו. אתם אחראים להשתמש בתמלולים בהתאם לזכויות בעלי הסרטונים ולתנאים של YouTube.

שאלות נפוצות

האם אשלם שוב על אותו סרטון?

כן, כל בקשה מוצלחת עולה 2 קרדיטים, אבל סרטונים חוזרים מוגשים מהמטמון שלנו תוך אלפיות שנייה.

מה קורה כשלסרטון אין כתוביות?

מקבלים שגיאת no_transcript ולא מנוכים קרדיטים.

האם הוא תואם לממשקי תמלול אחרים?

הבקשה והתשובה בנויות במבנה המקובל של url, lang ו-segments, כך שמעבר דורש בדרך כלל רק החלפת כתובת הבסיס והמפתח.