Vidiome का सार्वजनिक REST API डेवलपर्स को पूर्ण वीडियो-टू-आर्टिकल पाइपलाइन को प्रोग्रामेटिक रूप से स्वचालित करने देता है - किसी ब्राउज़र की आवश्यकता नहीं, कोई मैन्युअल अपलोड नहीं। एक एकल POST /api/v1/articles अनुरोध किसी भी YouTube URL या वीडियो फ़ाइल से एक संरचित, SEO-अनुकूलित ब्लॉग आलेख लौटाता है।

यह ट्यूटोरियल एंडपॉइंट विनिर्देश, प्रमाणीकरण, कर्ल और नोड.जेएस में कोड उदाहरण, बैच प्रोसेसिंग और सीएमएस एकीकरण के लिए केस पैटर्न का उपयोग और एक स्वचालन वर्कफ़्लो आरेख को कवर करता है।

यह ट्यूटोरियल किसके लिए है

• सास डेवलपर्स ग्राहकों या आंतरिक उपकरणों के लिए सामग्री स्वचालन सुविधाओं का निर्माण कर रहे हैं
• सामग्री एजेंसियां प्रति सप्ताह 20+ वीडियो संसाधित कर रही हैं और उन्हें मैन्युअल वीडियोम उपयोग को समाप्त करने की आवश्यकता है
• प्लेटफ़ॉर्म टीमें वीडियो-टू-आर्टिकल को मौजूदा सीएमएस या सामग्री वर्कफ़्लो में एकीकृत कर रही हैं
• स्टार्टअप सामग्री अवसंरचना परत के रूप में Vidiome की क्षमताओं के शीर्ष पर निर्माण कर रहे हैं

यदि आप डेवलपर के बजाय एक व्यक्तिगत निर्माता हैं, तो विडिओम वेब ऐप तेज़ रास्ता है - यह ट्यूटोरियल विशेष रूप से प्रोग्रामेटिक एपीआई उपयोग के लिए है।

पूर्वावश्यकताएँ

• कम से कम स्टार्टर प्लान वाला एक वीडियोओम अकाउंट (एपीआई एक्सेस के लिए सशुल्क या ट्रायल प्लान की आवश्यकता होती है)
• आपकी वीडियोम एपीआई कुंजी (खाता सेटिंग्स → एपीआई कुंजी में पाई गई)
• HTTP REST API और या तो कर्ल या Node.js के साथ बुनियादी परिचितता

Vidiome साइनअप पर 120 निःशुल्क क्रेडिट देता है - आप एपीआई एकीकरण के लिए प्रतिबद्ध होने से पहले वेब ऐप वर्कफ़्लो का परीक्षण कर सकते हैं।

---

समापन बिंदु अवलोकन: POST /api/v1/लेख

Vidiome का आलेख जनरेशन समापन बिंदु एक वीडियो स्रोत और जनरेशन पैरामीटर स्वीकार करता है, फिर एक संपूर्ण आलेख ऑब्जेक्ट लौटाता है।

अनुरोध

पोस्ट करें https://vidiome.com/api/v1/articles
सामग्री-प्रकार: एप्लिकेशन/जेसन
प्राधिकरण: आपकी_एपीआई_कुंजी का वाहक

अनुरोध निकाय

{
  "स्रोत": {
    "प्रकार": "यूट्यूब_यूआरएल",
    "यूआरएल": "https://www.youtube.com/watch?v=XXXXXXXXXX"
  },
  "पीढ़ी": {
    "भाषा": "एन",
    "focus_keyword": "यूट्यूब वीडियो को ब्लॉग पोस्ट में कैसे बदलें",
    "आउटपुट_फ़ॉर्मेट": "मार्कडाउन"
  }
}

स्रोत वस्तु

