API رونوشت یوتیوب
یک درخواست بفرستید، رونوشت کامل بگیرید. فقط برای ویدیوهایی که دریافت می‌کنید پول بدهید.
کلید API رایگان خود را بگیریدشروع سریع
- وارد شوید و در داشبورد API یک کلید API بسازید. ۱۰ اعتبار رایگان (۵ رونوشت) می‌گیرید.
- کلید را در سرآیند X-API-Key همراه با نشانی یوتیوب یا شناسهٔ ویدیو بفرستید.
- هر وقت بیشتر لازم داشتید بستهٔ اعتبار بخرید یا شارژ خودکار را روشن کنید.
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: نشانی یوتیوب (پیوند watch، youtu.be، shorts، embed یا live). از این یا video_id استفاده کنید.video_id: شناسهٔ ۱۱ نویسه‌ای ویدیوی یوتیوب.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 | بیش از ۶۰ درخواست در دقیقه با یک کلید. به اندازهٔ ثانیه‌های Retry-After صبر کنید. |
| 502 | upstream_error | یوتیوب به‌موقع پاسخ نداد. هزینه‌ای کسر نمی‌شود، بعداً دوباره امتحان کنید. |
بررسی موجودی
curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"قیمت‌ها
هر رونوشت ۲ اعتبار است. اعتبارها هرگز منقضی نمی‌شوند. مشترکان Pro هر ماه ۱۰۰ اعتبار هدیه می‌گیرند.
| بسته | اعتبار | رونوشت | قیمت | برای هر رونوشت |
|---|---|---|---|---|
| Starter | ۱۰۰ | ۵۰ | $۴٫۴۹ | $۰٫۰۹۰ |
| Pro | ۵۰۰ | ۲۵۰ | $۱۳٫۹۹ | $۰٫۰۵۶ |
| Scale | ۲٬۰۰۰ | ۱٬۰۰۰ | $۳۷٫۹۹ | $۰٫۰۳۸ |
| Business | ۵٬۰۰۰ | ۲٬۵۰۰ | $۷۴٫۹۹ | $۰٫۰۳۰ |
شارژ خودکار، بودجه و هشدارها
- شارژ خودکار وقتی موجودی از آستانه‌ای که انتخاب کرده‌اید کمتر شود، با کارت ذخیره‌شده یک بسته می‌خرد.
- بودجهٔ ماهانهٔ شارژ سقف هزینهٔ شارژ خودکار را تعیین می‌کند و سقف اعتبار ماهانه با رسیدن به آن درخواست‌ها را متوقف می‌کند.
- هشدارهای ایمیلی وقتی موجودی کم است، وقتی به ۸۰٪ سقف ماهانه می‌رسید یا وقتی شارژ ناموفق است، خبرتان می‌کنند.
محدودیت‌ها و استفادهٔ منصفانه
۶۰ درخواست در دقیقه برای هر کلید، حداکثر ۵ کلید فعال برای هر حساب. API زیرنویس‌هایی را برمی‌گرداند که از قبل در یوتیوب هستند و صدا را رونویسی نمی‌کند. مسئولیت استفاده از رونوشت‌ها مطابق حقوق صاحبان ویدیوها و شرایط یوتیوب با شماست.
پرسش‌های متداول
- آیا برای همان ویدیو دوباره پول می‌دهم؟
- بله، هر درخواست موفق ۲ اعتبار است، اما ویدیوهای تکراری در چند میلی‌ثانیه از حافظهٔ پنهان ما پاسخ داده می‌شوند.
- اگر ویدیو زیرنویس نداشته باشد چه می‌شود؟
- خطای no_transcript می‌گیرید و هیچ اعتباری کسر نمی‌شود.
- آیا با APIهای رونوشت دیگر سازگار است؟
- درخواست و پاسخ از ساختار رایج url، lang و segments پیروی می‌کنند، پس جابه‌جایی معمولاً فقط به تغییر نشانی پایه و کلید نیاز دارد.