Production
Dokumentasyon ng Mixanalytic API
Opisyal na sanggunian ng API para sa https://mixanalytic.com. Gamitin ang API na ito para mag-upload ng audio at makatanggap ng pagsusuri ng mix gamit ang AI, na may mapipiling mga module at compact/buong mode ng tugon.
Base URL: https://mixanalytic.com/api
Authentication
Ipadala ang API key mo sa header na X-API-Key para sa bawat request.
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
- 401 kulang o hindi wastong key
- 403 key ng libreng tier na walang access sa API
- 429 lumampas sa rate limit
Mga Scope: Para sa pag-upload/pagsusuri ng Mixanalytic ang write. Binabasa ng content ang data ng pananaliksik ng nilalaman na inalisan ng sensitibong detalye. Sine-save ng content_write ang mga hindi pampublikong draft ng nilalaman. Para lang sa admin ang mga content scope.
Mga Endpoint
| Pamamaraan | Path | Layunin |
|---|---|---|
| GET | /api/test-data | Pagsusuri ng koneksyon/authentication. |
| POST | /api/upload | Mag-upload at magsuri ng audio file. |
| GET | /api/analyze/<file_id> | Muling magsuri gamit ang file ID (kung umiiral pa ang orihinal na file). |
| GET | /api/content/analysis-feed | Research feed na inalisan ng sensitibong detalye para sa mga content agent, para lamang sa admin. |
| POST | /api/content/drafts | Endpoint sa pag-save/pag-update ng draft para sa mga content agent, para lamang sa admin. |
| GET | /api/ai-stats?days=30 | Mga istatistika ng paggamit para sa pagsusuri ng AI. |
Upload Request
POST/api/upload
| Field | Uri | Kinakailangan | Mga Tala |
|---|---|---|---|
| file | multipart file | Oo | Pinapayagan: mp3, wav, flac, m4a, aac, ogg. Hanggang 95MB. |
| modules | string/list | Hindi | Lahat ng module ang ginagamit bilang default kung hindi tinukoy. |
| detail_level | string | Hindi | full (default) o summary. |
Nagbabalik ng 400 kapag hindi wasto ang detail_level. Nagbabalik ng 413 ang mga sobrang laking file.
Pagpili ng Module
Kontrolin kung aling mga module ng pagsusuri ang ibinabalik (at kinakalkula) gamit ang modules.
Mga sinusuportahang format:
- String na pinaghihiwalay ng kuwit: modules=frequency_balance,clarity,mood
- JSON array string: modules=["frequency_balance","clarity","mood"]
- Inuulit na key (query/form): modules=frequency_balance&modules=clarity
- Lahat ng module: modules=all o modules=*
| Module | Paglalarawan |
|---|---|
| frequency_balance | Pagmamarka ng frequency at balanse sa 7-band. |
| dynamic_range | Dynamic range, crest factor, PLR. |
| stereo_field | Mga sukatan ng width/phase/correlation. |
| clarity | Mga sukatan ng linaw at pagkakabukod ng detalye sa spectrum. |
| harmonic_content | Key at harmonic complexity. |
| transients | Data ng attack, transient density at low-end punch. |
| 3d_spatial | Pagkakatugma ng height/depth/width. |
| surround_compatibility | Mono compatibility at marka ng phase. |
| headphone_optimization | Marka ng pag-optimize ng playback sa headphone. |
| speaker_optimization | Marka ng pag-optimize ng playback sa speaker. |
| genre | Pag-uuri ng genre at confidence. |
| voice | Paglitaw ng vocal at mga katangian ng boses. |
| instruments | Impormasyon sa pagtukoy ng instrumento at arrangement. |
| mood | Mood profile na may energy/valence. |
| keywords | Mga semantic keyword at tag. |
| loudness | Sukatin ang LUFS, true peak, clipping, at mga target ng streaming para manatiling sapat ang lakas ng iyong master nang walang distortion, codec peak, o sorpresa mula sa platform. |
| noise | Sukatin ang noise floor, mains hum, hiss, at mga artifact para malinis mo ang mga recording bago pa sila lumakas, tumingkad, at maging mas mahirap itago sa mastering. |
| format_quality | Suriin ang lossy encoding, spectral cutoff, at bit depth para hindi ka aksidenteng mag-master mula sa degradadong MP3, AAC, o upscaled na audio source bago ang release. |
| reference | Reference |
| visualizations | Mga URL para sa mga nabuong visual asset ng pagsusuri. |
| ai_insights | Buod at mga rekomendasyong binuo ng LLM. |
Pagkontrol sa Laki ng Tugon
Gamitin ang detail_level:
- full (default): buong payload
- summary: compact na payload para sa mga frontend/mobile client
Mga Halimbawa
1) Mag-upload at buong pagsusuri
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3"
2) Mag-upload at mga napiling module
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) Mag-upload at mga napiling module at buod na payload
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) Test endpoint
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
5) JavaScript sa client side
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);
Karaniwang Metadata ng Tugon
Kasama sa mga matagumpay na tugon ng pagsusuri ang:
- requested_modules
- returned_modules
- detail_level
- available_modules
Mga Error Code
| Status | Kahulugan | Karaniwang Dahilan |
|---|---|---|
| 400 | Hindi Wastong Request | Hindi wastong module/detail_level, kulang na file field, o bakanteng file. |
| 401 | Walang Awtorisasyon | Kulang, hindi wasto o nag-expire na API key. |
| 403 | Ipinagbabawal | Hindi pinapayagan ang access sa API para sa tier ng account. |
| 404 | Hindi Natagpuan | /api/analyze/<file_id> hindi na available ang file (pagbura para sa privacy). |
| 413 | Masyadong Malaki ang Payload | Mas malaki sa 95MB ang file. |
| 429 | Lumampas sa Rate Limit | Masyadong maraming request bawat minuto/oras/araw. |
| 500 | Error sa Server | Pagkabigo sa pagsusuri/runtime. |
Mga Tala para sa Frontend
- Para sa mga web/mobile client, mas piliin ang detail_level=summary.
- Hilingin lamang ang mga module na kailangan sa unang pag-render para mabawasan ang latency at payload.
- Hawakan ang 429 at 500 gamit ang retry at backoff.
- Huwag ilantad sa mga pampublikong bundle ang mga pangmatagalang production key.