تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

مرجع API

YouTube Captions API

احصل على مفتاح API

استرجع ترجمات YouTube كنص ذي طوابع زمنية ونص كامل. تُختار ترجمات رافع الفيديو افتراضيًا.

إنشاء طلب

المعرّف المكوّن من 11 حرفًا في رابط الفيديو، وليس الرابط الكامل.

إتركْ فارغاً لتَحْاوُل، ثمّ يَدْعمُ، ويُعيدُ مسارَ واحد. أو الدخول إلى رمز واحد أو حتى 10 رموز مميزة مُنفصلة عن طريق الشيوعيين

مسار التكوين auto
POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_captions",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "language": "en",
        "auto": False,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
النتائج في رد HTTPX-API-Key authentication

البارامترات

أرسل source و video_id على المستوى الأعلى خيارات المصادر تنتمي إلى params. ويمكن إغفال الحقول الاختيارية.

نص الطلب

sourcestring / مطلوب
جاهزون إلى youtube_captions.
video_idstring / مطلوب
معرّف فيديو YouTube من 11 محرفًا، مثل FUfGcZ092b0. يقبل الحروف والأرقام والشرطات السفلية والواصلات.
بالضبط 11 الشخصياتالتقصير: غير محدد
الشكل المقبول^[A-Za-z0-9_-]{11}$
paramsobject / اختياري
Settings for this request.
التقصير: {}
callback_urlstring · nullable / اختياري
لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.
التقصير: غير محدد

اختيار القدرات

params.languagestring | array / اختياري
Omit for English (en-orig, then en). بالسياراتtrueكل شفرة تُحاولُ مسارها الأوّل، ثمّ الرمز المطلوب. رموز أوتوماتيكياتfalse إبقي على وجه الدقة. تطلب شركة آريز لغات متميزة من طراز 1–10.
التقصير: en-orig → en
params.autoboolean / اختياري
وتختار شركة true أغطية من طراز YouTube-generated؛ وتختار شركة false أغطية مجهزة بالشحنات. ويختار هذا المصدر، وليس الكشف عن اللغة، أو وصفاً جديداً.
true أو falseالتقصير: false

استجابة

Realtime Returns status: done. اقرأ الناتج المصدري في results[0]; usage.credits سجل التهمة.

قراءة أجزاء من النص الاستيعابي مع start/end في الثواني fullText للنص المنضم. languageCode و isAutoGenerated ابلغ عن المسار المختار

اقرأ النتيجة

وفّر ردّ شركة JSON الناجح على أنها response.json. احفظ هذا read-response.py و اركضوا بيثون read-response.py. إنها تستخدم فقط Pythonمكتبة عادية ولا تقدم طلباً جديداً

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {
    "tracks": result.get("tracks", [result]),
    "errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))

احذف language لتفضيل en-orig ثم الرجوع إلى en، مع إعادة مسار واحد. عند auto=true، يفضّل كل رمز مطلوب مساره -orig ثم الرمز العادي؛ وتبقى طلبات -orig الصريحة وauto=false مطابقة تمامًا. تجرّب المصفوفات كل لغة مطلوبة وتعيد tracks وerrors بالترتيب. يحدّد languageCode المسار المختار؛ ويُضاف requestedLanguageCode عندما يختلف.

عند طلب مصفوفة لغات، راجع errors لمعرفة المسارات التي تعذّر جلبها. إذا لم يُجلب أي مسار، يفشل الطلب وتُردّ الأرصدة المحجوزة. يفشل الطلب أيضًا عند تعذّر استخراج الفيديو أو انتهاء المهلة.

(أ) التخلف عن الدفع بالسيارات إلى false لاستبقاء المزودين بالشحنات المزودة بأجهزة تحميل. المجموعة true للقبضات التلقائية. The API لا تبدل أبداً مصادر الإستيلاء

تقرأ API ترجمات YouTube الموجودة؛ ولا تنشئ نصوصًا جديدة. تحتوي الاستجابة الافتراضية على مقاطع JSON موحّدة؛ ويتيح Accept اختيار النص العادي، بينما يختار X-Respond-With: markdown صيغة Markdown. قد تكون languageName بقيمة null؛ وتُحفظ توقيتات المقاطع.

لغات متعددة

إرسال صفيفة لغوية لتلقي المسارات والأخطاء في كل لغة. ويظهر هذا المثال أن الإنكليزية متاحة والإسبانية غير متاحة.

طلب
{
  "source": "youtube_captions",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": false
  }
}
results[0]
{
  "videoId": "jNQXAC9IVRw",
  "isAutoGenerated": false,
  "tracks": [
    {
      "videoId": "jNQXAC9IVRw",
      "languageCode": "en",
      "languageName": null,
      "isAutoGenerated": false,
      "segments": [
        {
          "start": 0,
          "end": 1.5,
          "text": "Hello world."
        }
      ],
      "fullText": "Hello world."
    }
  ],
  "errors": [
    {
      "languageCode": "es",
      "code": "language_unavailable",
      "message": "Uploader-provided subtitles not available for language: es"
    }
  ]
}
جميع مجالات الاستجابة
الميدانالوصف
sourcestringالمصدر المطلوب من شركة API.
statusstringتم عندما يتكلل الطلب بالنجاح.
created_atstringوقت إنشاء الاستجابة في شكل ISO 8601.
usage.creditsnumberإئتمانات مُقيدة على الطلب، بناءً على خطتك.
results[0].videoIdstringالفيديو المطلوب ID.
results[0].languageCodestringرمز المسار الفعلي المختار، مثل النسيج.
results[0].languageNamestring · nullableاسم العرض اللغوي عندما يكون متاحا
results[0].requestedLanguageCodestring · optionalالرمز المطلوب عندما يختلف عن languageCode، مثل en عند اختيار en-orig.
results[0].isAutoGeneratedbooleanوسواء تم توليد الأسر المختارة تلقائياً.
results[0].segmentsarrayأجزاء من القدرات حسب الترتيب الزمني.
results[0].segments[].startnumberتبدأ القطعة في ثواني.
results[0].segments[].endnumberنهاية الفصل في ثواني.
results[0].segments[].textstringرسالة استطلاعية
results[0].fullTextstringوانضمت جميع نصوص الأجزاء إلى محضر.
results[0].tracksarray · optionalلصفائف اللغات فقط. (ب) المسارات المتاحة حسب الطلب؛ ولكل من هذه المسارات الحقول ذات المسار الواحد الواردة أعلاه.
results[0].errorsarray · optionalلصفائف اللغات فقط. اللغات المعطلة حسب الطلب. فارغة عندما ينجح كل المسار
results[0].errors[].languageCodestringاللغة المطلوبة التي فشلت.
results[0].errors[].codestringتظهر language_unavailable عندما لا يوجد المسار المحدد، وretrieval_failed عندما يتعذر تنزيله أو تحليله.
results[0].errors[].messagestringDescription of the language failure.

