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 وإدارتها.

الاستخدام مع وكلاء الذكاء الاصطناعي

ثبّت حزمة felo-ai الكاملة لتزويد وكيل بميزة الترجمة النصية لـYouTube وكل مهارة Felo Skill أخرى متاحة. يكتشف المثبّت ديناميكيًا كل دليل حزمة يحتوي SKILL.md، لذا لا يعتمد على قائمة مهارات ثابتة. ثبّت كل المهارات المكتشفة في Codex ~/.codex/skills أو Claude Code ~/.claude/skills أو OpenClaw ~/.agents/skills أو Hermes Agent ~/.hermes/skills. استخدم دليل إعداد وكيل الذكاء الاصطناعي اليدوي لضبط مفتاح 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 أو 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، يعتمد اختيار لغة الترجمة النصية على التوفر في الخدمة اللاحقة.