Youtube वीडियो को ऑडियो API के साथ काम करना

आपको इस सप्ताह कुछ विशेष YouTube वीडियो को डाउनलोड करने योग्य ऑडियो में बदलने की आवश्यकता है—कोई ब्राउज़र हैक नहीं, कोई रिवर्स इंजीनियरिंग नहीं, बस एक स्थिर API जिसे आप उत्पादन में भेज सकते हैं। इस गाइड के अंत तक, आप एक YouTube वीडियो (≈5 मिनट या उससे छोटा) को ऑडियो फ़ाइल में प्रोग्रामेटिक रूप से बदलने, सीधे MP3 लिंक को पुनः प्राप्त करने और इसे Zyla API Hub पर Youtube Video to Audio API का उपयोग करके अपने मीडिया वर्कफ़्लो में एकीकृत करने में सक्षम होंगे।

यह API क्या करती है और इसका उपयोग कब करें

Youtube Video to Audio API एक YouTube वीडियो (जिसे इसके वीडियो ID द्वारा पहचाना जाता है) को एक ऑडियो फ़ाइल में बदलती है और एक सीधा URL लौटाती है जिसे आप डाउनलोड कर सकते हैं। सामान्य उपयोग में शामिल हैं:

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

API एक JSON पेलोड लौटाती है जिसमें ऑडियो लिंक, वीडियो शीर्षक, फ़ाइल आकार, और रूपांतरण स्थिति होती है, जिससे भंडारण, टैगिंग, या डाउनस्ट्रीम इनजेशन जैसी पोस्ट-प्रोसेसिंग को स्वचालित करना सीधा हो जाता है।

Zyla API Hub पर शुरू करना

Zyla API Hub एक मार्केटप्लेस है जिसमें एक खाते, एक API कुंजी, और एकल सदस्यता मॉडल के तहत 10,000 से अधिक सार्वजनिक APIs हैं। इस API के लिए, आप एक Authorization: Bearer YOUR_API_KEY हेडर के साथ प्रमाणीकरण करते हैं। बिलिंग सदस्यता + कोटा है, प्रति कॉल भुगतान नहीं। कोई मुफ्त योजना नहीं। Youtube Video to Audio API एक 7-दिन का परीक्षण प्रदान करता है जिसे आप सीधे लिस्टिंग पृष्ठ से शुरू कर सकते हैं।

लिस्टिंग खोलें और यहाँ अपना परीक्षण शुरू करें: Youtube Video to Audio API पर 7-दिन का परीक्षण शुरू करें.

एंडपॉइंट अवलोकन

API एक YouTube वीडियो को ऑडियो में बदलने के लिए एकल एंडपॉइंट को उजागर करती है। सफल रूपांतरण सुनिश्चित करने के लिए वीडियो को लगभग 5 मिनट या उससे कम रखें।

• एंडपॉइंट: ऑडियो प्राप्त करें
• विधि: GET
• URL: https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio
• आवश्यक क्वेरी पैरामीटर:
  • id (string): YouTube वीडियो ID (जैसे, p-Z3YrHJ1sU)

महत्वपूर्ण: अपने API कुंजी को Authorization हेडर में पास करें। प्रतिक्रिया एक JSON ऑब्जेक्ट लौटाती है जिसमें उत्पन्न MP3 के लिए सीधा लिंक, मूल शीर्षक, फ़ाइल आकार बाइट्स में, रूपांतरण प्रगति, सेकंड में अवधि, और स्थिति/संदेश फ़ील्ड होते हैं।

त्वरित प्रारंभ: cURL अनुरोध

प्रवाह का परीक्षण करने के लिए इस सटीक अनुरोध का उपयोग करें। अपने लाइव कुंजी के साथ YOUR_API_KEY को बदलें जो Zyla API Hub लिस्टिंग से है।

curl -s -X GET "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio?id=p-Z3YrHJ1sU"
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक नमूना प्रतिक्रिया

{
"link": "https://eta.123tokyo.xyz/get.php/9/9e/ty7nkwYqodA.mp3?cid=MmEwMTo0Zjg6YzAxMjozMmVlOjoxfE5BfERF&h=FwrcvY5cIfOO0jyXh5C-6Q&s=1737705748&n=%E2%82%B91%2C07%2C000%20_iPhone%2016%20Pro%20Max_%20USA%20to%20INDIA_%20%23shorts%20%23youtubeshorts&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"title": "₹1,07,000 *iPhone 16 Pro Max* USA to INDIA! #shorts #youtubeshorts",
"filesize": 417480,
"progress": 100,
"duration": 22.896054233758,
"status": "ok",
"msg": "success"
}

