Felo APIs
YouTube Subtitling API
קבלו כתוביות YouTube עם פרמטרים אופציונליים של שפה וחתימת זמן.
/v2/youtube/subtitlingאימות
Bearer API key
סוג תוכן
לא נדרש
הערות תעריף
ייתכנו מגבלות ספציפיות ל-endpoint.
ה-YouTube Subtitling API מביא נתוני כתוביות מובנים עבור סרטון YouTube. הוא מיועד לסוכנים, לכלי ניתוח תוכן, למוצרי חינוך, לאינדקסים של חיפוש ולתהליכים שצריכים תוכן וידאו כטקסט.
Endpoint
GET https://openapi.felo.ai/v2/youtube/subtitlingאימות
שלחו את מפתח ה-API שלכם בכותרת Authorization:
Authorization: Bearer YOUR_API_KEYראו את מדריך האימות לפרטים על יצירת מפתחות API וניהולם.
שימוש עם סוכני AI
התקינו את החבילה המלאה felo-ai כדי להעניק לסוכן כתוביות YouTube וכל Felo Skill זמין אחר. המתקין מגלה באופן דינמי כל תיקיית חבילה שמכילה SKILL.md, כך שהוא אינו תלוי ברשימת Skills קבועה. התקינו את כל ה-Skills שהתגלו ב-Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills או Hermes Agent ~/.hermes/skills. השתמשו במדריך ההגדרה הידנית לסוכני AI לתצורת מפתח ה-API ולאימות הייחודיים לפלטפורמה.
בקשה
פרמטרי שאילתה
| פרמטר | סוג | חובה | ברירת מחדל | תיאור |
|---|---|---|---|---|
video_code | string | כן | - | מזהה סרטון 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 or 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 ואת כותרת האימות. |
| 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"מקרי שימוש
- לאפשר לסוכן להבין סרטון YouTube לפני שהוא עונה על שאלות.
- לבנות אינדקס טקסט שניתן לחפש בו עבור תוכן וידאו.
- להכין טקסט מקור לתהליכי סיכום או תרגום.
- למפות הערות או ציטוטים שנוצרו חזרה לחותמות זמן.
- לנתח סרטוני חינוך או מחקר בלי להוריד את קובץ הווידאו.
הערות
- ה-API הזה אינו מוריד וידאו או אודיו.
- הוא מחזיר כתוביות קיימות. הוא אינו יוצר כתוביות עבור סרטונים שאין להם נתוני כתוביות.
- ייתכן שלסרטונים מסוימים אין כתוביות, או שהם אינם מספקים את השפה המבוקשת.
- אם
languageמושמט, בחירת שפת הכתוביות תלויה בזמינות במורד הזרם.