Felo APIs

YouTube Subtitling API

ঐচ্ছিক ভাষা ও timestamp প্যারামিটারসহ 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

প্রমাণীকরণ

Authorization header-এ আপনার API key পাঠান:

Authorization: Bearer YOUR_API_KEY

API key তৈরি ও পরিচালনার বিস্তারিত জানতে Authentication গাইড দেখুন।

AI এজেন্টের সাথে ব্যবহার

একটি Agent-কে YouTube সাবটাইটেলিং এবং অন্যান্য সব উপলব্ধ Felo Skill দিতে সম্পূর্ণ felo-ai প্যাকেজ ইনস্টল করুন। ইনস্টলার গতিশীলভাবে SKILL.md থাকা প্রতিটি প্যাকেজ ডিরেক্টরি আবিষ্কার করে, তাই এটি নির্দিষ্ট Skill তালিকার উপর নির্ভর করে না। আবিষ্কৃত সব Skill 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`। বাদ দিলে ডাউনস্ট্রিম সার্ভিস উপলব্ধ ভাষা বেছে নেয়।
`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 or null	অতিরিক্ত message। সফল অনুরোধে সাধারণত `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 key অনুপস্থিত, অবৈধ বা প্রত্যাহৃত।	আপনার API key ও authorization header যাচাই করুন।
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 বাদ দিলে সাবটাইটেল ভাষা নির্বাচন ডাউনস্ট্রিম উপলব্ধতার উপর নির্ভর করে।