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

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

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

Youtube से ऑडियो API एक YouTube वीडियो को एक ऑडियो फ़ाइल में परिवर्तित करता है और शीर्षक, अवधि और फ़ाइल आकार जैसे उपयोगी फ़ील्ड के साथ एक सीधा डाउनलोड लिंक लौटाता है। टीमें इसका उपयोग पॉडकास्टिंग उपकरण, ऑडियो नोट कैप्चर, ऑफ़लाइन प्लेबैक सुविधाओं और मीडिया इनजेशन पाइपलाइनों को शक्ति देने के लिए करती हैं जहाँ ऑडियो ट्रैक एकमात्र आवश्यक संपत्ति है।

Illustration: Working with Youtube to Audio API

Zyla API Hub पर, यह API एकल सब्सक्रिप्शन-और-कोटा मॉडल के तहत उपलब्ध है (कोई पे-पर-कॉल नहीं)। हब पर आप जिस पहले API की सदस्यता लेते हैं, वह आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; वर्तमान परीक्षण के लिए सूची देखें। Zyla पर आप जिस भी API का उपयोग करते हैं, उसे एक ही खाते और API कुंजी के साथ एक्सेस किया जाता है।

Zyla API Hub पर शुरुआत करना

Zyla पर Youtube से ऑडियो API सूची खोलें, सदस्यता लें या उपलब्ध परीक्षण शुरू करें, और अपनी कुंजी प्राप्त करें। आपकी कुंजी प्राधिकरण हेडर में एक बियरर टोकन के रूप में जाती है। कॉल Zyla के हब URLs के माध्यम से किए जाते हैं, न कि किसी तीसरे पक्ष के डोमेन के माध्यम से।

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

इस सप्ताह आप जो एंडपॉइंट भेज सकते हैं

API Zyla के हब URLs के माध्यम से दो GET एंडपॉइंट्स को उजागर करता है। प्रमाणीकरण हेडर-आधारित है जिसमें Authorization: Bearer YOUR_API_KEY है।

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

विधि: GET
URL: https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio
यह क्या करता है: एक YouTube वीडियो ID लेता है और एक सीधा MP3 डाउनलोड लिंक और मेटाडेटा लौटाता है।
आवश्यक क्वेरी पैरामीटर:
- id (string): YouTube वीडियो ID। उदाहरण: xFYQQPAOz7Y

आधिकारिक कर्ल (कॉपी/पेस्ट):

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

आधिकारिक उदाहरण प्रतिक्रिया:

{
"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। इसका उपयोग डाउनलोड या स्ट्रीम करने के लिए करें।
title: मानव-पठनीय वीडियो शीर्षक।
duration: ऑडियो की अवधि सेकंड में (फ्लोटिंग पॉइंट)।
filesize: बाइट्स में फ़ाइल का आकार।
status और msg: त्वरित स्वास्थ्य जांच फ़ील्ड; सफलता पर "ok" और "success" की अपेक्षा करें।
progress और pc: प्रगति संकेतक जिन्हें आप लॉग कर सकते हैं या अनदेखा कर सकते हैं जब प्रगति 100 हो।

2) ऑडियो डाउनलोड करें

विधि: GET
URL: https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio
यह क्या करता है: एक पूर्ण YouTube वीडियो URL लेता है और एक डाउनलोड करने योग्य ऑडियो लिंक लौटाता है।
आवश्यक क्वेरी पैरामीटर:
- url (string): पूर्ण YouTube देखने का URL। उदाहरण: https://www.youtube.com/watch?v=_Yhyp-_hX2s

यह तब सबसे आसान रास्ता है जब आपका UI पहले से ही एक पूर्ण YouTube URL रखता है। यदि आपके पास केवल वीडियो ID है, तो ऑडियो प्राप्त करें का उपयोग करें।

समय बचाने के लिए उत्पादन-केंद्रित नोट्स

