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.
- 401 nyckel saknas eller är ogiltig
- 403 gratisnyckel utan API-åtkomst
- 429 anropsgränsen har överskridits
Behörighetsområden: write används för Mixanalytic-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). |
| POST | /api/mastering | Ladda upp en mix och starta en mastringskörning (fyra masters). |
| GET | /api/mastering/<token> | Status och resultat för en mastringskörning. |
| GET | /api/mastering/<token>/<variant>.wav | Ladda ner en master som 24-bitars WAV. |
| 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 95MB. |
| 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 och artefakter så att du rengör inspelningen innan mastringen gör störningarna tydligare. |
| format_quality | Kontrollera förstörande kodning, spektral avskärning och bitdjup. Undvik att mastra från försämrade MP3-, AAC- eller uppskalade ljudkällor av misstag. |
| 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
2) Uppladdning + valda moduler
3) Uppladdning + valda moduler + sammanfattade svarsdata
4) Testendpoint
5) JavaScript på klientsidan
Standardmetadata i svaret
Lyckade analyssvar innehåller:
- requested_modules
- returned_modules
- detail_level
- available_modules
Mastring
Ladda upp en färdig mix och få fyra 24-bitars WAV-masters från en körning: dynamic, balanced, loud, chart. API:et använder samma motor, pris och månadskvot som Mastringsstudion.
- Mastring finns för Supporter-konton: 20 körningar per UTC-månad ingår, sedan använder varje körning tokens.
- En körning skapar alla fyra masters. Efter de inkluderade körningarna kostar en körning 85 tokens. Om en körning misslyckas får du tillbaka dess tokens eller den inkluderade körningen.
- Varje konto kan ha en körning igång åt gången, och gränsen delas med Mastringsstudion.
- Masters raderas 24 timmar efter att en körning är klar, eller efter 30 dagar på ett Supporter-konto, om inte körningen behålls i Mina masters. Ladda ner dem före expires_at i statussvaret.
- Att starta en körning kräver behörighetsområdet write. Status och nedladdningar kräver read.
Mastringsanrop
POST/api/mastering
Skicka mixen som multipart/form-data. Bara file är obligatoriskt.
| Fält | Typ | Obligatoriskt | Kommentarer |
|---|---|---|---|
| file | multipart file | Ja | Tillåtna format: mp3, wav, flac, aiff, m4a, aac, ogg. Max 95 MB och 12 minuter. Filens innehåll måste stämma med filändelsen. |
| tone | number | Nej | Klangtilt runt 1 kHz, i dB. Negativt är varmare, positivt är ljusare. -2 till 2 i steg om 0.5. Standard 0. |
| width | number | Nej | Sidonivå över 120 Hz, i dB. Negativt är smalare, positivt är bredare. Basen stannar i mitten. -3 till 2 i steg om 0.5. Standard 0. |
| punch | number | Nej | Glue-kompression som en multipel av den mängd som mättes i mixen. 0 stänger av glue. 0 till 1.5 i steg om 0.25. Standard 1. |
| loudness | number | Nej | Flyttar alla fyra ljudstyrkemål samtidigt, i LU. Om starkare skulle klämma ihop trummorna stannar mastern tidigare och skriver det i sina ändringar. -3 till 1.5 i steg om 0.5. Standard 0. |
| mono | string | Nej | Gör basen mono under 120 Hz. auto används bara när mätningen visar att mixen behöver det. En av auto, on, off. Standard auto. |
| deharsh | string | Nej | Sänker 4–9 kHz bara i de stunder det sticker ut. auto används bara när mätningen visar att mixen behöver det. En av auto, on, off. Standard auto. |
| source | string | Nej | Styr diskantmålet. ai rör aldrig luftbandet över 10 kHz och siktar lägre i diskanten. recorded siktar på en ljusare topp. auto använder AI-musikbedömningen från rapporten för song_id, eller kontrollerar uppladdningen själv. En av auto, ai, recorded. Standard auto. |
| style | string | Nej | Styr tyngden i botten och vilken master som rekommenderas. auto använder genren från rapporten för song_id. Utan song_id används ingen genre: botten förblir neutral och rekommendationen följer loudness-omfånget, så skicka en stil för att välja en. En av auto, pop, rock, hiphop, electronic, rnb, metal, acoustic. Standard auto. |
| song_id | integer | Nej | ID för en låt du har analyserat. Dess sparade rapport återanvänds i stället för att uppladdningen mäts. Ladda upp samma mix. |
| Idempotency-Key | header | Nej | 1–64 tecken: bokstäver, siffror, _ och -. |
Tal utanför ett intervall begränsas till intervallet och avrundas till dess steg. Ett värde som inte är ett tal, eller ett okänt val, ger 400 med invalid_settings.
Skicka headern Idempotency-Key för att kunna försöka igen säkert, med en ny nyckel för varje mix. Om ditt konto upprepar en nyckel medan körningen fortfarande finns debiteras eller startas inget igen: du får 200 med det ursprungliga svaret plus "replayed": true. Kommer upprepningen medan den första begäran fortfarande startar får du 429 busy. Efter 503 failed försöker du igen med en ny nyckel.
Svar vid start
En ny körning ger 202:
En körning från Supporter-kvoten har "billed": "included" och "charged": 0. Supporter-konton får också objektet included med used, cap, reset_date.
Mastringsstatus och nedladdningar
GET/api/mastering/<token>
Hämta statusen med 3–5 sekunders mellanrum, inom nyckelns anropsgräns, tills den är done eller error.
- pending: mastersen skapas.
- settling: körningen misslyckades och dess tokens eller inkluderade körning återbetalas just nu. Fortsätt hämta statusen.
- done: de fyra mastersen är klara.
- error: körningen misslyckades och det som debiterades har återbetalats. Fältet error anger varför: too_long, too_short, too_quiet, failed.
Svaret för en klar körning innehåller recommended, recommended_reason, warnings, source, settings, masters, expires_at, filename. Varje objekt i masters har key, url, target_lufs, ceiling, metrics, changes, peaks.
Svar för klara och misslyckade körningar innehåller också access: ditt saldo och dina inkluderade körningar efter körningen.
Okända eller utgångna körnings-tokens, liksom tokens för andra kontons körningar, ger 404 med {"status": "expired"}.
Nedladdning
GET/api/mastering/<token>/<variant>.wav
Ger mastern som en bifogad 24-bitars WAV-fil uppkallad efter din uppladdning, till exempel My Mix - balanced.wav. variant är en av dynamic, balanced, loud, chart.
En okänd variant, ett annat kontos körnings-token eller en körning som har gått ut eller inte är klar ger 404.
Alla mastringssvar skickas med Cache-Control: private, no-store.
Mastringsfel
Fel returneras som {"error": "invalid_file", "message": "…"}.
| Status | Fel | Betydelse |
|---|---|---|
| 400 | invalid_file | Fil saknas, formatet stöds inte eller innehållet stämmer inte med filändelsen. |
| 400 | invalid_settings | En inställning är inte ett tal eller inte ett av de tillåtna valen. |
| 400 | invalid_idempotency_key | Headern Idempotency-Key består inte av 1–64 bokstäver, siffror, _ eller -. |
| 402 | insufficient_credits | Inte tillräckligt med tokens. Svaret innehåller cost och balance. |
| 403 | Forbidden | En nyckel från ett gratiskonto, eller en nyckel utan det behörighetsområde som endpointen kräver. En Supporter vars förnyelsebetalning misslyckades räknas som ett gratiskonto tills betalningen går igenom, så under tiden fungerar mastring bara i Mastringsstudion. Inget debiteras. |
| 403 | supporter_only | Mastring är bara öppen för Supporter-konton än så länge. Inget debiteras. |
| 413 | File too large | Filen är större än 95 MB, så begäran avvisas innan den når endpointen, ibland utan JSON-svar. En fil som bara är strax över gränsen får invalid_file i stället. |
| 429 | busy | En körning pågår eller startar redan för det här kontot, från API:et eller studion. Svaret innehåller dess token, som är null medan körningen fortfarande startar. |
| 429 | Rate Limit Exceeded | Nyckelns gräns per minut, timme eller dygn har nåtts. Meddelandet säger vilken. |
| 503 | failed | Körningen kunde inte starta. Allt som debiterades för den återbetalas. |
Mastringsexempel
1) Starta en körning
2) Hämta status tills körningen är klar
3) Ladda ner en master
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 95MB. |
| 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.