डेवलपर दस्तावेज़ अंग्रेज़ी में प्रकाशित हैं। साइडबार आपकी चुनी हुई भाषा का अनुसरण करता है।

सहायता और बिलिंग

क्रेडिट, रेट लिमिट और एरर कैसे काम करते हैं — और अपग्रेड कैसे करें।

क्रेडिट और बिलिंग

  • ✅ केवल HTTP 200: पेड एंडपॉइंट्स पर हर सफल रिक्वेस्ट के लिए 1 क्रेडिट।
  • ❌ 4xx / 5xx एरर: कभी चार्ज नहीं होते — बिना चिंता रिट्राई करें।
  • ❌ रेट लिमिटेड (429): चार्ज नहीं होता।
  • ✅ मुफ़्त एंडपॉइंट्स: /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id} (पोलिंग), सभी /v1/library रीड्स।
  • 📦 पेज़ेटेड एंडपॉइंट्स: प्रति पेज 1 क्रेडिट (चैनल वीडियो, प्लेलिस्ट)।

प्लान: मुफ़्त 1,000 क्रेडिट · Pro 10,000 क्रेडिट/माह · मूल्य देखें।

रेट लिमिट

हर API Key प्रति मिनट 200 रिक्वेस्ट तक सीमित है। हर रिस्पॉन्स में रेट लिमिट हेडर होते हैं:

हेडरविवरण
X-RateLimit-Limitप्रति मिनट कुल अनुमत रिक्वेस्ट (200)
X-RateLimit-Remainingमौजूदा विंडो में शेष रिक्वेस्ट
X-RateLimit-Resetविंडो रीसेट का Unix टाइमस्टैम्प

सीमा पार होने पर API 429 लौटाता है साथ में Retry-After हेडर (सेकंड)।

एरर कोड

स्टेटसअर्थचार्ज?
200सफलताहाँ (पेड एंडपॉइंट्स)
400गलत रिक्वेस्ट / पैरामीटर नहींनहीं
401अमान्य या गायब API Keyनहीं
402क्रेडिट समाप्तनहीं
404वीडियो / चैनल / कैप्शन नहीं मिलानहीं
429रेट लिमिट पारनहीं
500आंतरिक सर्वर एररनहीं

एरर रिस्पॉन्स बॉडी

401 Unauthorized

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key" } }

402 क्रेडिट समाप्त

{ "error": { "code": "CREDITS_EXHAUSTED", "message": "You've run out of credits. Upgrade or top up." } }

404 नहीं मिला (कैप्शन नहीं)

{ "error": { "code": "NO_CAPTIONS", "message": "No captions available for this video" } }

429 रेट लिमिट

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// रिस्पॉन्स में यह हेडर भी होता है:  Retry-After: 12

सहायता