फ़ील्ड	प्रकार	आवश्यक	विवरण
'प्रकार'	स्ट्रिंग	हाँ	"youtube_url" या "file_upload"
'यूआरएल'	स्ट्रिंग	यदि प्रकार = youtube_url	आवश्यक है संपूर्ण यूट्यूब वीडियो यूआरएल
फ़ाइल_आईडी	स्ट्रिंग	आवश्यक है यदि प्रकार = file_upload"	पूर्व /api/v1/files अपलोड से फ़ाइल आईडी

पीढ़ी वस्तु

फ़ील्ड	प्रकार	आवश्यक	विवरण
भाषा	स्ट्रिंग	हाँ	आईएसओ 639-1 कोड। समर्थित: एन, एफआर, ईएस, पीटी, डी, आरयू, हाय, यूके, आईडी, टीआर
फोकस_कीवर्ड	स्ट्रिंग	नहीं	लक्ष्य SEO कीवर्ड - H1 और मेटा संरेखण में सुधार करता है
आउटपुट_फॉर्मेट	स्ट्रिंग	नहीं	"मार्कडाउन" (डिफ़ॉल्ट) या "html"

प्रतिक्रिया

{
  "आईडी": "art_01HZXXX",
  "स्थिति": "पूर्ण",
  "created_at": "2026-05-15T10:23:41Z",
  "प्रसंस्करण_समय_सेकंड": 187,
  "क्रेडिट_प्रयुक्त": 12,
  "लेख": {
    "शीर्षक": "5 मिनट में YouTube वीडियो को ब्लॉग पोस्ट में कैसे बदलें",
    "meta_description": "Vidiome 5 मिनट से कम समय में किसी भी YouTube URL को एक संरचित SEO ब्लॉग पोस्ट में बदल देता है। 95%+ सटीकता पर व्हिस्पर प्रतिलेखन के साथ चरण-दर-चरण ट्यूटोरियल।",
    "सामग्री": "# YouTube वीडियो कैसे कनवर्ट करें...\n\n## आपको क्या चाहिए\n...",
    "शब्द_गणना": 1247,
    "भाषा": "एन",
    "focus_keyword": "YouTube वीडियो को ब्लॉग पोस्ट में कैसे बदलें"
  },
  "प्रतिलेख": {
    "पाठ": "सभी को नमस्कार, आज मैं आपको दिखाना चाहता हूं...",
    "सेगमेंट": [
      { "प्रारंभ": 0.0, "अंत": 4.2, "पाठ": "सभी को नमस्कार, आज मैं आपको दिखाना चाहता हूं" },
      ...
    ]
  }
}

स्थिति मान

स्थिति	मतलब
कतारबद्ध	अनुरोध स्वीकार कर लिया गया, प्रसंस्करण प्रारंभ नहीं हुआ
प्रसंस्करण	प्रतिलेखन और/या लेख निर्माण प्रगति पर है
पूर्ण	प्रतिक्रिया निकाय में आलेख तैयार
'विफल'	प्रसंस्करण त्रुटि - `त्रुटि' फ़ील्ड देखें

अतुल्यकालिक मतदान के लिए, लौटाई गई आईडी के साथ GET /api/v1/articles/{id} का उपयोग करें।

---

कोड उदाहरण

कर्ल

कर्ल -एक्स पोस्ट https://vidiome.com/api/v1/articles \
  -एच "सामग्री-प्रकार: एप्लिकेशन/जेसन" \
  -एच "प्राधिकरण: आपका_एपीआई_कुंजी धारक" \
  -डी '{
    "स्रोत": {
      "प्रकार": "यूट्यूब_यूआरएल",
      "यूआरएल": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    },
    "पीढ़ी": {
      "भाषा": "एन",
      "focus_keyword": "सामग्री पुनर्प्रयोजन रणनीति",
      "आउटपुट_फ़ॉर्मेट": "मार्कडाउन"
    }
  }'

पूरा करने के लिए मतदान:```बैश

प्रारंभिक प्रतिक्रिया से art_01HZXXX को आईडी से बदलें

कर्ल -एच "प्राधिकरण: आपका_एपीआई_कुंजी धारक"
https://vidiome.com/api/v1/articles/art_01HZXXX