प्रमाणीकरण: सभी अनुरोधों के लिए Authorization: Bearer YOUR_API_KEY की आवश्यकता होती है।
परिवहन: HTTPS हब URLs का उपयोग ठीक उसी तरह करें जैसा दिखाया गया है। किसी मूल होस्ट को कॉल न करें।
कैशिंग: यदि आप प्रतिक्रियाओं को कैश करते हैं, तो अंतिम लिंक, शीर्षक, अवधि और फ़ाइल आकार को स्टोर करें। अवधि सेकंड में है; फ़ाइल का आकार बाइट्स में है।
पुनः प्रयास: अस्थायी नेटवर्क त्रुटियों के लिए, एक छोटा एक्सपोनेंशियल बैकऑफ उचित है। यदि स्थिति या msg गैर-सफलता को इंगित करते हैं, तो इसे उपयोगकर्ता को दिखाएं।
कोटा: हब सब्सक्रिप्शन + कोटा का उपयोग करता है, न कि पे-पर-कॉल। पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध शामिल करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए सूची देखें।

Get Audio का उपयोग करते हुए न्यूनतम Python उदाहरण

यह स्निपेट एक दिए गए वीडियो ID के लिए ऑडियो का अनुरोध करता है और MP3 को डिस्क पर स्ट्रीम करता है। यह आधिकारिक Get Audio एंडपॉइंट का उपयोग करता है ताकि आप अपनी कुंजी जोड़ने के बाद पेस्ट-एंड-रन कर सकें।

import os
import sys
import json
import time
import urllib.parse
import requests

API_KEY = os.environ.get("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "xFYQQPAOz7Y" # अपने लक्षित YouTube ID के साथ बदलें
HUB_URL = "https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio"

def get_audio_info(video_id: str):
params = {"id": video_id}
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get(HUB_URL, params=params, headers=headers, timeout=30)
r.raise_for_status()
return r.json()

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

def main():
info = get_audio_info(VIDEO_ID)
# आधिकारिक नमूने के आधार पर अपेक्षित फ़ील्ड
if info.get("status") != "ok" or info.get("msg") != "success":
print("Conversion not ready or failed:", json.dumps(info, indent=2))
sys.exit(1)

link = info["link"]
title = info.get("title", f"{VIDEO_ID}.mp3")
duration = info.get("duration") # सेकंड (फ्लोट)
filesize = info.get("filesize") # बाइट्स (int)

# शीर्षक से एक सरल फ़ाइल नाम बनाएं
safe_title = "".join(c for c in title if c.isalnum() or c in (" ", "-", "_")).rstrip()
filename = f"{safe_title}.mp3"
print(f"Downloading: {title}")
print(f"Duration (s): {duration}")
print(f"Reported size (bytes): {filesize}")
print(f"Source link: {link}")

path = download_file(link, filename)
print(f"Saved to: {path}")

if __name__ == "__main__":
main()

अपने प्रवाह के लिए सही एंडपॉइंट चुनना

यदि आपका UI एक पूर्ण YouTube लिंक (देखने का URL) कैप्चर करता है, तो url पैरामीटर के साथ डाउनलोड ऑडियो को कॉल करें ताकि सीधे डाउनलोड URL प्राप्त किया जा सके।
यदि आपके पास केवल वीडियो ID है (जैसे, कहीं और पार्स किया गया या आपके DB में संग्रहीत), तो id पैरामीटर के साथ Get Audio का उपयोग करें ताकि अवधि और फ़ाइल आकार जैसे मेटाडेटा भी प्राप्त किया जा सके।

MCP के साथ AI एजेंट से कॉल करना

आप किसी भी MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) से समान हब एंडपॉइंट्स को Zyla MCP सेवा का उपयोग करके ट्रिगर कर सकते हैं। अपने क्लाइंट को MCP की ओर इंगित करने के लिए कॉन्फ़िगर करें, अपनी Zyla API कुंजी पास करें, और ऊपर दिखाए गए हब पथों को सक्रिय करें। सेटअप विवरण के लिए, MCP पृष्ठ देखें।

एंड-टू-एंड उदाहरण कार्य

कार्य: एक YouTube लिंक दिया गया है, एक MP3 स्टोर करें और मीडिया लाइब्रेरी के लिए बुनियादी मेटाडेटा लॉग करें।