आप इस पेलोड से सामान्यतः क्या पढ़ेंगे:

• link: सीधा MP3 URL जिसे आप डाउनलोड या स्ट्रीम कर सकते हैं।
• title: मूल YouTube शीर्षक (नामकरण या मेटाडेटा के लिए उपयोगी)।
• filesize: बाइट्स में आकार (भंडारण सीमाओं के खिलाफ मान्य करें)।
• progress: पूर्णता का प्रतिशत। तैयार होने पर 100 की अपेक्षा करें।
• duration: सेकंड में लंबाई (फ्लोट), मान्यता/UX के लिए उपयोगी।
• status/msg: संचालन स्थिति और संदेश। डाउनलोड करने से पहले "ok" और "success" की जांच करें।

Python उदाहरण: MP3 को परिवर्तित और डाउनलोड करें

यह उदाहरण एंडपॉइंट को कॉल करता है, प्रतिक्रिया को मान्य करता है, और MP3 को स्थानीय भंडारण में डाउनलोड करता है। YOUR_API_KEY को अपनी कुंजी के साथ बदलें और आवश्यकता अनुसार video_id को बदलें।

import os
import sys
import time
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "p-Z3YrHJ1sU" # YouTube वीडियो ID

BASE_URL = "https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio"
headers = {"Authorization": f"Bearer {API_KEY}"}

def get_audio_json(video_id: str) -> dict:
params = {"id": video_id}
r = requests.get(BASE_URL, headers=headers, params=params, timeout=30)
r.raise_for_status()
return r.json()

def download_file(url: str, dest_path: str):
with requests.get(url, stream=True, timeout=60) as r:
r.raise_for_status()
with open(dest_path, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)

def main():
try:
data = get_audio_json(VIDEO_ID)
except requests.HTTPError as e:
print(f"HTTP error: {e}", file=sys.stderr)
sys.exit(1)

status = data.get("status")
msg = data.get("msg")
progress = data.get("progress")
link = data.get("link")
title = data.get("title")
filesize = data.get("filesize")
duration = data.get("duration")

if status != "ok" or msg != "success" or progress != 100 or not link:
print(f"Conversion not ready or failed. status={status} msg={msg} progress={progress}", file=sys.stderr)
sys.exit(2)

# Basic filename: sanitize title to avoid path issues
safe_title = "".join(c for c in title if c.isalnum() or c in (" ", "-", "_")).rstrip()
filename = f"{safe_title or VIDEO_ID}.mp3"

print(f"Title: {title}")
print(f"Duration (s): {duration}")
print(f"File size (bytes): {filesize}")
print(f"Downloading to: {filename}")

try:
download_file(link, filename)
print("Download complete.")
except requests.HTTPError as e:
print(f"Failed to download file: {e}", file=sys.stderr)
sys.exit(3)

if __name__ == "__main__":
main()

नोट्स:

• id केवल YouTube वीडियो ID की अपेक्षा करता है (watch URL में छोटा टोकन)। उदाहरण के लिए, https://www.youtube.com/watch?v=p-Z3YrHJ1sU से, p-Z3YrHJ1sU पास करें।
• डाउनलोड करने से पहले progress == 100, status == "ok", और msg == "success" की जांच करें।
• व्यापार नियमों को मान्य करने के लिए लौटाए गए filesize और duration का उपयोग करें (जैसे, लंबे फ़ाइलों को अस्वीकार करें, भंडारण कोटा लागू करें)।

समय बचाने के लिए व्यावहारिक एकीकरण विवरण

• YouTube लंबाई मार्गदर्शन: 5 मिनट या उससे कम के वीडियो का उपयोग करें; लंबे वीडियो सफलतापूर्वक प्रोसेस नहीं हो सकते।
• Retry logic: यदि आपका पहला कॉल एक ऐसा स्थिति लौटाता है जो तैयार नहीं है, तो एक छोटा बैकऑफ़ और पुनः प्रयास लागू करें, अपने सदस्यता कोटा का सम्मान करते हुए।
• फ़ाइल हैंडलिंग: लिंक एक सीधा MP3 URL है। इसे तुरंत डाउनलोड करें या इसे अपने भंडारण परत (S3, GCS, आदि) को सौंपें। उत्पादन में हॉटलिंकिंग से बचें—विश्वसनीयता के लिए ऑडियो को कैश या स्टोर करें।
• मेटाडेटा: फ़ाइल नामों के लिए शीर्षक का उपयोग करें, लेकिन हमेशा फ़ाइल सिस्टम संगतता के लिए इसे साफ करें।
• अवधियाँ और UX: यदि आप स्ट्रीमिंग UI का प्रबंधन करते हैं तो शेष समय या ETA दिखाएं, filesize/bitrate का अनुमान लगाकर।
• सुरक्षा: अपनी API कुंजी सर्वर-साइड रखें। इसे कभी भी क्लाइंट-साइड कोड में उजागर न करें।
• कोटा जागरूकता: मार्केटप्लेस एक सदस्यता + कोटा मॉडल का उपयोग करता है। अप्रत्याशित 429/सीमा परिदृश्यों से बचने के लिए उपयोग की निगरानी करें।