### Node.js (लाएँ)

```जावास्क्रिप्ट
स्थिरांक VIDIOME_API_KEY = प्रक्रिया.env.VIDIOME_API_KEY;

async फ़ंक्शन जेनरेटआर्टिकल(youtubeUrl, focusKeyword, भाषा = 'en') {
  // चरण 1: आलेख निर्माण अनुरोध सबमिट करें
  स्थिरांक प्रतिक्रिया = प्रतीक्षा फ़ेच ('https://vidiome.com/api/v1/articles', {
    विधि: 'पोस्ट',
    शीर्षलेख: {
      'सामग्री-प्रकार': 'एप्लिकेशन/जेसन',
      'प्राधिकरण': `वाहक ${VIDIOME_API_KEY}`,
    },
    मुख्य भाग: JSON.stringify({
      स्रोत: {
        टाइप करें: 'यूट्यूब_यूआरएल',
        यूआरएल: यूट्यूबयूआरएल,
      },
      पीढ़ी: {
        भाषा,
        फोकस_कीवर्ड: फोकसकीवर्ड,
        आउटपुट_फॉर्मेट: 'मार्कडाउन',
      },
    }),
  });

  स्थिरांक कार्य = प्रतिक्रिया की प्रतीक्षा करें.json();

  अगर (!प्रतिक्रिया.ओके) {
    नई त्रुटि फेंकें(`विडियोम एपीआई त्रुटि: ${job.message}`);
  }

  // चरण 2: मतदान पूरा होने तक
  रिटर्न प्रतीक्षित पोलअनटिलकंप्लीट(जॉब.आईडी);
}

async फ़ंक्शन pollUntilComplete(articleId, maxAttempts = 30, अंतरालMs = 10000) {
  के लिए (मान लीजिए प्रयास = 0; प्रयास < maxAttempts; प्रयास++) {
    नए वादे की प्रतीक्षा करें(संकल्प => सेटटाइमआउट(संकल्प, अंतरालएम));

    स्थिरांक = प्रतीक्षा करें(`https://vidiome.com/api/v1/articles/${articleId}`, {
      शीर्षलेख: { 'प्राधिकरण': `वाहक ${VIDIOME_API_KEY}` },
    });

    स्थिरांक आलेख = प्रतीक्षा करें res.json();

    यदि (लेख.स्थिति === 'पूर्ण') {
      वापसी लेख;
    }

    यदि (लेख.स्थिति === 'विफल') {
      नई त्रुटि फेंकें(`आर्टिकल जनरेशन विफल: ${article.error}`);
    }

    कंसोल.लॉग(`[वीडियो] स्थिति: ${article.status} (प्रयास ${प्रयास + 1}/${maxAttempts})`);
  }

  नई त्रुटि फेंकें ('विडियोम: मतदान का समय समाप्त हो गया');
}

// उपयोग
स्थिरांक परिणाम = जनरेटआर्टिकल की प्रतीक्षा करें(
  'https://www.youtube.com/watch?v=XXXXXXXXXX',
  'वीडियो सामग्री का पुनरुत्पादन कैसे करें'
);

कंसोल.लॉग(परिणाम.लेख.शीर्षक);
कंसोल.लॉग(`शब्द गणना: ${result.article.word_count}`);
कंसोल.लॉग(`प्रयुक्त क्रेडिट: ${result.credits_used}`);
// फ़ाइल में लिखें, सीएमएस पर पुश करें, आदि।

---

स्वचालन वर्कफ़्लो आरेख

Vidiome का उपयोग करके एक विशिष्ट बैच प्रोसेसिंग पाइपलाइन के लिए पूर्ण स्वचालन आर्किटेक्चर यहां दिया गया है:

┌──────────────────────────── ────────────────────────────┐
│ वीडियो स्रोत परत │
│ यूट्यूब प्लेलिस्ट / आरएसएस फ़ीड / सीएमएस वीडियो लाइब्रेरी │
└──────────────────────┬──── ────────────────────────────┘
                       │ वीडियो यूआरएल/फ़ाइल संदर्भ
                       ▼
