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 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-dataKontroll av anslutning och autentisering.
POST/api/uploadLadda upp och analysera en ljudfil.
GET/api/analyze/<file_id>Analysera igen med fil-ID (om originalfilen fortfarande finns).
POST/api/masteringLadda 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>.wavLadda ner en master som 24-bitars WAV.
GET/api/content/analysis-feedResearchflöde med känsliga uppgifter borttagna för innehållsagenter, endast för administratörer.
POST/api/content/draftsEndpoint för att spara och uppdatera utkast för innehållsagenter, endast för administratörer.
GET/api/ai-stats?days=30Användningsstatistik för AI-analys.

Uppladdningsanrop

POST/api/upload

Fält Typ Obligatoriskt Kommentarer
filemultipart fileJaTillåtna format: mp3, wav, flac, m4a, aac, ogg. Max 95MB.
modulesstring/listNejAlla moduler används som standard om fältet utelämnas.
detail_levelstringNejfull (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_balanceFrekvens- och balanspoäng i 7 band.
dynamic_rangeDynamiskt omfång, crestfaktor, PLR.
stereo_fieldMått på bredd, fas och korrelation.
clarityMått på spektral tydlighet och definition.
harmonic_contentTonart och harmonisk komplexitet.
transientsData om attack, transienttäthet och basens anslag.
3d_spatialKonsekvent höjd, djup och bredd.
surround_compatibilityMonokompatibilitet + faspoäng.
headphone_optimizationOptimeringspoäng för hörlursuppspelning.
speaker_optimizationOptimeringspoäng för högtalaruppspelning.
genreGenreklassificering och säkerhetsvärde.
voiceSångnärvaro och röstegenskaper.
instrumentsInstrumentdetektering och arrangemangsinformation.
moodStämningsprofil med energi och valens.
keywordsSemantiska nyckelord och taggar.
loudnessMät LUFS, true peak, klippning och streamingmål så att din master är tillräckligt stark utan distorsion, codec-toppar eller överraskningar på plattformarna.
noiseMät brusgolv, nätbrum och artefakter så att du rengör inspelningen innan mastringen gör störningarna tydligare.
format_qualityKontrollera 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.
referenceReferens
visualizationsURL:er till genererade visuella analysresurser.
ai_insightsSammanfattning 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

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
filemultipart fileJaTillå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.
tonenumberNejKlangtilt runt 1 kHz, i dB. Negativt är varmare, positivt är ljusare. -2 till 2 i steg om 0.5. Standard 0.
widthnumberNejSidonivå ö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.
punchnumberNejGlue-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.
loudnessnumberNejFlyttar 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.
monostringNejGö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.
deharshstringNejSä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.
sourcestringNejStyr 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.
stylestringNejStyr 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_idintegerNejID 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-KeyheaderNej1–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:

{ "token": "3b9f0c2e7d4a41f6a8e5c1b2d3f4a5b6", "status": "pending", "status_url": "/api/mastering/3b9f0c2e7d4a41f6a8e5c1b2d3f4a5b6", "billed": "tokens", "charged": 85, "balance": 415, "expires_in_hours": 720 }

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
400invalid_fileFil saknas, formatet stöds inte eller innehållet stämmer inte med filändelsen.
400invalid_settingsEn inställning är inte ett tal eller inte ett av de tillåtna valen.
400invalid_idempotency_keyHeadern Idempotency-Key består inte av 1–64 bokstäver, siffror, _ eller -.
402insufficient_creditsInte tillräckligt med tokens. Svaret innehåller cost och balance.
403ForbiddenEn 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.
403supporter_onlyMastring är bara öppen för Supporter-konton än så länge. Inget debiteras.
413File too largeFilen ä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.
429busyEn 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.
429Rate Limit ExceededNyckelns gräns per minut, timme eller dygn har nåtts. Meddelandet säger vilken.
503failedKörningen kunde inte starta. Allt som debiterades för den återbetalas.

Mastringsexempel

1) Starta en körning

curl -X POST "https://mixanalytic.com/api/mastering" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Idempotency-Key: YOUR_UNIQUE_KEY_FOR_THIS_MIX" \ -F "file=@/path/to/mix.wav" \ -F "style=electronic" \ -F "loudness=0.5"

2) Hämta status tills körningen är klar

curl "https://mixanalytic.com/api/mastering/TOKEN" \ -H "X-API-Key: YOUR_API_KEY"

3) Ladda ner en master

curl -o "mix - balanced.wav" "https://mixanalytic.com/api/mastering/TOKEN/balanced.wav" \ -H "X-API-Key: YOUR_API_KEY"

Felkoder

Status Betydelse Vanlig orsak
400Felaktigt anropOgiltig modul/detail_level, saknat file-fält, tom fil.
401Ej auktoriseradAPI-nyckel saknas, är ogiltig eller har löpt ut.
403FörbjudetAPI-åtkomst tillåts inte för kontonivån.
404Hittades inte/api/analyze/<file_id> filen är inte längre tillgänglig (borttagen av integritetsskäl).
413För stor datamängdFilen är större än 95MB.
429Anropsgräns överskridenFör många anrop per minut, timme eller dag.
500ServerfelAnalys- 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.