सामान्य वर्कफ़्लो और उपयोग के मामले

स्पीच-टू-टेक्स्ट पाइपलाइन

एक छोटे YouTube व्याख्याता को MP3 में परिवर्तित करें, फिर फ़ाइल को अपने ट्रांसक्रिप्शन सेवा में फीड करें। अपनी स्पीच मान्यता सीमा से अधिक अपलोड को अस्वीकार करने के लिए अवधि का उपयोग करें इससे पहले कि आप डाउनस्ट्रीम कंप्यूट लागत का भुगतान करें।

पॉडकास्ट क्लिपिंग और पूर्वावलोकन

संपादकीय समीक्षा के लिए छोटे क्लिप के ऑडियो को प्राप्त करें। फ़ाइल नाम को शीर्षक से निकाले गए स्लग के रूप में स्टोर करें, और पूर्वावलोकन करते समय स्थानांतरण समय का अनुमान लगाने के लिए filesize का उपयोग करें।

अनुपालन या मॉडरेशन उपकरण

ML-आधारित वर्गीकरण के लिए केवल ऑडियो संपत्तियाँ उत्पन्न करें। शीर्षक को लेबल के रूप में रखें और ऑडिट ट्रेल्स के लिए लिंक पुनः प्राप्ति टाइमस्टैम्प को स्टोर करें।

CMS इनजेशन के लिए मीडिया बैकअप

लेखों के लिए जो एक वीडियो को एम्बेड करते हैं, पोस्ट के साथ ऑडियो को एक्सेसिबिलिटी सुविधाओं (केवल ऑडियो संस्करण) के लिए स्टोर करें। अपने CMS की अधिकतम लंबाई नीति के खिलाफ अवधि को मान्य करें।

MCP: AI एजेंटों से इस API को कॉल करें

यदि आप AI कोडिंग एजेंटों या IDE-एकीकृत सह-चालकों के साथ निर्माण करते हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से कॉल को रूट कर सकते हैं, जो Claude Code, Cursor, और Windsurf जैसे क्लाइंट के साथ काम करता है। अपने एजेंट को MCP के माध्यम से मार्केटप्लेस एंडपॉइंट को कॉल करने के लिए कॉन्फ़िगर करें, अपनी API कुंजी का उपयोग करते हुए। संदर्भ के लिए, देखें: MCP. एजेंट को आवश्यक id पैरामीटर और Authorization: Bearer YOUR_API_KEY हेडर के साथ Youtube Video to Audio API के Get Audio एंडपॉइंट पर GET अनुरोध जारी करना चाहिए। आपका उपकरण फिर लिंक, शीर्षक, फ़ाइल आकार, और अवधि को पार्स कर सकता है यह तय करने के लिए कि डाउनलोड करना है या URL को आगे बढ़ाना है।

त्रुटि हैंडलिंग और लचीलापन

• पैरामीटर मान्यता: सुनिश्चित करें कि id मौजूद है और एक मान्य YouTube वीडियो ID है। भेजने से पहले whitespace और URL क्वेरी अवशेषों को हटा दें।
• स्थिति जांच: सफलता का अनुमान न लगाएं—स्थिति, msg, और प्रगति की पुष्टि करें। उपयुक्त होने पर पुनः प्रयास के साथ गैर-200 HTTP प्रतिक्रियाओं को संभालें।
• टाइमआउट: JSON एंडपॉइंट और लौटाए गए MP3 लिंक के लिए नेटवर्क अनुरोधों में उचित टाइमआउट होना चाहिए (जैसे, 30–60 सेकंड)।
• कैशिंग: अपने डाउनलोड की गई फ़ाइल के साथ JSON प्रतिक्रिया को स्टोर करें ताकि आप बिना उसी वीडियो ID के लिए API को फिर से कॉल किए बिना सटीक शीर्षक और अवधि प्रदर्शित कर सकें।
• थ्रूपुट: यदि आप बैच-प्रोसेसिंग कर रहे हैं, तो सदस्यता कोटा का सम्मान करने और डाउनस्ट्रीम स्टोरेज पर तनाव से बचने के लिए अनुरोधों को स्टैगर करें।

