Felo APIs

YouTube Subtitling API

वैकल्पिक भाषा और timestamp पैरामीटर के साथ 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 key Authorization हेडर में भेजें:

Authorization: Bearer YOUR_API_KEY

API key बनाने और प्रबंधित करने के विवरण के लिए Authentication गाइड देखें।

AI Agent के साथ उपयोग करें

Agent को YouTube subtitling और हर अन्य उपलब्ध Felo Skill देने के लिए पूरा felo-ai पैकेज इंस्टॉल करें। इंस्टॉलर SKILL.md वाली हर पैकेज डायरेक्टरी को गतिशील रूप से खोजता है, इसलिए यह किसी स्थिर Skill सूची पर निर्भर नहीं है। सभी खोजी गई Skills को Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills या Hermes Agent ~/.hermes/skills में इंस्टॉल करें। प्लेटफ़ॉर्म-विशिष्ट API key कॉन्फ़िगरेशन और सत्यापन के लिए मैन्युअल AI Agent सेटअप गाइड उपयोग करें।

अनुरोध

Query पैरामीटर

पैरामीटर	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`video_code`	string	हां	-	YouTube वीडियो ID, जैसे `dQw4w9WgXcQ`।
`language`	string	नहीं	-	सबटाइटल भाषा कोड, जैसे `en` या `zh-CN`। छोड़ने पर downstream सेवा उपलब्ध भाषा चुनती है।
`with_time`	boolean	नहीं	`false`	हर सबटाइटल आइटम के लिए टाइमस्टैम्प फ़ील्ड (`start` और `duration`) शामिल करना है या नहीं।

सेवा आंतरिक रूप से पूर्ण title-and-transcript मोड उपयोग करती है। आपको function type या mode पैरामीटर पास करने की ज़रूरत नहीं है।

प्रतिक्रिया

सफल प्रतिक्रिया

{
  "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 स्टेटस	Error Code	विवरण	सुझाया गया कार्य
400	`YOUTUBE_SUBTITLING_FAILED`	अनुरोध validation विफल, वीडियो मौजूद नहीं है, सबटाइटल अनुपलब्ध हैं, या downstream सेवा ने client-side त्रुटि लौटाई।	`video_code`, सबटाइटल उपलब्धता और `language` जांचें।
401	`UNAUTHORIZED`	API key गुम, अमान्य या रद्द है।	अपनी API key और authorization हेडर सत्यापित करें।
500	`YOUTUBE_SUBTITLING_FAILED`	आंतरिक सेवा त्रुटि।	अनुरोध दोबारा प्रयास करें। समस्या बनी रहे तो सहायता से संपर्क करें।
502	`YOUTUBE_SUBTITLING_FAILED`	downstream 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 छोड़ा जाए, तो सबटाइटल भाषा का चयन downstream उपलब्धता पर निर्भर करता है।