┌──────────────────────────── ────────────────────────────┐
│ आर्केस्ट्रा परत │
│ क्रॉन जॉब / वेबहुक ट्रिगर / n8n / Make.com │
│ - डिडुप्लीकेशन (पहले से संसाधित यूआरएल छोड़ें) │
│ - दर सीमित करना (एपीआई क्रेडिट बजट का सम्मान करें) │
│ - कतार प्रबंधन │
└──────────────────────┬──── ────────────────────────────┘
                       │ पोस्ट/एपीआई/वी1/लेख
                       ▼
┌──────────────────────────── ────────────────────────────┐
│ वीडियोम एपीआई │
│ 1. व्हिस्पर प्रतिलेखन (60-सेकंड भाग, 95%+ एसीसी।) │
│ 2. एलएलएम लेख निर्माण (संरचना + एसईओ) │
│ 3. रिटर्न: शीर्षक, मेटा, सामग्री (एमडी/एचटीएमएल), प्रतिलेख │
└──────────────────────┬──── ────────────────────────────┘
                       │ पूर्ण लेख वस्तु
                       ▼
┌──────────────────────────── ────────────────────────────┐
│ पोस्ट-प्रोसेसिंग परत │
│ - मानव समीक्षा कतार (वैकल्पिक लेकिन अनुशंसित) │
│ - आंतरिक लिंक इंजेक्शन (मौजूदा पोस्ट में लिंक जोड़ें)│
│ - फ़ीचर्ड छवि असाइनमेंट │
│ - स्कीमा मार्कअप इंजेक्शन (अनुच्छेद JSON-LD) │
└──────────────────────┬──── ────────────────────────────┘
                       │ प्रकाशित-तैयार लेख
                       ▼
┌──────────────────────────── ────────────────────────────┐
│ सीएमएस / प्लेटफार्म │
│ वर्डप्रेस (रेस्ट एपीआई) / घोस्ट (एडमिन एपीआई) │
│ वेबफ्लो सीएमएस / कंटेंटफुल / सैनिटी / कस्टम डीबी │
└──────────────────────────── ────────────────────────────┘

---

उपयोग के मामले

किसी YouTube चैनल का बैच प्रसंस्करण

संपूर्ण YouTube चैनल के बैक-कैटलॉग को एक बार में संसाधित करें:```जावास्क्रिप्ट async फ़ंक्शन प्रोसेसYouTubeChannel(channelVideoUrls, विकल्प = {}) { स्थिरांक { भाषा = 'एन', संगामिति = 3, // अधिकतम समानांतर Vidiome अनुरोध देरीएमएस = 2000, // बैचों के बीच देरी (दर सीमित) } = विकल्प;

स्थिरांक परिणाम = [];

// समवर्ती के बैचों में प्रक्रिया के लिए (मान लीजिए i = 0; i < चैनलवीडियोयूआरएल.लंबाई; i += संगामिति) { स्थिरांक बैच = चैनलवीडियोयूआरएल.स्लाइस(i, i + संगामिति);

स्थिरांक बैच परिणाम = प्रतीक्षा करें Promise.allSettled(
  बैच.मैप(यूआरएल => जेनरेटआर्टिकल(यूआरएल, '', भाषा))
);

परिणाम.पुश(...बैचपरिणाम);
कंसोल.लॉग(`संसाधित ${Math.min(i + concurrency,channelVideoUrls.length)}/${channelVideoUrls.length} वीडियो`);

यदि (i + संगामिति < चैनलवीडियोयूआरएल.लंबाई) {
  नए वादे का इंतजार करें (संकल्प => सेटटाइमआउट (संकल्प, देरीएम));
}

}

वापसी परिणाम; }

3 समवर्ती अनुरोधों पर संसाधित 100 वीडियो वाला एक चैनल: कुल लगभग 100 मिनट (प्रति वीडियो औसत 3 मिनट × 100 ÷ 3 समवर्ती)।

### सीएमएस एकीकरण (वर्डप्रेस उदाहरण)

Vidiome द्वारा लेख लौटाने के बाद, उसे REST API के माध्यम से सीधे वर्डप्रेस पर भेजें:

```जावास्क्रिप्ट
async फ़ंक्शन पब्लिशटूवर्डप्रेस(vidiomeArticle, wpConfig) {
  स्थिरांक { साइटयूआरएल, उपयोगकर्ता नाम, ऐपपासवर्ड } = wpConfig;
  स्थिरांक क्रेडेंशियल = बफ़र.फ्रॉम(`${उपयोगकर्ता नाम}:${appPassword}`).toString('base64');

  स्थिरांक प्रतिक्रिया = प्रतीक्षा फ़ेच(`${siteUrl}/wp-json/wp/v2/posts`, {
    विधि: 'पोस्ट',
    शीर्षलेख: {
      'सामग्री-प्रकार': 'एप्लिकेशन/जेसन',
      'प्राधिकरण': `बुनियादी ${क्रेडेंशियल्स}`,
    },
    मुख्य भाग: JSON.stringify({
      शीर्षक: vidiomeArticle.article.title,
      सामग्री: vidiomeArticle.article.content, // WP के लिए अनुशंसित HTML प्रारूप
      अंश: vidiomeArticle.article.meta_description,
      स्थिति: 'ड्राफ्ट', // मानव समीक्षा के लिए हमेशा पहले ड्राफ्ट करें
    }),
  });

  वापसी प्रतीक्षा प्रतिक्रिया.json();
}

