واجهة API لنصوص YouTube

طلب واحد، والنص الكامل بين يديك. ادفع فقط مقابل الفيديوهات التي تجلبها.

بداية سريعة

سجّل الدخول وأنشئ مفتاح API من لوحة API. ستحصل على 10 أرصدة مجانية (5 نصوص).
أرسل المفتاح في ترويسة X-API-Key مع رابط YouTube أو معرّف الفيديو.
اشترِ حزمة أرصدة عند الحاجة، أو فعّل الشحن التلقائي.

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: sv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'

الطلب

POST /api/v1/transcript

url: رابط YouTube (رابط watch أو youtu.be أو shorts أو embed أو live). استخدم هذا أو video_id.
video_id: معرّف فيديو YouTube المكوّن من 11 حرفًا.
lang: لغة الترجمة المفضلة، مثل en أو de أو pt-BR. الافتراضي en. إذا لم تتوفر هذه اللغة يُعاد المسار الأصلي ويذكر الرد لغته الفعلية.
format: json (مقاطع بطوابع زمنية، افتراضي) أو text أو srt.

import requests

response = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": "sv_live_your_key"},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=120,
)
print(response.json()["text"])

const response = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: { "X-API-Key": process.env.SUMVIDEO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();

الرد

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "is_generated": false,
  "credits_used": 2,
  "credits_remaining": 98,
  "segments": [
    { "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
  ]
}

الأخطاء

401	invalid_key	مفتاح API مفقود أو خاطئ أو ملغى.
400	invalid_input	تعذّرت قراءة الرابط أو معرّف الفيديو.
402	insufficient_credits	رصيدك أقل من رصيدين.
402	budget_exceeded	وصلت إلى الحد الشهري للأرصدة الذي حددته.
404	no_transcript	لا يحتوي الفيديو على ترجمة، أو أنه خاص أو بث مباشر أو محذوف. لا يُحتسب.
429	rate_limited	أكثر من 60 طلبًا في الدقيقة بمفتاح واحد. انتظر عدد الثواني في Retry-After.
502	upstream_error	لم يستجب YouTube في الوقت المناسب. لا يُحتسب، أعد المحاولة لاحقًا.

تحقق من رصيدك

curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"

الأسعار

كل نص يكلّف رصيدين. الأرصدة لا تنتهي صلاحيتها. يحصل مشتركو Pro على 100 رصيد إضافي كل شهر.

الحزمة	الأرصدة	النصوص	السعر	لكل نص
Starter	100	50	‏4.49 US$	‏0.090 US$
Pro	500	250	‏13.99 US$	‏0.056 US$
Scale	2,000	1,000	‏37.99 US$	‏0.038 US$
Business	5,000	2,500	‏74.99 US$	‏0.030 US$

الشحن التلقائي والميزانيات والتنبيهات

يشتري الشحن التلقائي حزمة ببطاقتك المحفوظة عندما ينخفض رصيدك عن حد تختاره.
تحدد ميزانية الشحن الشهرية ما يمكن أن ينفقه الشحن التلقائي، ويوقف الحد الشهري للأرصدة الطلبات عند بلوغه.
تنبهك رسائل البريد عند انخفاض الرصيد، أو عند بلوغ 80% من الحد الشهري، أو عند فشل عملية شحن.

الحدود والاستخدام العادل

60 طلبًا في الدقيقة لكل مفتاح، وحتى 5 مفاتيح نشطة لكل حساب. تُعيد الواجهة الترجمات الموجودة بالفعل على YouTube، ولا تفرّغ الصوت. أنت مسؤول عن استخدام النصوص بما يحترم حقوق أصحاب الفيديوهات وشروط YouTube.

الأسئلة الشائعة

هل أدفع مجددًا مقابل الفيديو نفسه؟: نعم، كل طلب ناجح يكلّف رصيدين، لكن الفيديوهات المكررة تُخدم من ذاكرتنا المؤقتة خلال أجزاء من الثانية.
ماذا يحدث عندما لا يحتوي الفيديو على ترجمة؟: تتلقى الخطأ no_transcript ولا يُخصم أي رصيد.
هل هي متوافقة مع واجهات النصوص الأخرى؟: يتبع الطلب والرد البنية الشائعة url وlang وsegments، لذا فالانتقال يعني عادة تغيير الرابط الأساسي والمفتاح فقط.