وتصف المجالات المذكورة أعلاه رد شركة JSON. JSON, plain text and Markdown formats.

Async Returns one job receipt; batch return one per أشرطة فيديو ID. تحققي من حالة كل وظيفة وإسترجاع نتائجها باستخدام الوصلات العائدة

Async ' batch lifecycle

يعيد الإرسال إيصالًا وليس نتائج. ينشئ Async مهمة واحدة؛ ويعيد batch مهمة مستقلة في queries[] لكل سؤال مقبول تتبع كل وظيفة واسترجاعها بشكل مستقل.

Submit to data.flashdata.dev; قراءــة مركز العمل والنتائج api.flashdata.dev مع نفس X-API-Key. وتستخدم الأمثلة الأساسية للزدحام الزكسكسيك ذات الصلة API Python و cURL.

  1. 1. وفّر الوظيفة IDs

    أبقوا حقول طلب هذا المصدر عند التحول إلى Async. وبالنسبة إلى Batch، وضع كل طلب داخل مجموعة الاستفسارات من جسم JSON. انقذوا كل عمل ID.

    Async Request and receipt · Batch

  2. 2. حالة التحقق

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: استطلاع مع التأخير والاحترام Retry-After عندما تكون حاضراً completed: تحقيق النتائج failed: التفتيش job.error.

    اقرأ job.statusليس حالة إيصال المعلومات.

    مركز التحقير: Python و cURL

    المرجعي API
  3. 3. نتائج الرسم

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    بعد الإكمال، توثّق النتيجة على النحو التالي، ثمّ تُحضر مخزن 302 URL بدون مفتاحك API. وفّر الرقم JSON في غضون ساعات الإنجاز من تاريخ الـ 24.

    نتائج المشاهدة: Python و cURL · تنسيقات الاستجابة

    Result download API reference

ولا تستهلك السياسات وتحقق النتائج القائمة أي تنازلات للأسئلة. ولا يلغى وقت الاقتراع هذا العمل: فإبقاء مقره ID بدلاً من تقديم عمل مكرر قابل للتعديل. شفرات الرعب وسلوك الاعادة.

إشعارات Webhook عند الاكتمال

Subscribe per query

المجموعة callback_url على أعلى مستوى لطلب الأسينك، أو داخل كل استفسار في دفعة، في الخارج params. ولا يلزم طلب تسجيل منفصل على الشبكة العالمية. ولا تُرسل طلبات شركة Realtime ردوداً.

استخدم عنوان HTTPS عامًا على المنفذ 443. ترسل FlashData إشعار POST لكل مهمة تصل إلى completed أو failed; The event contains links, not the result itself.