बहुभाषी बैच: एक वीडियो, 10 भाषाएँ

सभी 10 समर्थित भाषाओं में एक साथ एक ही लेख तैयार करें:

const SUPPORTED_LANGUAGES = ['en', 'fr', 'es', 'pt', 'de', 'ru', 'hi', 'uk', 'id', 'tr'];

async फ़ंक्शन जनरेट बहुभाषी(youtubeUrl, focusKeywords = {}) {
  स्थिरांक अनुरोध = SUPPORTED_LANGUAGES.map(lang =>
    जनरेटआर्टिकल(
      यूट्यूबयूआरएल,
      फोकसकीवर्ड्स[लैंग] || फोकसकीवर्ड्स['एन'] || '',
      लैंग
    )
  );

  // सभी 10 भाषाओं को समानांतर में चलाएँ
  स्थिरांक परिणाम = प्रतीक्षा Promise.allSettled(अनुरोध);

  परिणाम लौटाएं। कम करें ((एसीसी, परिणाम, सूचकांक) => {
    स्थिरांक लैंग = SUPPORTED_LANGUAGES[सूचकांक];
    यदि (परिणाम.स्थिति === 'पूर्ण') {
      एसीसी[लैंग] = परिणाम.मान;
    }अन्यथा{
      कंसोल.त्रुटि(`${lang} के लिए विफल:`, परिणाम.कारण);
    }
    वापसी एसीसी;
  }, {});
}

यह लगभग 5-8 मिनट (समानांतर प्रसंस्करण) में एक ही वीडियो के 10 भाषा संस्करण तैयार करता है।

---

दर सीमाएँ और क्रेडिट बजटिंग

योजना	एपीआई दर सीमा	क्रेडिट/माह
निःशुल्क (120 क्रेडिट)	2 अनुरोध/मिनट	120 (एकमुश्त)
स्टार्टर	10 अनुरोध/मिनट	प्रति योजना
प्रो	30 अनुरोध/मिनट	प्रति योजना
एजेंसी	60 अनुरोध/मिनट	प्रति योजना

क्रेडिट खपत: प्रत्येक लेख पीढ़ी वीडियो की लंबाई के आधार पर 10-15 क्रेडिट का उपयोग करती है। 10 मिनट का वीडियो लगभग 10 क्रेडिट का उपयोग करता है; 60 मिनट का वीडियो लगभग 15 क्रेडिट का उपयोग करता है।

