Felo APIs

YouTube Subtitling API

اختیاری زبان اور ٹائم اسٹیمپ پیرامیٹرز کے ساتھ YouTube سب ٹائٹلز حاصل کریں۔

GET/v2/youtube/subtitling

تصدیق

Bearer API key

مواد کی قسم

درکار نہیں

ریٹ نوٹس

endpoint کے مخصوص حدود لاگو ہو سکتے ہیں۔

Web Fetch API

YouTube Subtitling API کسی YouTube ویڈیو کے لیے ساختہ سب ٹائٹل ڈیٹا حاصل کرتا ہے۔ یہ ایجنٹس، مواد کی تجزیہ کے ٹولز، تعلیمی مصنوعات، سرچ انڈیکسز اور اُن ورک فلوز کے لیے بنایا گیا ہے جنہیں ویڈیو کا مواد متن کی صورت میں درکار ہو۔

endpoint

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

تصدیق

اپنی API کلید Authorization ہیڈر میں بھیجیں:

Authorization: Bearer YOUR_API_KEY

API کلیدیں بنانے اور منظم کرنے کی تفصیلات کے لیے تصدیق کی گائیڈ دیکھیں۔

AI ایجنٹس کے ساتھ استعمال

ایجنٹ کو YouTube سب ٹائٹلنگ اور باقی تمام دستیاب Felo Skills دینے کے لیے مکمل felo-ai پیکج انسٹال کریں۔ انسٹالر SKILL.md رکھنے والی ہر پیکج ڈائریکٹری کو متحرک طور پر دریافت کرتا ہے، لہٰذا یہ کسی مقررہ Skill فہرست پر منحصر نہیں۔ دریافت شدہ تمام Skills کو Codex میں ~/.codex/skills، Claude Code میں ~/.claude/skills، OpenClaw میں ~/.agents/skills یا Hermes Agent میں ~/.hermes/skills پر انسٹال کریں۔ پلیٹ فارم کے مخصوص API کلید کنفیگریشن اور تصدیق کے لیے AI ایجنٹ کی دستی سیٹ اپ گائیڈ استعمال کریں۔

درخواست

Query Parameters

پیرامیٹر	قسم	لازمی	ڈیفالٹ	تفصیل
`video_code`	string	ہاں	-	YouTube ویڈیو ID، مثلاً `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 کلید اور authorization ہیڈر کی تصدیق کریں۔
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 نہ دیا جائے تو سب ٹائٹل کی زبان کا انتخاب ڈاؤن اسٹریم دستیابی پر منحصر ہے۔