प्रोडक्शन
Mixanalytic API दस्तावेज़
https://mixanalytic.com का आधिकारिक API संदर्भ। चयन योग्य मॉड्यूल और संक्षिप्त/पूर्ण उत्तर मोड के साथ ऑडियो अपलोड कर AI आधारित मिक्स विश्लेषण पाने के लिए यह API उपयोग करें।
बेस URL: https://mixanalytic.com/api
प्रमाणीकरण
हर अनुरोध में अपनी API कुंजी X-API-Key हेडर में भेजें।
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
- 401 कुंजी नहीं है/अमान्य है
- 403 API एक्सेस के बिना मुफ़्त श्रेणी की कुंजी
- 429 रेट लिमिट पार हो गई
अनुमति के दायरे: write Mixanalytic अपलोड/विश्लेषण के लिए है। content संवेदनशील जानकारी हटाया हुआ सामग्री शोध डेटा पढ़ता है। content_write गैर-सार्वजनिक सामग्री ड्राफ़्ट सहेजता है। सामग्री के दायरे केवल एडमिन के लिए हैं।
एंडपॉइंट
| मेथड | पाथ | उद्देश्य |
|---|---|---|
| GET | /api/test-data | कनेक्शन/प्रमाणीकरण जाँच। |
| POST | /api/upload | ऑडियो फ़ाइल अपलोड और विश्लेषण। |
| GET | /api/analyze/<file_id> | फ़ाइल ID से दोबारा विश्लेषण करें (यदि मूल फ़ाइल अभी मौजूद हो)। |
| GET | /api/content/analysis-feed | सामग्री एजेंट के लिए सिर्फ़ एडमिन वाला, संवेदनशील विवरण हटाया गया शोध फ़ीड। |
| POST | /api/content/drafts | सामग्री एजेंटों के लिए केवल Admin का ड्राफ़्ट सहेजने/अपडेट करने का एंडपॉइंट। |
| GET | /api/ai-stats?days=30 | AI विश्लेषण के इस्तेमाल के आँकड़े। |
अपलोड अनुरोध
POST/api/upload
| फ़ील्ड | प्रकार | आवश्यक | टिप्पणियाँ |
|---|---|---|---|
| file | multipart file | हाँ | स्वीकार्य: mp3, wav, flac, m4a, aac, ogg। अधिकतम 95MB। |
| modules | string/list | नहीं | न देने पर सभी मॉड्यूल डिफ़ॉल्ट हैं। |
| detail_level | string | नहीं | full (डिफ़ॉल्ट) या summary। |
अमान्य detail_level पर 400 लौटता है। बहुत बड़ी फ़ाइल पर 413 लौटता है।
मॉड्यूल चयन
modules से तय करें कि कौन-से विश्लेषण मॉड्यूल लौटाए जाएँ (और गणना किए जाएँ)।
समर्थित फ़ॉर्मैट:
- अल्पविराम से अलग स्ट्रिंग: modules=frequency_balance,clarity,mood
- JSON ऐरे स्ट्रिंग: modules=["frequency_balance","clarity","mood"]
- दोहराई गई कुंजी (query/form): modules=frequency_balance&modules=clarity
- सभी मॉड्यूल: modules=all या modules=*
| मॉड्यूल | विवरण |
|---|---|
| frequency_balance | 7-बैंड फ़्रीक्वेंसी और संतुलन स्कोर। |
| dynamic_range | डायनेमिक रेंज, क्रेस्ट फ़ैक्टर, PLR। |
| stereo_field | चौड़ाई/फ़ेज़/सहसंबंध माप। |
| clarity | स्पेक्ट्रल स्पष्टता और परिभाषा के माप। |
| harmonic_content | स्वर-कुंजी और हार्मोनिक जटिलता। |
| transients | अटैक, ट्रांज़िएंट घनत्व और लो-एंड पंच डेटा। |
| 3d_spatial | ऊँचाई/गहराई/चौड़ाई की स्थिरता। |
| surround_compatibility | मोनो संगतता + फ़ेज़ स्कोर। |
| headphone_optimization | हेडफ़ोन प्लेबैक अनुकूलन स्कोर। |
| speaker_optimization | स्पीकर प्लेबैक अनुकूलन स्कोर। |
| genre | जॉनर वर्गीकरण और विश्वास। |
| voice | गायन की मौजूदगी और आवाज़ की विशेषताएँ। |
| instruments | वाद्य पहचान और अरेंजमेंट जानकारी। |
| mood | ऊर्जा/वैलेंस के साथ मूड प्रोफ़ाइल। |
| keywords | अर्थ-आधारित कीवर्ड और टैग। |
| loudness | LUFS, ट्रू पीक, क्लिपिंग और स्ट्रीमिंग लक्ष्य मापें, ताकि मास्टर पर्याप्त तेज़ रहे और डिस्टॉर्शन, कोडेक पीक या प्लैटफ़ॉर्म की अनपेक्षित समस्याएँ न हों। |
| noise | नॉइज़ फ़्लोर, बिजली का हम, हिस और आर्टिफ़ैक्ट मापें ताकि मास्टरिंग में तेज़, चमकीले और छिपाने में कठिन होने से पहले रिकॉर्डिंग साफ़ कर सकें। |
| format_quality | लॉसी एन्कोडिंग, स्पेक्ट्रल कटऑफ़ और बिट डेप्थ जाँचें, ताकि रिलीज़ से पहले गलती से खराब MP3, AAC या अपस्केल्ड ऑडियो से मास्टर न करें। |
| reference | रेफ़रेंस |
| visualizations | बनाए गए विश्लेषण विज़ुअल के URL। |
| ai_insights | LLM से बने सारांश और सुझाव। |
जवाब के आकार का नियंत्रण
detail_level इस्तेमाल करें:
- full (डिफ़ॉल्ट): पूरा पेलोड
- summary: फ़्रंटएंड/मोबाइल क्लाइंट के लिए संक्षिप्त पेलोड
उदाहरण
1) अपलोड + पूरा विश्लेषण
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3"
2) अपलोड + चुने मॉड्यूल
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3" \
-F "modules=frequency_balance,dynamic_range,genre,mood,keywords"
3) अपलोड + चुने मॉड्यूल + सार पेलोड
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3" \
-F "modules=frequency_balance,stereo_field,clarity,ai_insights" \
-F "detail_level=summary"
4) परीक्षण एंडपॉइंट
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
5) क्लाइंट-साइड JavaScript
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('modules', 'frequency_balance,dynamic_range,mood,ai_insights');
formData.append('detail_level', 'summary');
const res = await fetch('https://mixanalytic.com/api/upload', {
method: 'POST',
headers: { 'X-API-Key': 'YOUR_API_KEY' },
body: formData
});
const data = await res.json();
console.log(data.analysis, data.returned_modules);
मानक जवाब मेटाडेटा
सफल विश्लेषण उत्तरों में शामिल हैं:
- requested_modules
- returned_modules
- detail_level
- available_modules
त्रुटि कोड
| स्थिति | अर्थ | आम कारण |
|---|---|---|
| 400 | ख़राब अनुरोध | अमान्य module/detail_level, फ़ाइल फ़ील्ड गायब, खाली फ़ाइल। |
| 401 | प्रमाणित नहीं | API कुंजी अनुपस्थित, अमान्य या समाप्त है। |
| 403 | प्रतिबंधित | खाते की श्रेणी के लिए API एक्सेस की अनुमति नहीं। |
| 404 | नहीं मिला | /api/analyze/<file_id> फ़ाइल अब उपलब्ध नहीं (गोपनीयता हेतु हटाई गई)। |
| 413 | पेलोड बहुत बड़ा है | फ़ाइल 95MB से बड़ी है। |
| 429 | रेट लिमिट पार हुई | प्रति मिनट/घंटा/दिन बहुत अधिक अनुरोध। |
| 500 | सर्वर त्रुटि | विश्लेषण/रनटाइम विफलता। |
फ़्रंटएंड नोट
- वेब/मोबाइल क्लाइंट के लिए detail_level=summary चुनें।
- देरी और पेलोड घटाने के लिए पहली बार दिखाने हेतु केवल आवश्यक मॉड्यूल माँगें।
- 429 और 500 को दोबारा प्रयास और बढ़ती प्रतीक्षा से संभालें।
- सार्वजनिक बंडल में लंबे समय तक चलने वाली प्रोडक्शन कुंजियाँ उजागर न करें।