परीक्षण टिप्स

• एक ज्ञात छोटे वीडियो का उपयोग करें: अंत-से-अंत जांचों को तेज करने के लिए परीक्षण वीडियो को 1 मिनट के तहत रखें।
• फ़ाइल सिस्टम स्वच्छता: लौटाए गए शीर्षक में स्लैश, कॉलन, या इमोजी जैसे वर्णों को बदलें ताकि Windows/macOS फ़ाइल सिस्टम पर त्रुटियों से बचा जा सके।
• Assertions: डिस्क पर लिखने से पहले प्रगति == 100 और फ़ाइल आकार शून्य से अधिक है यह सत्यापित करें।
• पर्यवेक्षण: यदि उपयोगकर्ता गायब या भ्रष्ट ऑडियो की रिपोर्ट करते हैं तो ट्रायेज के लिए id, स्थिति, msg, अवधि, और फ़ाइल आकार को लॉग करें।

संदर्भ: एंडपॉइंट विवरण

ऑडियो प्राप्त करें

• विधि: GET
• URL: https://zylalabs.com/api/1812/youtube-video-to-audio-api/5870/get-audio
• क्वेरी पैरामीटर:
  • id (string, आवश्यक): YouTube वीडियो ID (उदाहरण: p-Z3YrHJ1sU)
• हेडर:
  • Authorization: Bearer YOUR_API_KEY
• विवरण: दिए गए YouTube वीडियो (≈5 मिनट या उससे कम की सिफारिश की गई) को ऑडियो में परिवर्तित करता है और एक सीधा MP3 लिंक और मेटाडेटा के साथ JSON लौटाता है।

उत्पादन के लिए एंड-टू-एंड चेकलिस्ट

• Zyla लिस्टिंग से अपनी API कुंजी प्राप्त करें और इसे सुरक्षित रूप से स्टोर करें (env var या secret manager)।
• id पैरामीटर और Authorization हेडर के साथ GET कॉल लागू करें।
• फ़ाइल डाउनलोड करने का प्रयास करने से पहले स्थिति/msg/progress की जांच करें।
• ऑडियो संपत्ति के साथ शीर्षक, अवधि, और फ़ाइल आकार को साफ और स्थायी करें।
• बैकऑफ़ के साथ पुनः प्रयास जोड़ें; अपनी सदस्यता कोटा की निगरानी करें।
• एक स्थिर छोटे वीडियो ID के खिलाफ एकीकरण परीक्षण लिखें।
• HTTP त्रुटियों और अप्रत्याशित प्रतिक्रिया आकृतियों के लिए लॉग और अलार्म सेट करें।

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

मैं id पैरामीटर के रूप में क्या पास करूं?
YouTube वीडियो ID पास करें, पूरा URL नहीं। https://www.youtube.com/watch?v=p-Z3YrHJ1sU से, p-Z3YrHJ1sU का उपयोग करें।

वीडियो कितनी लंबी हो सकती है?
एंडपॉइंट नोट करता है कि वीडियो की लंबाई लगभग 5 मिनट या उससे कम होनी चाहिए।

मैं प्रमाणीकरण कैसे करूं?
हेडर का उपयोग करें: Authorization: Bearer YOUR_API_KEY। कुंजी Zyla API Hub पर API की सदस्यता लेने के बाद जारी की जाती हैं।

सफल रूपांतरण की पुष्टि करने वाले कौन से फ़ील्ड हैं?
डाउनलोड करने का प्रयास करने से पहले status == "ok", msg == "success", progress == 100, और यह कि लिंक मौजूद है की जांच करें।

क्या यह प्रति कॉल भुगतान है?
नहीं। Zyla API Hub एक सदस्यता + कोटा मॉडल का उपयोग करता है। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण विवरणों के लिए API पृष्ठ की जांच करें।

शिप करने के लिए तैयार? अपना 7-दिन का परीक्षण शुरू करें और लिस्टिंग से अपनी API कुंजी प्राप्त करें: Youtube Video to Audio API पर 7-दिन का परीक्षण शुरू करें. Zyla API Hub पर हजारों APIs के बीच एकल सदस्यता के साथ अपना मीडिया पाइपलाइन बनाएं।