Produktion
Mixanalytic API-dokumentation
Officiell API-referens för https://mixanalytic.com. Ladda upp ljud och få AI-baserad mixanalys med valbara moduler och kompakta eller fullständiga svar.
Bas-URL: https://mixanalytic.com/api
Autentisering
Skicka din API-nyckel i headern X-API-Key för varje anrop.
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
- 401 nyckel saknas eller är ogiltig
- 403 gratisnyckel utan API-åtkomst
- 429 anropsgränsen har överskridits
Behörighetsområden: write används för Mix Analyzer-uppladdning och analys. content läser data för innehållsresearch med känsliga uppgifter borttagna. content_write sparar opublicerade innehållsutkast. Innehållsbehörigheter är bara för administratörer.
Endpoints
| Metod | Sökväg | Syfte |
|---|---|---|
| GET | /api/test-data | Kontroll av anslutning och autentisering. |
| POST | /api/upload | Ladda upp och analysera en ljudfil. |
| GET | /api/analyze/<file_id> | Analysera igen med fil-ID (om originalfilen fortfarande finns). |
| GET | /api/content/analysis-feed | Researchflöde med känsliga uppgifter borttagna för innehållsagenter, endast för administratörer. |
| POST | /api/content/drafts | Endpoint för att spara och uppdatera utkast för innehållsagenter, endast för administratörer. |
| GET | /api/ai-stats?days=30 | Användningsstatistik för AI-analys. |
Uppladdningsanrop
POST/api/upload
| Fält | Typ | Obligatoriskt | Kommentarer |
|---|---|---|---|
| file | multipart file | Ja | Tillåtna format: mp3, wav, flac, m4a, aac, ogg. Max 100MB. |
| modules | string/list | Nej | Alla moduler används som standard om fältet utelämnas. |
| detail_level | string | Nej | full (standard) eller summary. |
Ogiltig detail_level ger 400. För stora filer ger 413.
Modulval
Styr vilka analysmoduler som returneras och beräknas med modules.
Format som stöds:
- Kommaseparerad sträng: modules=frequency_balance,clarity,mood
- Sträng med en JSON-array: modules=["frequency_balance","clarity","mood"]
- Upprepad nyckel (frågeparameter/formulär): modules=frequency_balance&modules=clarity
- Alla moduler: modules=all eller modules=*
| Modul | Beskrivning |
|---|---|
| frequency_balance | Frekvens- och balanspoäng i 7 band. |
| dynamic_range | Dynamiskt omfång, crestfaktor, PLR. |
| stereo_field | Mått på bredd, fas och korrelation. |
| clarity | Mått på spektral tydlighet och definition. |
| harmonic_content | Tonart och harmonisk komplexitet. |
| transients | Data om attack, transienttäthet och basens anslag. |
| 3d_spatial | Konsekvent höjd, djup och bredd. |
| surround_compatibility | Monokompatibilitet + faspoäng. |
| headphone_optimization | Optimeringspoäng för hörlursuppspelning. |
| speaker_optimization | Optimeringspoäng för högtalaruppspelning. |
| genre | Genreklassificering och säkerhetsvärde. |
| voice | Sångnärvaro och röstegenskaper. |
| instruments | Instrumentdetektering och arrangemangsinformation. |
| mood | Stämningsprofil med energi och valens. |
| keywords | Semantiska nyckelord och taggar. |
| loudness | Mät LUFS, true peak, klippning och streamingmål så att din master är tillräckligt stark utan distorsion, codec-toppar eller överraskningar på plattformarna. |
| noise | Mät brusgolv, nätbrum, högfrekvent brus och artefakter så att du kan rengöra inspelningar innan mastringen gör störningarna starkare, ljusare och svårare att dölja. |
| format_quality | Kontrollera förstörande kodning, spektral avskärning och bitdjup så att du inte av misstag mastrar från försämrade MP3-, AAC- eller uppskalade ljudkällor inför utgivningen. |
| reference | Referens |
| visualizations | URL:er till genererade visuella analysresurser. |
| ai_insights | Sammanfattning och rekommendationer genererade av en LLM. |
Kontroll av svarsstorlek
Använd detail_level:
- full (standard): fullständiga svarsdata
- summary: kompakta svarsdata för frontend- och mobilklienter
Exempel
1) Uppladdning + fullständig analys
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3"
2) Uppladdning + valda moduler
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) Uppladdning + valda moduler + sammanfattade svarsdata
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) Testendpoint
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
5) JavaScript på klientsidan
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);
Standardmetadata i svaret
Lyckade analyssvar innehåller:
- requested_modules
- returned_modules
- detail_level
- available_modules
Felkoder
| Status | Betydelse | Vanlig orsak |
|---|---|---|
| 400 | Felaktigt anrop | Ogiltig modul/detail_level, saknat file-fält, tom fil. |
| 401 | Ej auktoriserad | API-nyckel saknas, är ogiltig eller har löpt ut. |
| 403 | Förbjudet | API-åtkomst tillåts inte för kontonivån. |
| 404 | Hittades inte | /api/analyze/<file_id> filen är inte längre tillgänglig (borttagen av integritetsskäl). |
| 413 | För stor datamängd | Filen är större än 100MB. |
| 429 | Anropsgräns överskriden | För många anrop per minut, timme eller dag. |
| 500 | Serverfel | Analys- eller körningsfel. |
Kommentarer för frontend
- För webb- och mobilklienter bör du använda detail_level=summary.
- Begär bara de moduler som behövs vid första renderingen för att minska fördröjning och svarsstorlek.
- Hantera 429 och 500 med nya försök och successivt längre väntetider.
- Exponera inte långlivade produktionsnycklar i publika kodpaket.