बैच प्रोसेसिंग के लिए बजट अनुशंसा: एक रूढ़िवादी बजट के रूप में प्रति वीडियो सील (वीडियो_ड्यूरेशन_मिनट / 4) + 10 क्रेडिट का अनुमान लगाएं।

---

त्रुटि प्रबंधन

Vidiome API मानक HTTP स्थिति कोड का उपयोग करता है:

कोड	मतलब	कार्रवाई
200	सफलता	प्रक्रिया प्रतिक्रिया
400	अमान्य अनुरोध (खराब यूआरएल, असमर्थित भाषा, आदि)	अनुरोध पैरामीटर ठीक करें
401	अमान्य या अनुपलब्ध API कुंजी	प्राधिकरण शीर्षलेख की जाँच करें
402	अपर्याप्त क्रेडिट	खाता टॉप अप करें या बैच आकार कम करें
429	दर सीमा पार हो गई	घातीय बैकऑफ़ लागू करें
500	सर्वर त्रुटि	घातीय बैकऑफ़ के साथ पुनः प्रयास करें (अधिकतम 3 प्रयास)

---

अक्सर पूछे जाने वाले प्रश्न

क्या Vidiome का API फ़ाइल अपलोड का समर्थन करता है, या केवल YouTube URL का?

Vidiome का API YouTube URL और प्रत्यक्ष फ़ाइल अपलोड दोनों का समर्थन करता है। फ़ाइल अपलोड के लिए, पहले अपनी वीडियो फ़ाइल (MP4, MOV, या WebM, 2GB तक) के साथ POST /api/v1/files पर कॉल करें, एक file_id प्राप्त करें, फिर उस file_id को "type": "file_upload" के साथ POST /api/v1/articles पर पास करें। यह यूट्यूब पर होस्ट नहीं किए गए वीडियो - वेबिनार रिकॉर्डिंग, लूम वीडियो, आंतरिक प्रशिक्षण सामग्री और वीमियो-होस्ट किए गए वीडियो को संसाधित करने के लिए उपयोगी है।### मैं एपीआई के माध्यम से लंबे वीडियो (60+ मिनट) कैसे प्रबंधित करूं?

Vidiome एपीआई के माध्यम से 4 घंटे तक वीडियो प्रोसेस करता है। 60 मिनट से अधिक के वीडियो के लिए, एपीआई प्रतिक्रिया डिफ़ॉल्ट रूप से अतुल्यकालिक है - आपको तुरंत एक नौकरी आईडी प्राप्त होगी, फिर स्थिति पूरा होने तक हर 15-30 सेकंड में GET /api/v1/articles/{id} पोल करें। 90 मिनट का वीडियो आमतौर पर 6-9 मिनट में संसाधित होता है। विडिओम के 60 सेकंड के ऑडियो चंकिंग आर्किटेक्चर का मतलब है कि बहुत लंबे वीडियो में भी टाइमआउट की समस्या नहीं आती है।

क्या मतदान के स्थान पर कोई वेबहुक विकल्प है?

हाँ। Vidiome लेख पूरा करने के लिए वेबहुक कॉलबैक का समर्थन करता है। अपने अंतिम बिंदु की ओर इशारा करते हुए अपने POST अनुरोध निकाय में एक "webhook_url" फ़ील्ड जोड़ें, और प्रसंस्करण पूरा होने पर Vidiome पूर्ण लेख ऑब्जेक्ट के साथ एक POST अनुरोध भेजेगा - जिससे मतदान की आवश्यकता समाप्त हो जाएगी। वेबहुक पेलोड GET /api/v1/articles/{id} प्रतिक्रिया प्रारूप के समान है।

---

अगले चरण

• यूट्यूब वीडियो को वेब ऐप के माध्यम से मैन्युअल रूप से कनवर्ट करें →
• वेबिनार को 5 लेखों में पुनर्व्यवस्थित करें →
• विडियोम मुफ़्त आज़माएं - 120 क्रेडिट, किसी कार्ड की आवश्यकता नहीं →