Youtube से ऑडियो API के लिए उपयोग के मामले

आपके पास इस सप्ताह एक फीचर है: एक YouTube वीडियो को एक ऑडियो फ़ाइल में बदलें जिसे आपका ऐप डाउनलोड, स्ट्रीम या प्रोसेस कर सके। इस लेख के अंत तक, आप Zyla API Hub से Youtube से ऑडियो API को कॉल करने में सक्षम होंगे ताकि एक YouTube वीडियो को MP3 डाउनलोड URL में हल किया जा सके या एक YouTube URL से डाउनलोड प्रवाह को ट्रिगर किया जा सके, फिर परिणामी ऑडियो को अपनी पाइपलाइन में एकीकृत करें।

Youtube से ऑडियो API क्या प्रदान करता है

Youtube से ऑडियो API दो सरल GET एंडपॉइंट्स को उजागर करता है जो एक YouTube वीडियो को ऑडियो में बदलते हैं। एक एंडपॉइंट एक YouTube वीडियो ID को स्वीकार करता है और एक तैयार-से-डाउनलोड MP3 लिंक के साथ उपयोगी मेटाडेटा (शीर्षक, अवधि, फ़ाइल आकार) लौटाता है। दूसरा एक पूर्ण YouTube URL को स्वीकार करता है और एक डाउनलोड URL लौटाता है जिसे आप ऑडियो प्राप्त करने के लिए प्राप्त कर सकते हैं।

आम उपभोक्ताओं में शामिल हैं:

पॉडकास्ट क्लिपिंग टूल जो लंबे वीडियो को ऑडियो हाइलाइट्स में बदलते हैं।
ट्रांसक्रिप्शन और स्पीच एनालिटिक्स सेवाएं जिन्हें ऑडियो को स्पीच-टू-टेक्स्ट इंजन में भेजने से पहले एक MP3 की आवश्यकता होती है।
ज्ञान-आधार निर्माता जो YouTube से बोले गए सामग्री को अनुक्रमित करते हैं।
सामग्री स्वचालन या AI एजेंट जो वीडियो प्लेलिस्ट को ऑडियो में बैच-परिवर्तित करते हैं ताकि डाउनस्ट्रीम प्रोसेसिंग के लिए।

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

एंडपॉइंट्स का उपयोग करने के लिए, Zyla API Hub पर API की लिस्टिंग खोलें, सदस्यता लें, और अपना API कुंजी प्राप्त करें। प्रमाणीकरण हर अनुरोध पर एकल HTTP हेडर है: Authorization: Bearer YOUR_API_KEY। Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। आपके खाते पर पहला API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। यहाँ से शुरू करें:

Youtube से ऑडियो API पर 7-दिन का परीक्षण शुरू करें

आप जिन एंडपॉइंट्स का उपयोग करेंगे

बेस: सभी कॉल सीधे नीचे दिखाए गए Zyla API Hub URLs पर किए जाते हैं। दस्तावेज़ित किए गए लोगों के अलावा अतिरिक्त क्वेरी पैरामीटर न जोड़ें।

1) ऑडियो प्राप्त करें (YouTube वीडियो ID द्वारा)

विधि: GET

URL: https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio

विवरण: एक YouTube वीडियो ID प्रदान करें और एक ऑब्जेक्ट प्राप्त करें जिसमें एक सीधा MP3 लिंक और मेटाडेटा हो। आवश्यक पैरामीटर:

id (string): YouTube वीडियो ID।

आधिकारिक कर्ल उदाहरण:

curl -s -X GET "https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio?id=xFYQQPAOz7Y" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON प्रतिक्रिया:

{
"msg": "success",
"link": "https://theta.123tokyo.xyz/get.php/d/fa/xFYQQPAOz7Y.mp3?n=Eminem%20-%20Lose%20Yourself&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D&h=TcO7xrzRPZ9cGbw2wXP93w&s=1784312338&uT=R&uN=QWxlam9aeWxhTGFicw%3D%3D",
"status": "ok",
"duration": 327.49718169275,
"title": "Eminem - Lose Yourself",
"progress": 100,
"pc": 0,
"filesize": 4181397
}

इन फ़ील्ड्स का उपयोग कैसे करें:

link: सीधा, समय-संवेदनशील MP3 URL। ऑडियो बाइट्स डाउनलोड करने के लिए एक दूसरा GET करें।
title: मानव-पठनीय शीर्षक। फ़ाइल नामकरण या UI के लिए उपयोगी।
duration: वीडियो/ऑडियो की लंबाई एक फ्लोटिंग-पॉइंट संख्या (सेकंड) के रूप में।
filesize: बाइट्स में फ़ाइल का आकार (स्टोरेज को पूर्व-आवंटित करने या प्रगति बार दिखाने के लिए उपयोगी)।
status/msg/progress/pc: संचालन स्थिति संकेतक जिन्हें आप लॉग कर सकते हैं या डिबगिंग के लिए सतह पर ला सकते हैं।

2) ऑडियो डाउनलोड करें (पूर्ण YouTube URL द्वारा)

विधि: GET

URL: https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio

विवरण: एक पूर्ण YouTube URL प्रदान करें और एक URL प्राप्त करें जिसे आप ऑडियो डाउनलोड करने के लिए प्राप्त कर सकते हैं। आवश्यक पैरामीटर:

url (string): पूर्ण YouTube वीडियो URL।

आधिकारिक कर्ल उदाहरण:

आधिकारिक JSON प्रतिक्रिया:

इस फ़ील्ड का उपयोग कैसे करें:

downloadUrl: इस URL को ऑडियो बाइनरी प्राप्त करने के लिए प्राप्त करें। अधिकांश ऐप्स में आप बाइट्स को डिस्क या क्लाउड स्टोरेज पर स्ट्रीम करेंगे।

Python उदाहरण: YouTube ID को हल करना और MP3 डाउनलोड करना

यह उदाहरण दिखाता है कि Get Audio को कैसे कॉल करें, मेटाडेटा पढ़ें, और MP3 फ़ाइल डाउनलोड करें। यह ऊपर दिखाए गए सटीक एंडपॉइंट और पैरामीटर का उपयोग करता है।

import os
import sys
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "xFYQQPAOz7Y" # आधिकारिक नमूने में प्रदान किया गया
OUTFILE = "audio.mp3"

session = requests.Session()
headers = {"Authorization": f"Bearer {API_KEY}"}

# 1) YouTube ID को MP3 लिंक + मेटाडेटा में हल करें
meta_url = "https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio"
resp = session.get(meta_url, headers=headers, params={"id": VIDEO_ID}, timeout=60)
resp.raise_for_status()
data = resp.json()

if data.get("status") != "ok" or not data.get("link"):
print("ऑडियो को हल करने में विफल।", file=sys.stderr)
print(data, file=sys.stderr)
sys.exit(1)

mp3_url = data["link"]
title = data.get("title")
duration = data.get("duration")
filesize = data.get("filesize")

print(f"हल किया गया: शीर्षक={title}, अवधि_s={duration}, बाइट्स={filesize}")
print("ऑडियो डाउनलोड कर रहे हैं...")

# 2) MP3 स्ट्रीम डाउनलोड करें
with session.get(mp3_url, stream=True, timeout=120) as r:
r.raise_for_status()
with open(OUTFILE, "wb") as f:
for chunk in r.iter_content(chunk_size=1024 * 128):
if chunk:
f.write(chunk)

# 3) वैकल्पिक: यदि शीर्षक प्रदान किया गया हो तो नाम बदलें
if title:
safe = "".join(c for c in title if c.isalnum() or c in (" ", "-", "_")).rstrip()
new_name = f"{safe}.mp3"
try:
os.replace(OUTFILE, new_name)
print(f"सहेजा गया: {new_name}")
except Exception:
print(f"सहेजा गया: {OUTFILE} (नाम बदलने में विफल, फ़ाइल सिस्टम अनुमतियों की जांच करें)")

print("पूर्ण।")

नोट्स:

पहला अनुरोध मेटाडेटा और एक सीधा MP3 लिंक प्राप्त करता है। दूसरा अनुरोध बाइनरी स्ट्रीम डाउनलोड करता है।
बड़े फ़ाइलों के लिए स्ट्रीमिंग डाउनलोड का उपयोग करें ताकि पूरी फ़ाइल को मेमोरी में लोड करने से बचा जा सके।
प्रगति बार को पूर्व-आकार देने के लिए फ़ाइल आकार फ़ील्ड (बाइट्स) का उपयोग करें। अवधि सेकंड में है, जो ट्रांसक्रिप्शन या प्रोसेसिंग लागत का अनुमान लगाने में मदद कर सकता है।

व्यावहारिक उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं

स्वचालित ट्रांसक्रिप्शन पाइपलाइन: एक YouTube वीडियो को MP3 में बदलें और ऑडियो को अपने स्पीच-टू-टेक्स्ट सेवा में फीड करें। खोज, संक्षेपण, या QA के लिए ट्रांसक्रिप्ट को स्टोर करें।
न्यूज़लेटर के लिए ऑडियो क्लिपर: अपने साप्ताहिक न्यूज़लेटर के लिए ऑडियो हाइलाइट्स निकालें बिना अपना डाउनलोडर लिखे या स्क्रैपर्स बनाए रखें।
ज्ञान अनुक्रमण: व्याख्यान या वार्ताओं को ऑडियो में बदलें, फिर अपने RAG स्टैक में एम्बेडिंग और पुनर्प्राप्ति के लिए टुकड़ों में विभाजित करें।
AI सामग्री समृद्धि: सामग्री अनुशंसाओं में सुधार के लिए डायरीकरण या कीवर्ड निष्कर्षण के लिए MP3 का उपयोग करें।
क्यूज़ के साथ बैच प्रोसेसिंग: YouTube IDs या URLs को एक क्यू में डालें; श्रमिक API को कॉल करते हैं, ऑडियो को स्थायी करते हैं, और परिणामी फ़ाइल पथ और मेटाडेटा के साथ घटनाएँ उत्पन्न करते हैं।

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

प्रमाणीकरण: हमेशा Zyla एंडपॉइंट्स पर प्रत्येक GET अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
दो-चरण प्रवाह: API एक लिंक या downloadUrl लौटाता है। ऑडियो बाइट्स प्राप्त करने के लिए उस URL पर एक दूसरा GET करें। मानक HTTP व्यवहार (रीडायरेक्ट, टाइमआउट) को संभालें।
फ़ाइल नामकरण: मानव-अनुकूल फ़ाइल नामों के लिए शीर्षक फ़ील्ड का उपयोग करें। आइडेम्पोटेंसी के लिए YouTube ID जोड़ने पर विचार करें (जैसे, "{title}-{id}.mp3").
स्टोरेज: क्लाउड अपलोड के लिए, अस्थायी स्थानीय फ़ाइलों से बचने के लिए सीधे अपने ऑब्जेक्ट स्टोरेज SDK पर स्ट्रीम करें। उपलब्ध होने पर Content-Length सेट करने के लिए फ़ाइल आकार का उपयोग करें।
पुनः प्रयास: डाउनलोड URL के लिए नेटवर्क हॉप आपके VPC के बाहर हैं। अस्थायी 5xx/कनेक्शन त्रुटियों पर बैकऑफ के साथ पुनः प्रयास लागू करें।
सैनिटाइजेशन: डाउनलोड ऑडियो एंडपॉइंट पर पास करने से पहले उपयोगकर्ता-प्रदान किए गए URLs को साफ करें, लेकिन अपेक्षित क्वेरी पैरामीटर नाम (url) को न बदलें।
रेट और कोटा: Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है। अपने उपयोग को ट्रैक करें और यदि आपका कार्यभार बढ़ता है तो सर्किट ब्रेकर लागू करें। वर्तमान विकल्पों के लिए, API के मार्केटप्लेस पृष्ठ की जांच करें।

दो एंडपॉइंट्स के बीच चयन करना

यदि आपके पास पहले से एक YouTube वीडियो ID है, तो Get Audio का उपयोग करें। आपको एक सीधा MP3 लिंक और उपयोगी मेटाडेटा (अवधि, फ़ाइल आकार, शीर्षक) एक कॉल में मिलेगा।
यदि आपका कार्यप्रवाह एक पेस्ट किए गए या खोजे गए YouTube URL से शुरू होता है, तो Download Audio का उपयोग करें। यह एक downloadUrl लौटाता है जिसे आप ऑडियो प्राप्त करने के लिए प्राप्त कर सकते हैं।

आप उन्हें संयोजित भी कर सकते हैं: जहां संभव हो, IDs में इनपुट को सामान्य करें (डुप्लिकेशन और कैशिंग के लिए), लेकिन जब उपयोगकर्ता एक पूर्ण लिंक पेस्ट करते हैं तो URL प्रवाह पर वापस लौटें।

AI एजेंटों के माध्यम से API को कॉल करना MCP के जरिए

Zyla पर हर API को AI एजेंटों से भी कॉल किया जा सकता है MCP-संगत एंडपॉइंट के माध्यम से https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY। यह Claude Code, Cursor, Windsurf, और अन्य MCP क्लाइंट्स में एजेंटों के साथ काम करता है। आप MCP टूल को ऊपर दिखाए गए समान HTTP GET अनुरोध जारी करने के लिए कॉन्फ़िगर करते हैं, जिसमें Authorization हेडर और सटीक Zyla URLs होते हैं। Zyla टूल के साथ MCP-संगत क्लाइंट का उपयोग करने के विवरण के लिए, यहाँ से शुरू करें:

MCP

आम एजेंट पैटर्न:

"एक वीडियो ID दी गई है, ऑडियो प्राप्त करें और मेरे ट्रांसक्रिप्शन टूल को भेजें।"
"जब एक YouTube लिंक एक कार्य में दिखाई देता है, तो MP3 में हल करें, S3 में स्टोर करें, और स्टोरेज URL लौटाएं।"

न्यूनतम एंड-टू-एंड कार्यप्रवाह (ID-आधारित)

ऑडियो हल करें:
- GET https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio?id=YOUR_VIDEO_ID Authorization हेडर के साथ।
मेटाडेटा को स्थायी करें:
- बाद में संदर्भ के लिए मूल YouTube ID के साथ शीर्षक, अवधि (सेकंड), फ़ाइल आकार (बाइट्स) को स्टोर करें।
डाउनलोड:
- MP3 स्ट्रीम करने के लिए लिंक फ़ील्ड को GET करें। डिस्क या ऑब्जेक्ट स्टोरेज पर सहेजें।
डाउनस्ट्रीम प्रोसेसिंग:
- आवश्यकतानुसार ट्रांसक्रिप्शन, टुकड़ों में विभाजन, या एम्बेडिंग कार्य प्रारंभ करें।

संचालन संबंधी सुझाव

टाइमआउट: संवेदनशील टाइमआउट सेट करें (जैसे, मेटाडेटा के लिए 60 सेकंड, बड़े डाउनलोड के लिए 120 सेकंड+) और पुनः प्रयास करें।
पर्यवेक्षण: अनुरोध IDs और YouTube ID/URL को लॉग करें ताकि समस्याओं का पता लगाया जा सके। क्षमता योजना के लिए फ़ाइल आकार और अवधि को भी लॉग करें।
कैशिंग: YouTube ID द्वारा की गई सफल हलनाओं को कैश करें। यदि एक लिंक समाप्त हो जाता है, तो इसे ताज़ा करने के लिए API को फिर से कॉल करें।
सुरक्षा: अपने API कुंजी को क्लाइंट-साइड पर उजागर न करें। कॉल को अपने बैकएंड सेवा के माध्यम से रूट करें।

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

प्रश्न: API को कौन सा प्रमाणीकरण चाहिए?
उत्तर: Zyla एंडपॉइंट्स पर प्रत्येक अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।

प्रश्न: प्रत्येक एंडपॉइंट के लिए कौन से पैरामीटर आवश्यक हैं?
उत्तर: Get Audio के लिए id (YouTube वीडियो ID) की आवश्यकता होती है। Download Audio के लिए url (पूर्ण YouTube URL) की आवश्यकता होती है। अन्य पैरामीटर न जोड़ें।

प्रश्न: अवधि और फ़ाइल आकार क्या दर्शाते हैं?
उत्तर: अवधि एक फ्लोटिंग-पॉइंट संख्या है जो सेकंड का प्रतिनिधित्व करती है। फ़ाइल आकार ऑडियो फ़ाइल का आकार बाइट्स में है।

प्रश्न: क्या मैं परिणाम को सीधे क्लाउड स्टोरेज पर स्ट्रीम कर सकता हूँ?
उत्तर: हाँ। स्ट्रीमिंग सक्षम के साथ लिंक (या downloadUrl) प्राप्त करें और सीधे अपने स्टोरेज SDK पर टुकड़े लिखें।

प्रश्न: मैं API का परीक्षण कैसे करूँ?
उत्तर: API के मार्केटप्लेस पृष्ठ पर सदस्यता लें ताकि एक API कुंजी प्राप्त कर सकें। आपके खाते पर पहला API 7-दिन का परीक्षण या 50 अनुरोध शामिल करता है; वर्तमान विवरण के लिए API पृष्ठ देखें।

यदि आप निर्माण के लिए तैयार हैं, तो Youtube से ऑडियो API के लिए मार्केटप्लेस आइटम पृष्ठ पर सदस्यता लें ताकि अपनी कुंजी प्राप्त कर सकें, ऊपर दिए गए कर्ल को कॉपी करें, और इसे अपने डाउनलोडर या ट्रांसक्रिप्शन पाइपलाइन में वायर करें। 7-दिन का परीक्षण आइटम पृष्ठ पर शुरू होता है, और एंडपॉइंट्स तब तैयार होते हैं जब आप होते हैं।