इनपुट को पार्स करें। यदि इसमें एक पूर्ण देखने का URL है, तो url पैरामीटर के साथ डाउनलोड ऑडियो को कॉल करें। यदि आपके पास केवल वीडियो ID है, तो id के साथ Get Audio को कॉल करें।
सफलता पर, बनाए रखें:
- शीर्षक (title)
- सेकंड में अवधि (duration)
- बाइट्स में फ़ाइल आकार (filesize)
- स्रोत और डाउनलोड URL (link)
लिंक से MP3 डाउनलोड करें और इसे अपने ऑब्जेक्ट स्टोरेज या स्थानीय मीडिया फ़ोल्डर में स्टोर करें।
यदि आपको डुप्लिकेट पहचान की आवश्यकता है तो एक चेकसम रिकॉर्ड करें। परिवर्तनों के लिए फ़ाइल आकार का उपयोग करें।

संचालनात्मक विचार

टाइमआउट: मीडिया को स्थानांतरित करते समय नेटवर्क परिवर्तनशीलता एक वास्तविकता है। अंतिम लिंक डाउनलोड चरण के लिए उचित टाइमआउट और पुनः प्रयास का उपयोग करें।
बैकप्रेशर: यदि आपकी कतार में वृद्धि होती है (जैसे, कई रूपांतरण), तो बैच में प्रोसेस करें और Zyla पर अपने सब्सक्रिप्शन कोटा का सम्मान करें।
अवलोकनीयता: अस्थायी मुद्दों की जल्दी पहचान के लिए Get Audio से स्थिति, msg, और प्रगति लॉग करें।
सुरक्षा: अपनी API कुंजी को एक सुरक्षित स्टोर या पर्यावरण चर में रखें; इसे कभी भी क्लाइंट-साइड कोड में हार्डकोड न करें।
लचीलापन: यदि आप प्रतिक्रिया को कैश करते हैं, तो शीर्षक और अवधि दोनों को स्टोर करें ताकि आप मेटाडेटा को रेंडर कर सकें भले ही आप बाद में फ़ाइल डाउनलोड करने के लिए प्रतीक्षा करें।

त्वरित संदर्भ

इस सूची के लिए हब आधार: https://zylalabs.com/api/381/youtube-to-audio-api/
ऑडियो प्राप्त करें: GET /8884/get-audio?id=VIDEO_ID
ऑडियो डाउनलोड करें: GET /22174/download-audio?url=YOUTUBE_WATCH_URL
प्रमाणन हेडर: Authorization: Bearer YOUR_API_KEY
प्रतिक्रिया फ़ील्ड जिन्हें आप संभवतः बनाए रखेंगे: link, title, duration (seconds), filesize (bytes)

मीडिया कार्यों के लिए Zyla API Hub का उपयोग क्यों करें

Zyla 10,000 से अधिक सार्वजनिक APIs को एक खाते और एक कुंजी के तहत केंद्रीकृत करता है, ताकि आप बिना प्रमाणीकरण या बिलिंग को फिर से किए बिना आसन्न सुविधाएँ जोड़ सकें। Youtube से ऑडियो API उस कार्यप्रवाह में उसी प्राधिकरण हेडर के साथ स्लॉट करता है जिसका आप पहले से हब पर कहीं और उपयोग करते हैं। बाद में अधिक मीडिया क्षमताओं का अन्वेषण करें, लेकिन पहले इस रूपांतरण पथ को भेजें।

Zyla API Hub पर कैटलॉग ब्राउज़ करें और लगातार सब्सक्रिप्शन + कोटा बिलिंग के साथ APIs जोड़ें (कोई प्रति-कॉल आश्चर्य नहीं)।

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

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

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

प्रश्न: मैं प्रमाणीकरण कैसे करूं?
उत्तर: हब URLs पर भेजे गए प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY जोड़ें।

प्रश्न: क्या कोई मुफ्त योजना है?
उत्तर: हब सब्सक्रिप्शन + कोटा का उपयोग करता है। पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

प्रश्न: क्या मैं इसे AI कोडिंग एजेंट से ट्रिगर कर सकता हूं?
उत्तर: हाँ। अपने MCP-संगत क्लाइंट को Zyla की MCP सेवा का उपयोग करने के लिए कॉन्फ़िगर करें और हब एंडपॉइंट्स को कॉल करें। सेटअप के लिए MCP पृष्ठ देखें।

क्या आप इसे अपने मीडिया कार्यप्रवाह में जोड़ने के लिए तैयार हैं? Youtube से ऑडियो API सूची पर सदस्यता लें और अपनी कुंजी प्राप्त करें, 7-दिन का परीक्षण शुरू करें, और आज ही रूपांतरण सुविधा भेजें।