आपका कार्य: एक YouTube लिंक या वीडियो आईडी लें और प्रोग्रामेटिक रूप से एक डाउनलोड करने योग्य MP3 URL प्राप्त करें जिसे आप अपने ऐप में सहेज सकते हैं या स्ट्रीम कर सकते हैं। इस लेख के अंत तक, आप एक वास्तविक एंडपॉइंट को कॉल करेंगे जो एक सीधा ऑडियो लिंक और मेटाडेटा लौटाता है, फिर फ़ाइल डाउनलोड करने के लिए कुछ कोड की पंक्तियाँ लिखेंगे।
आप इसके साथ क्या बना सकते हैं
Zyla API Hub पर Youtube to Audio API आपको एक YouTube वीडियो को ऑडियो डाउनलोड URL में बदलने की अनुमति देता है। यह ऑडियो फ़ाइल के लिंक के साथ उपयोगी मेटाडेटा जैसे शीर्षक, अवधि, और फ़ाइल आकार लौटाता है। डेवलपर्स इसका उपयोग करते हैं:
- ऑफलाइन प्लेबैक के लिए पॉडकास्टिंग या लर्निंग ऐप में सार्वजनिक YouTube वीडियो से MP3 उत्पन्न करें।
- एक बड़े मीडिया वर्कफ़्लो के हिस्से के रूप में ऑडियो निष्कर्षण कार्यों को कतारबद्ध करें।
- एकल URL लौटाकर सामग्री अधिग्रहण को सरल बनाएं जिसे आपकी सेवा द्वारा डाउनलोड या प्रॉक्सी किया जा सकता है।
यह API दो ठोस क्रियाओं पर केंद्रित है: एक वीडियो आईडी दी गई है, एक ऑडियो लिंक और मेटाडेटा लौटाएं; या, एक पूर्ण YouTube URL दी गई है, एक तैयार-से-डाउनलोड URL लौटाएं। SDK के साथ झगड़ने की कोई आवश्यकता नहीं, बस सरल HTTP GET कॉल।
Zyla API Hub पर शुरुआत करना
Zyla API Hub एक खाते, एक API कुंजी, और एक सुसंगत सदस्यता मॉडल के माध्यम से हजारों उत्पादन-तैयार APIs प्रदान करता है। आप कई विक्रेता खातों को सेटअप किए बिना APIs को ब्राउज़, सब्सक्राइब और कॉल कर सकते हैं। zylalabs.com पर अधिक जानें।
इस API का उपयोग करने के लिए:
- Zyla API Hub पर Youtube to Audio API पर 7-दिन की परीक्षण शुरू करें पृष्ठ खोलें।
- सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर फ्री ट्रायल शुरू करें) और अपनी API कुंजी प्राप्त करें।
- Authorization: Bearer YOUR_API_KEY के साथ हेडर के साथ अनुरोध भेजें।
बिलिंग सदस्यता के साथ कोटा है, प्रति कॉल भुगतान नहीं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। आप zylalabs.com पर अधिक APIs और श्रेणियों की खोज भी कर सकते हैं।
API अवलोकन
Youtube to Audio API Zyla के API गेटवे के माध्यम से दो GET एंडपॉइंट्स को उजागर करता है:
- Get Audio (YouTube वीडियो आईडी द्वारा): एक सीधा ऑडियो लिंक और मेटाडेटा लौटाता है
- Download Audio (पूर्ण YouTube URL द्वारा): एक डाउनलोड URL लौटाता है
सभी अनुरोध HTTPS का उपयोग करते हैं और Bearer API कुंजी के साथ Authorization हेडर की आवश्यकता होती है। नीचे दिए गए उदाहरण कॉपी-पेस्ट करने योग्य हैं।
एंडपॉइंट: Get Audio (वीडियो आईडी द्वारा)
इसका उपयोग करें जब आपके पास YouTube वीडियो आईडी हो और ऑडियो लिंक और मेटाडेटा जैसे शीर्षक, अवधि, और फ़ाइल आकार की आवश्यकता हो।
- विधि: GET
- URL: https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio
- आवश्यक क्वेरी पैरामीटर: 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: उत्पन्न ऑडियो फ़ाइल के लिए सीधा URL। इसका उपयोग MP3 को स्ट्रीम या सहेजने के लिए करें।
- title: स्रोत वीडियो का शीर्षक, फ़ाइल नाम और UI लेबल के लिए उपयोगी।
- duration: सेकंड में अवधि का प्रतिनिधित्व करने वाला फ्लोटिंग-पॉइंट मान।
- filesize: डाउनलोड करने योग्य ऑडियो के लिए बाइट्स में आकार, जो प्रगति बार और भंडारण योजना के लिए मदद करता है।
- status/msg/progress: स्थिति संकेतक; प्रगति इस उदाहरण में प्रतिशत जैसे संख्या है।
Python उदाहरण: ऑडियो लिंक प्राप्त करें और MP3 डाउनलोड करें
यह उदाहरण Get Audio एंडपॉइंट को कॉल करता है, लिंक फ़ील्ड को निकालता है, और फ़ाइल को डिस्क पर डाउनलोड करता है। YOUR_API_KEY को मार्केटप्लेस पृष्ठ से अपनी कुंजी के साथ बदलें।
import os
import sys
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "xFYQQPAOz7Y" # Provided in the example request
try:
# Step 1: Get audio metadata and link
meta_resp = requests.get(
"https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio",
headers={"Authorization": f"Bearer {API_KEY}"},
params={"id": VIDEO_ID},
timeout=30,
)
meta_resp.raise_for_status()
data = meta_resp.json()
if data.get("status") != "ok" or "link" not in data:
print("Audio not ready or failed:", data)
sys.exit(1)
audio_url = data["link"]
title = data.get("title", f"{VIDEO_ID}.mp3")
duration = data.get("duration")
size_bytes = data.get("filesize")
# Choose a filename. If title is present, make a safe filename.
filename = f"{title}.mp3" if not title.endswith(".mp3") else title
safe_filename = filename.replace("/", "_")
print(f"Downloading: {safe_filename}")
print(f"Duration (s): {duration}")
print(f"File size (bytes): {size_bytes}")
print(f"URL: {audio_url}")
# Step 2: Download the MP3
with requests.get(audio_url, stream=True, timeout=60) as r:
r.raise_for_status()
with open(safe_filename, "wb") as f:
for chunk in r.iter_content(chunk_size=8192):
if chunk:
f.write(chunk)
print("Saved to:", safe_filename)
except requests.HTTPError as e:
print("HTTP error:", e, file=sys.stderr)
sys.exit(1)
except requests.RequestException as e:
print("Request failed:", e, file=sys.stderr)
sys.exit(1)
टिप: चूंकि प्रतिक्रिया में filesize शामिल है, आप प्रगति बार को पूर्व-आवंटित कर सकते हैं। यदि filesize उपलब्ध नहीं है, तो स्ट्रीम करें और लिखते समय बाइट्स की गिनती करके प्रगति का अनुमान लगाएं।
एंडपॉइंट: Download Audio (पूर्ण YouTube URL द्वारा)
इसका उपयोग करें जब आपके पास एक पूर्ण YouTube वीडियो URL हो और केवल एक डाउनलोड URL की आवश्यकता हो। यह एंडपॉइंट एक downloadUrl फ़ील्ड लौटाता है जिसे आप दूसरे चरण में प्राप्त कर सकते हैं।
- विधि: GET
- URL: https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio
- आवश्यक क्वेरी पैरामीटर: url
उदाहरण अनुरोध:
उदाहरण JSON प्रतिक्रिया:
एक सामान्य प्रवाह में, इस एंडपॉइंट को कॉल करें ताकि downloadUrl प्राप्त हो, फिर उस URL पर एक मानक HTTP GET करें ताकि बाइनरी ऑडियो सामग्री प्राप्त की जा सके। यदि आपको शीर्षक, अवधि, या फ़ाइल आकार की आवश्यकता है, तो उस लिंक के साथ उन फ़ील्ड को प्रदर्शित करने वाले Get Audio एंडपॉइंट को प्राथमिकता दें।
आपको कौन सा एंडपॉइंट उपयोग करना चाहिए?
- जब आपके पास पहले से वीडियो आईडी हो और एक प्रतिक्रिया में मेटाडेटा (शीर्षक, अवधि, फ़ाइल आकार) और लिंक प्राप्त करना चाहते हों, तो Get Audio का उपयोग करें।
- जब आपके पास एक पूर्ण YouTube URL हो और केवल एक डाउनलोड करने योग्य URL की आवश्यकता हो, तो Download Audio का उपयोग करें, फिर दूसरे अनुरोध में फ़ाइल प्राप्त करें।
समय बचाने के लिए कार्यान्वयन विवरण
- प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY भेजें। कुंजी को क्वेरी स्ट्रिंग में न डालें।
- टाइमआउट: कॉल मानक HTTPS GET हैं। मेटाडेटा अनुरोध और फ़ाइल डाउनलोड अनुरोध दोनों पर व्यावहारिक टाइमआउट सेट करें। फ़ाइल डाउनलोड में अधिक समय लग सकता है; खंडित पढ़ाई के साथ स्ट्रीम करें।
- फ़ाइल नाम: Get Audio प्रतिक्रिया में शीर्षक शामिल है, जो फ़ाइल नामों के लिए सुविधाजनक है। इसे अपने OS के लिए साफ करें।
- अवधियाँ और आकार: अवधि सेकंड में एक फ्लोट है; filesize बाइट्स में है। भंडारण बजट और प्रगति संकेतकों के लिए filesize का उपयोग करें।
- कैशिंग: यदि आप बार-बार एक ही वीडियो आईडी या URL का अनुरोध करते हैं, तो अपने सिस्टम में लिंक और मेटाडेटा को एक समाप्ति नीति के साथ कैश करें जो आपके कार्यप्रवाह के लिए उपयुक्त हो।
- रीट्राई: लौटाए गए फ़ाइल लिंक के लिए नेटवर्क अनुरोध Zyla गेटवे से एक अलग होस्ट से गुजरते हैं। यदि डाउनलोड विफल होता है, तो बैकऑफ के साथ पुनः प्रयास करें।
JavaScript (Node.js) में एंड-टू-एंड उदाहरण
यह स्क्रिप्ट Get Audio एंडपॉइंट को हिट करने के लिए fetch का उपयोग करती है, फिर लौटाए गए लिंक का उपयोग करके फ़ाइल डाउनलोड करती है। Node 18+ का उपयोग करें या एक fetch पॉलीफिल जोड़ें।
import fs from "node:fs";
import { pipeline } from "node:stream";
import { promisify } from "node:util";
const streamPipeline = promisify(pipeline);
const API_KEY = process.env.ZYLA_API_KEY || "YOUR_API_KEY";
const VIDEO_ID = "xFYQQPAOz7Y";
async function main() {
// Step 1: Get metadata + link
const metaUrl = new URL("https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio");
metaUrl.searchParams.set("id", VIDEO_ID);
const metaResp = await fetch(metaUrl, {
method: "GET",
headers: { Authorization: `Bearer ${API_KEY}` },
});
if (!metaResp.ok) {
console.error("Metadata request failed:", metaResp.status, await metaResp.text());
process.exit(1);
}
const data = await metaResp.json();
if (data.status !== "ok" || !data.link) {
console.error("Audio not ready or missing link:", data);
process.exit(1);
}
const audioUrl = data.link;
const title = data.title || `${VIDEO_ID}.mp3`;
const filename = title.endsWith(".mp3") ? title : `${title}.mp3`;
console.log("Downloading:", filename);
console.log("Duration (s):", data.duration);
console.log("File size (bytes):", data.filesize);
console.log("URL:", audioUrl);
// Step 2: Download the file
const fileResp = await fetch(audioUrl, { method: "GET" });
if (!fileResp.ok || !fileResp.body) {
console.error("Download failed:", fileResp.status, await fileResp.text());
process.exit(1);
}
await streamPipeline(fileResp.body, fs.createWriteStream(filename));
console.log("Saved to:", filename);
}
main().catch((err) => {
console.error(err);
process.exit(1);
});
वास्तविक दुनिया के पैटर्न
- बैच प्रोसेसिंग: एक प्लेलिस्ट दी गई है, प्रत्येक वीडियो को इसके आईडी में हल करें, फिर प्रत्येक आईडी के लिए Get Audio को कॉल करें। अपने अधिग्रहण पाइपलाइन के लिए शीर्षक, फ़ाइल आकार, और लिंक को स्टोर करें।
- आपकी सेवा के लिए माइक्रोलाइब्रेरी: इन दो एंडपॉइंट्स को एक छोटे सहायक में लपेटें जिसमें पुनः प्रयास, टाइमआउट, और फ़ाइल नाम की सफाई हो।
- पृष्ठभूमि कार्य: अपने कार्य चलाने वाले का उपयोग करके आईडी-से-ऑडियो रूपांतरणों को कतारबद्ध करें। यदि data.status या प्रगति आपके परिदृश्य में असिंक्रोनस कार्य का संकेत देती है, तो डाउनलोड करने से पहले प्रगति 100 होने तक पोल करें।
- स्टोरेज हैंडऑफ: बाहरी लिंक को सीधे सेवा देने के बजाय, डाउनलोड करें और अपने स्वयं के ऑब्जेक्ट स्टोरेज में फिर से अपलोड करें ताकि लगातार होस्टिंग और एक्सेस नियंत्रण हो सके।
AI एजेंटों से MCP के माध्यम से कॉल करना
यदि आप इसे एक AI डेवलपर वातावरण में वायर कर रहे हैं, तो आप एकल MCP एंडपॉइंट का उपयोग करके Zyla APIs को Model Context Protocol के माध्यम से कॉल कर सकते हैं। कोई भी MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) निम्नलिखित के माध्यम से मार्केटप्लेस APIs को सक्रिय कर सकता है:
एजेंटों के लिए एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
उस MCP एंडपॉइंट पर apikey क्वेरी पैरामीटर के साथ अपनी Zyla API कुंजी का उपयोग करें, फिर अपने एजेंट को ऊपर दिखाए गए समान HTTPS कॉल करने दें। सामान्य MCP जानकारी के लिए, MCP पृष्ठ देखें।
समस्या निवारण चेकलिस्ट
- 401 या 403 त्रुटियाँ: सुनिश्चित करें कि Authorization हेडर Bearer YOUR_API_KEY पर सेट है और आपकी सदस्यता सक्रिय है।
- प्रतिक्रिया में कोई लिंक नहीं: Get Audio एंडपॉइंट के लिए, स्थिति और प्रगति फ़ील्ड की जांच करें और यदि आवश्यक हो तो थोड़े विलंब के बाद पुनः प्रयास करें।
- स्ट्रीम के मध्य में डाउनलोड विफल: बैकऑफ के साथ फ़ाइल अनुरोध को पुनः प्रयास करें और आंशिक फ़ाइल आकारों को सत्यापित करने पर विचार करें।
- अप्रत्याशित शीर्षक या फ़ाइल नाम: विशेष वर्णों को साफ करें और यदि शीर्षक गायब है तो वीडियो आईडी पर वापस जाएं।
सुरक्षा और संचालन नोट्स
- कभी भी अपने API कुंजी को क्लाइंट-साइड कोड में एम्बेड न करें। अपने बैकएंड के माध्यम से अनुरोधों को प्रॉक्सी करें या सर्वर-साइड कॉल का उपयोग करें।
- डीबगिंग और समर्थन को सरल बनाने के लिए अपने कॉल के साथ अनुरोध आईडी और टाइमस्टैम्प को लॉग करें।
- डाउनस्ट्रीम डाउनलोड किए गए ऑडियो के किसी भी वितरण के लिए सामग्री नीति और उपयोगकर्ता अनुमतियों पर विचार करें।
अगले कदम
एक बार जब आप अपनी पहली अनुरोध की पुष्टि कर लें, तो इन कॉल को अपने ऐप की सेवा परत में लपेटें, न्यूनतम पुनः प्रयास जोड़ें, और प्रगति घटनाओं को अपने UI से वायर करें। ऑडियो प्रसंस्करण को लेबल और मॉनिटर करने के लिए शीर्षक, अवधि, और फ़ाइल आकार फ़ील्ड का उपयोग करें।
अब इसे आजमाने के लिए, मार्केटप्लेस पृष्ठ खोलें और एक API कुंजी प्राप्त करें: Youtube to Audio API पर 7-दिन की परीक्षण शुरू करें। आपको कोटा के साथ सदस्यता-आधारित पहुंच मिलेगी। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
अक्सर पूछे जाने वाले प्रश्न
कौन सा प्रमाणीकरण हेडर आवश्यक है?
हर अनुरोध पर Zyla एंडपॉइंट पर Authorization: Bearer YOUR_API_KEY भेजें।
कौन सा एंडपॉइंट शीर्षक और अवधि जैसे मेटाडेटा लौटाता है?
id पैरामीटर के साथ GET https://zylalabs.com/api/381/youtube-to-audio-api/8884/get-audio का उपयोग करें।
मैं वास्तविक ऑडियो फ़ाइल को कैसे डाउनलोड करूं?
एक लिंक या downloadUrl प्राप्त करने के लिए API के एक एंडपॉइंट को कॉल करें, फिर उस लौटाए गए URL पर एक मानक HTTP GET करें ताकि बाइनरी सामग्री प्राप्त की जा सके।
क्या मैं ID के बजाय पूर्ण YouTube URL से शुरू कर सकता हूँ?
हाँ। url पैरामीटर के साथ GET https://zylalabs.com/api/381/youtube-to-audio-api/22174/download-audio का उपयोग करें।
क्या कोई मुफ्त योजना है?
पहुँच सदस्यता के साथ कोटा है। आइटम पृष्ठ उपलब्ध होने पर 7-दिन का परीक्षण प्रदान करता है। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जाँच करें।