الاعتراف والتحقق

العودة 2xx بعد قبول الحدث بشكل مكثف. مُتَوَجَّل delivery_id, كما أُرسلت X-Delivery-Id. لا تتبع إعادة التوجيه.

عمليات التسليم الفاشلة تُعاد مع التراجع المفاجئ، حتى 8 مجموع المحاولات على الأكثر 24 بعد ساعات من الانتهاء. استمر في الاقتراع كتراجع

النداءات غير موقعة. تأكد من معرّف المهمة ومصدرها وحالتها النهائية باستخدام نقطة نهاية الوضع الموثقة قبل تجهيز الإخطار. التسليم ID هو للتحلل، وليس إثبات صحة.

مناسبة وميادين على الشبكة العالمية
الإخطار بالإكمال التوضيحي
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_captions",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
الميدانالوصف
delivery_idstringمعرّف تسليم ثابت. امنع تكرار الإشعارات باستخدام هذه القيمة؛ وتُرسل أيضًا في ترويسة X-Delivery-Id.
idstringوظيفة(ب) ID.
sourcestringطلب مصدر بيانات.
statusstringاكتملت أو فشلت
linksarrayوصلات الوضع والنتائج. ولا تشمل الإخطارات محتوى النتائج أو مفتاحاً من طراز API.
links[].relstringذاتي أو نتائج.
links[].hrefstringعنوان URL كامل لواجهة الإدارة؛ صادِق باستخدام مفتاح API.
links[].methodstringGET.

عقد كامل على الشبكة العالمية وقيود URL

تجهيز ملفات Bulk

تحميل شريط فيديو واحد من طراز ID لكل خط وإنشاء وظيفة من طراز Bulk مع المصدر: youtube_captions. وتنطبق الخيارات المشتركة على كل شركة ID في الملف.

خيارات المصادر: اللغة الآلية. وضعهم في خيارات عند إنشاء وظيفة Bulk.

استرجع المجموعة المكتملة كملف manifest وأجزاء نتائج NDJSON مضغوطة بـ gzip. يمكن لمصادر البيانات أيضًا تسليم أجزاء النتائج إلى تخزينك السحابي بضبط options.result_storage عند إنشاء مهمة Bulk. وفّر البيان وقطعه في غضون ساعات العمل التي تنجزها شركة 24 بعد أن اكتملت جميع وظائف شركة Bulk.

Bulk processing API ; Python and cURL · Batch JSON

بناء تدفق عمل من طراز Bulk لهذا المصدر · وقف، واستئناف واستعادة

التعافي من الأخطاء

يمكن أن يكون للفيديو أغطية تلقائية لكن لا يوجد مسار يدوي أو يفتقر إلى لغتك المطلوبة تحقق من مدى توافر الخصم باستخدام البيانات الوصفية واختيار اللغة والأصل عمدا قبل تقديم جديد.

التحقق من لغات الإقفال المتاحة مع البيانات الوصفية. ويستخدم طلب جديد ائتمانات التساؤل؛ ولا يعدل تغيير المسار وظيفة قائمة.

وللتوثيق، والتوازن، وطريقة الطلب، والإخفاقات في الحد الأقصى للمعدلات، تستخدم مرجع الخطأ المشترك. وقد يكون الوقت المتاح لتقديم الطلبات قد أدى إلى خلق وظيفة؛ والتحقق من العمل القائم قبل إعادة التجريب.

الأخطاء ورموز الحالة · متى يُعيدُ النظر · الحد الأقصى للمعدل

دليل الخطوة خطوة: استرجاع الأزمنة المأخوذة

الأسعار

الخططمعدلات الاستخداملكل 1,000 طلب قياسيالاشتراكاتتشمل الأرصدة الدائنة لكل فترة من فترات إعداد الفواتير
الدفع حسب الاستخدام‏0.50 US$بلا رسوم شهريةأضف رصيدًا عند الحاجة
Micro‏0.40 US$‏49.00 US$ / الشهر1,000 credits (‏50.00 US$ of API usage) included
Starter‏0.35 US$‏199.00 US$ / الشهر4,000 credits (‏200.00 US$ of API usage) included
Pro‏0.30 US$‏499.00 US$ / الشهر10,000 credits (‏500.00 US$ of API usage) included
Scale‏0.25 US$‏999.00 US$ / الشهر20,000 credits (‏1,000.00 US$ of API usage) included
Business‏0.20 US$‏1,999.00 US$ / الشهر40,000 credits (‏2,000.00 US$ of API usage) included

خطة واحدة للحساب. رصيد مشترك للمنتجات الثلاثة. لا تُفرض رسوم مرة أخرى على الاستخدام المغطى بالرصيد المضمّن.

الأسعار والحدود الحالية للخطة