turbo@mvsep.com
MVSEP API ger programmatisk åtkomst för att skapa en separation, returnera resultaten, hämta platsinformation och kontrollera användarfunktioner.
För att använda denna API behöver du en API-nyckel. Du är inte inloggad, vänligen logga in för att få din API-token.
Exempel i Python: https://github.com/ZFTurbo/MVSep-API-Examples
Inofficiell applikation MacVSep för Mac OS: https://github.com/septcoco/macvsep
Webhooks kan konfigureras här: Webhooks-sida
OpenAPI-specifikatio: mvsep-openapi-spec.json
Observera att Premium-användare kan begära obegränsat antal samtidiga jobb, medan icke-Premium-användare bara kan begära ett samtidigt jobb.
För att skapa separation behöver du göra ett POST-anrop till följande url:
https://mvsep.com/api/separation/create
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Din API-nyckel |
| audiofile | Binär | Ljudfil som ska bearbetas. Krävs inte om parametern url är inställd eller om modellen inte använder filinmatning. För matchningsmodeller, använd target_audiofile och reference_audiofile för inmatning istället för audiofile. |
| url | Sträng | Länk till ljudfilen. Krävs inte om parametern audiofile är inställd. |
| remote_type | Sträng | (valfritt) Fjärrtyp för ljudfilen. Standardinställningen är direct. Krävs inte om parametern audiofile är inställd. Typer som stöds är direct (Direktnedladdning), mega (MEGA), drive (Google Drive), dropbox (Dropbox) |
| sep_type | Heltal | (valfritt) Separationstyp, standardinställning till 11 (Demucs3 Modell B (sång, trummor, bas, annat)) |
| add_opt1 | Sträng | (valfritt) Första ytterligare fältet för separationstyp |
| add_opt2 | Sträng | (valfritt) Andra ytterligare fältet för separationstyp |
| add_opt3 | Sträng | (valfritt) Separation Typ tredje tilläggsfältet |
| output_format | Heltal | (valfritt) utdataformat, standardinställning till 0 (mp3 (320kbps)) |
| is_demo | Boolean | (valfritt) om separationen ska publiceras på demosidan, standardinställning till false |
| Namn | Värde | Ytterligare fält |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Nyckel: add_opt1 Namn: Output files Alternativ:
Nyckel: add_opt2 Namn: Model Type Alternativ:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Nyckel: add_opt1 Namn: Output files Alternativ:
Nyckel: add_opt2 Namn: Model Type Alternativ:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Nyckel: add_opt1 Namn: Output files Alternativ:
Nyckel: add_opt2 Namn: Model Type Alternativ:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| BS Roformer (vocals, instrumental) | 40 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
|
| BS PolarFormer (vocals, instrumental) | 123 | Nyckel: add_opt1 Namn: Overlap Alternativ:
|
| MelBand Roformer (vocals, instrumental) | 48 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
|
| MDX23C (vocals, instrumental) | 25 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
|
| SCNet (vocals, instrumental) | 46 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
|
| MDX B (vocals, instrumental) | 23 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Nyckel: add_opt1 Namn: Model Type Alternativ:
Nyckel: add_opt2 Namn: Agressiveness Alternativ:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Nyckel: add_opt1 Namn: Karaoke model type Alternativ:
Nyckel: add_opt2 Namn: Extraction type Alternativ:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Nyckel: add_opt1 Namn: Karaoke model type Alternativ:
|
| MVSep Crowd removal (crowd, other) | 34 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| Medley Vox (Multi-singer separation) | 53 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Nyckel: add_opt1 Namn: Model Type Alternativ:
|
| MVSep Male/Female separation | 57 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Choir (choir, other) | 112 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Drums (drums, other) | 44 | Nyckel: add_opt1 Namn: Drums model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
Nyckel: add_opt3 Namn: Output files Alternativ:
|
| MVSep Bass (bass, other) | 41 | Nyckel: add_opt1 Namn: Bass model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
Nyckel: add_opt3 Namn: Output files Alternativ:
|
| MVSep Synth (synth, other) | 88 | Nyckel: add_opt1 Namn: How to extract Alternativ:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Nyckel: add_opt1 Namn: Model Type Alternativ:
Nyckel: add_opt2 Namn: Preprocess Alternativ:
|
| MVSep Piano (piano, other) | 29 | Nyckel: add_opt1 Namn: Piano model type Alternativ:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Nyckel: add_opt1 Namn: Organ model type Alternativ:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Nyckel: add_opt1 Namn: Guitar model type Alternativ:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| MVSep Plucked Strings (plucked-strings, other) | 102 | |
| MVSep Harp (harp, other) | 72 | |
| MVSep Mandolin (mandolin, other) | 74 | |
| MVSep Banjo (banjo, other) | 83 | |
| MVSep Sitar (sitar, other) | 90 | |
| MVSep Ukulele (ukulele, other) | 96 | |
| MVSep Dobro (dobro, other) | 97 | |
| MVSep Bowed Strings (strings, other) | 52 | Nyckel: add_opt1 Namn: String model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Cello (cello, other) | 70 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Double Bass (double-bass, other) | 73 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Wind (wind, other) | 54 | Nyckel: add_opt1 Namn: Wind model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
Nyckel: add_opt3 Namn: Output files Alternativ:
|
| MVSep Brass (brass, other) | 107 | Nyckel: add_opt1 Namn: How to extract Alternativ:
|
| MVSep Woodwind (woodwind, other) | 108 | Nyckel: add_opt1 Namn: How to extract Alternativ:
|
| MVSep Saxophone (saxophone, other) | 61 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| MVSep Flute (flute, other) | 67 | Nyckel: add_opt1 Namn: Flute model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Trumpet (trumpet, other) | 71 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Trombone (trombone, other) | 75 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Oboe (oboe, other) | 77 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Clarinet (clarinet, other) | 78 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep French Horn (french-horn, other) | 82 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Harmonica (harmonica, other) | 87 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Percussion (percussion, other) | 105 | |
| MVSep Tambourine (tambourine, other) | 76 | |
| MVSep Marimba (marimba, other) | 84 | |
| MVSep Glockenspiel (glockenspiel, other) | 85 | |
| MVSep Timpani (timpani, other) | 86 | |
| MVSep Triangle (triangle, other) | 89 | |
| MVSep Congas (congas , other) | 94 | |
| MVSep Bells (bells, other) | 95 | |
| MVSep Wind Chimes (wind-chimes, other) | 98 | |
| MVSep Xylophone (xylophone, other) | 109 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Celesta (celesta, other) | 110 | Nyckel: add_opt2 Namn: How to extract Alternativ:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Nyckel: add_opt1 Namn: Model Type Alternativ:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: How to extract Alternativ:
Nyckel: add_opt3 Namn: Output files Alternativ:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: Cutoff (Hz) Alternativ:
|
| Reverb Removal (noreverb) | 22 | Nyckel: add_opt1 Namn: Model Type Alternativ:
Nyckel: add_opt2 Namn: Preprocess Alternativ:
|
| DeNoise by aufr33 and gabox | 47 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| AudioSR (Super Resolution) | 59 | Nyckel: add_opt1 Namn: Cutoff (Hz) Alternativ:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Nyckel: add_opt1 Namn: Text prompt Alternativ: Nyckel: add_opt2 Namn: Length (in seconds) Alternativ:
|
| Whisper (extract text from audio) | 39 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: Transcription type Alternativ:
|
| Parakeet (extract text from audio) | 64 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: Version Alternativ:
|
| VibeVoice (Voice Cloning) | 103 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: Text prompt Alternativ: Nyckel: add_opt3 Namn: Extract vocals first Alternativ:
|
| VibeVoice (TTS) | 104 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: Text prompt Alternativ: |
| Qwen3-TTS (Custom Voice) | 118 | Nyckel: add_opt1 Namn: Text prompt Alternativ: Nyckel: add_opt2 Namn: Speaker Alternativ:
Nyckel: add_opt3 Namn: Language Alternativ:
Nyckel: add_opt4 Namn: Voice description Alternativ: |
| Qwen3-TTS (Voice Design) | 119 | Nyckel: add_opt1 Namn: Text prompt Alternativ: Nyckel: add_opt2 Namn: Voice description Alternativ: Nyckel: add_opt3 Namn: Language Alternativ:
|
| Qwen3-TTS (Voice Cloning) | 120 | Nyckel: add_opt1 Namn: Text prompt Alternativ: Nyckel: add_opt2 Namn: Reference text in audio (optional) Alternativ: Nyckel: add_opt3 Namn: Language Alternativ:
Nyckel: add_opt4 Namn: Extract vocals first Alternativ:
|
| Bark (Speech Gen) | 115 | Nyckel: add_opt1 Namn: Text prompt Alternativ: Nyckel: add_opt2 Namn: Speaker Alternativ:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Nyckel: add_opt1 Namn: Model Type Alternativ:
|
| Aspiration (by Sucial) | 50 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| Phantom Centre extraction | 55 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Nyckel: add_opt1 Namn: How to use Alternativ:
|
| Transkun (piano -> midi) | 113 | Nyckel: add_opt1 Namn: How to extract Alternativ:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Nyckel: add_opt1 Namn: Lyrics Alternativ: Nyckel: add_opt10 Namn: Topic Alternativ:
Nyckel: add_opt2 Namn: Tags (optional) Alternativ: Nyckel: add_opt3 Namn: Genre Alternativ:
Nyckel: add_opt4 Namn: Timbre Alternativ:
Nyckel: add_opt5 Namn: Gender Alternativ:
Nyckel: add_opt6 Namn: Mood Alternativ:
Nyckel: add_opt7 Namn: Instrument Alternativ:
Nyckel: add_opt8 Namn: Scene Alternativ:
Nyckel: add_opt9 Namn: Region Alternativ:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
|
| Vit Large 23 (vocals, instrum) | 33 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| UVRv5 Demucs (vocals, music) | 17 | Nyckel: add_opt1 Namn: Model Type Alternativ:
|
| MVSep DNR (music, sfx, speech) | 18 | |
| MVSep Old Vocal Model (vocals, music) | 19 | |
| Demucs2 (vocals, drums, bass, other) | 13 | |
| Danna Sep (vocals, drums, bass, other) | 15 | |
| Byte Dance (vocals, drums, bass, other) | 16 | |
| MVSep MelBand Roformer (vocals, instrum) | 35 | |
| spleeter | 0 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| UnMix | 3 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| Zero Shot (Query Based) (Low quality) | 14 | Nyckel: add_opt1 Namn: Model Type Alternativ:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Nyckel: add_opt1 Namn: Model type Alternativ:
|
| Namn | Värde |
|---|---|
| mp3 (320 kbps) | 0 |
| wav (uncompressed, 16 bit) | 1 |
| flac (lossless, 16 bit) | 2 |
| m4a (lossy) | 3 |
| wav (uncompressed, 32 bit) | 4 |
| flac (lossless, 24 bit) | 5 |
curl --location --request POST 'https://mvsep.com/api/separation/create'
--form 'audiofile=@"/path/to/file.mp3"'
--form 'api_token="<Din API-token>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Nyckel | Värde |
|---|---|
| success |
|
| data | Innehåller extra information beroende på framgång-nyckeln |
| data -> link | Visar länk till "GET RESULT" URL för skapat jobb (visas endast när framgång är sant) |
| data -> hash | Visar skapad jobbhash (visas endast när framgång är sant) |
| data -> message | Visar beskrivningen av ett fel (visas endast när framgång är false) |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Vissa parametrar saknas eller är ogiltiga. Detta fel uppstår när du inte anger alla obligatoriska parametrar eller anger ogiltiga parametrar. |
| 401 |
Okänd eller ogiltig api_token. Detta fel uppstår om du använder en okänd API-nyckel
|
För att få separationens resultat behöver du göra ett GET-anrop till följande url:
https://mvsep.com/api/separation/get
| Fält | Typ | Beskrivning |
|---|---|---|
| hash | Sträng | Separations-Hash |
| mirror | Heltal | (valfritt) Använder en annan spegel om satt till 1, standard till 0. Kräver api_token och 1 kredit om satt till 1. |
| api_token | Sträng | (valfritt) API-nyckel för användaren. Krävs om spegelparametern är inställd på 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Nyckel | Värde |
|---|---|
| success |
|
| status |
|
| data | Innehåller extra information beroende på status-tangenten |
| data -> queue_count | Visar antalet obearbetade jobb i användarens prioritet (visas endast när status är |
| data -> current_order | Visar ordningen på användarens jobb (visas endast när status är |
| data -> message | Visar en beskrivning av status (visas på alla statusar, visar felorsak istället när status är failed) |
| data -> algorithm | Visar den algoritm som används för jobbet (visas endast när status är done) |
| data -> algorithm_description | Visar den algoritm som används för jobbet (visas endast när status är done) |
| data -> output_format | Visar utdataformatet för jobbet (visas endast när status är done) |
| data -> tags | Visar metataggarna för ljud (visas endast när status är done) |
| data -> input_file | Visar information om nedladdning av indataljud (visas endast när status är done) |
| data -> files | Visar information om nedladdning av utdataljud (visas endast när status är done) |
| data -> date | Visar bearbetningsdatum för jobbet (visas endast när status är |
| data -> finished_chunks | Visar antalet färdiga delar av ett stort jobb (visas endast när status är |
| data -> all_chunks | Visar numret på alla delar i ett stort jobb (visas endast när status är |
För att få resultatet av ett fjärrjobb måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/separation/get-remote
| Fält | Typ | Beskrivning |
|---|---|---|
| hash | Sträng | Separations-Hash |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Nyckel | Värde |
|---|---|
| success |
|
| status |
|
| data | Innehåller extra information beroende på status-tangenten |
| data -> queue_count | Visar antalet obearbetade jobb i användarens prioritet (visas endast när status är väntar). |
| data -> current_order | Visar ordningen på användarens jobb (visas endast när status är väntar). |
| data -> message | Visar statusbeskrivningen (endast när status är misslyckad). |
| data -> link | Visar länk till "HÄMTA RESULTAT"-URL:en för det skapade jobbet (visas endast när status är klar). |
| data -> hash | Hash för separationen (visas endast när status är klar). |
För att avbryta separationen och återbetala använda krediter (om separationen inte behandlas ännu) måste du göra ett POST-anrop till följande URL:
https://mvsep.com/api/separation/cancel
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
| hash | Sträng | Separations-Hash |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Din API-token>"' --form 'hash="<hash>"'
| Nyckel | Värde |
|---|---|
| success |
|
För att få detaljerade data om separationstyper måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/app/algorithms
| Fält | Typ | Beskrivning |
|---|---|---|
| scopes | Sträng | Om modeller som använder olika former av indata ska inkluderas.
single_upload om inget alternativ anges. För att hämta alla modeller, ange scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Returnerar data som en matris:
| Nyckel | Värde |
|---|---|
| render_id | Värde för separationstyp (ID) |
| name | Namnet på separationstypen |
| algorithm_group_id | Gruppen där separationstypen tillhör: |
| algorithm_group | Innehåller information om den algoritmgrupp som algoritmen till |
| algorithm_group -> name | Namn på algoritmgruppen |
| audio_widget |
Typen av ljudwidget som ska användas för algoritmen. Detta kan användas för att bestämma hur ljudspelaren för algoritmen ska visas på gränssnittet. Möjliga värden är:
|
| orientation |
För vem är den här separationstypen avsedd:
|
| order_id | Ordningen på separationstypen |
| price_coefficient |
Används för att beräkna hur många krediter jobbet tar från premiumanvändare. Använder denna formel : floor(<Audiofile duration in seconds> * price_coefficient / 60)?:1
|
| usage | Visar månatligt användningsantal för separationstypen |
| rating | Visar månatlig användningsklassificering av separationstypen som array:
|
| algorithm_fields | Innehåller information om ytterligare fält av separationstypen |
| algorithm_fields -> name |
Visar vilket ytterligare fält av separationstypen:
|
| algorithm_fields -> text | Visningsnamn för det ytterligare fältet av separationstypen. |
| algorithm_fields -> options | JSON-kodade nyckelvärdekedjor för ytterligare fält |
| algorithm_fields -> default_key | Standardvärde för det extra fältet. En av nycklarna till <kod>algorithm_fields -> alternativ</kod> |
| algorithm_descriptions | Innehåller information om beskrivningar av separationstypen |
| algorithm_descriptions -> short_description | Liten beskrivning av separationstypen som inte använder HTML. |
| algorithm_descriptions -> long_description | Detaljerad beskrivning av separationstypen som använder HTML. |
| algorithm_descriptions -> lang | Specificerad språkkod för beskrivningen. |
Om du vill få information om de senaste nyheterna om MVSEP måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/app/news
| Fält | Typ | Beskrivning |
|---|---|---|
| lang | Sträng | (valfritt) Språkkod med 2 bokstäver (en, ru) |
| start | Heltal | (valfritt) Startpunktsförskjutning, standardvärdet är 0 (dvs. starta från senaste) |
| limit | Heltal | (valfritt) Maximalt antal returnerade resultat, standardvärdet är 10, maxvärdet är 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Returnerar data som en matris:
| Nyckel | Värde |
|---|---|
| title | Titel på nyheten |
| lang | Titel på nyheten |
| text | Fullständig beskrivning av nyheten |
| created_at | Datum för beskedet |
För att hämta information om webbplatsens kö måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/app/queue
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | (valfritt) Användarens API-nyckel |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Nyckel | Värde |
|---|---|
| queue |
Innehåller en matris med aktuella köer för olika planer:
|
| plan |
Innehåller aktuell kö för aktuell plan (lägg till api_token för att begära registrerat/premiumplan):
|
Om du vill få information om demoseparationer måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/app/demo
| Fält | Typ | Beskrivning |
|---|---|---|
| start | Heltal | (valfritt) Startpunktsförskjutning, standardvärdet är 0 (dvs. starta från senaste) |
| limit | Heltal | (valfritt) Maximalt antal returnerade resultat, standardvärdet är 10, maxvärdet är 20. |
| algorithm_id | Heltal | Valfritt separationstyp-ID. Använd detta för att returnera demoseparationer som skapats av endast en algoritm. Värden matchar render_id från GET SEPARATION TYPES-slutpunkten. |
| options[FIELD] | Sträng / Heltal | Valfritt filter för algoritmalternativvärden. Ersätt FIELD med en ytterligare fältnyckel från algorithm_fields -> name i GET SEPARATION TYPES-svaret och skicka sedan en av fältets options-nycklar som värde. Exempel: options[vocals]=1 |
| additional_options | Sträng | Valfri råvara innehåller filter mot lagrade jobbalternativsdata. Föredra options[FIELD] för nya integrationer eftersom det är explicit och enklare att skapa. |
curl --location --request GET 'https://mvsep.com/api/app/demo?start=0&limit=2'
curl --location --request GET 'https://mvsep.com/api/app/demo?algorithm_id=20&options[vocals]=1&start=0&limit=10'
För att bygga alternativfilter, anropa först https://mvsep.com/api/app/algorithms och inspektera varje algoritms algorithm_fields-lista. Använd fältet name inuti options[FIELD] och använd en av JSON-alternativnycklarna som värde.
Returnerar data som en matris:
| Nyckel | Värde |
|---|---|
| hash | Separations-Hash |
| date | Datum för separationen |
| input_audio | URL för indataljud |
| size | Storlek på inmatat ljud |
| algorithm | Innehåller grundläggande information om använd separationstyp (se fliken HÄMTA SEPARATIONSTYPER för information om returnerade parametrar) |
Om du vill autentisera användaren och hämta användarens API-nyckel måste du göra ett POST-anrop till följande URL:
https://mvsep.com/api/app/login
| Fält | Typ | Beskrivning |
|---|---|---|
| Sträng | Användarens e-postadress | |
| password | Sträng | Användarens lösenord |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Användarens e-postadress>"' --form 'password="<Användarens lösenord>"'
| Nyckel | Värde |
|---|---|
| success |
|
| data | Innehåller information om när autentiseringsuppgifterna är giltiga |
| data -> name | Användarens namn |
| data -> email | Användarens e-postadress |
| data -> api_token | Användarens API-nyckel. Se till att förvara den i säker lagring och använd för efterföljande åtgärder. |
| data -> premium_minutes | Krediter som är kvar för användaren |
| data -> premium_enabled |
Om användaren har tillåtit att krediter spenderas.
|
| data -> long_filenames_enabled |
Om användaren vill ha extra information i filnamn:
|
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Felaktiga autentiseringsuppgifter har angetts |
Om du vill registrera användaren på MVSEP-webbplatsen måste du göra ett POST-anrop till följande URL:
https://mvsep.com/api/app/register
| Fält | Typ | Beskrivning |
|---|---|---|
| name | Sträng | Användarens namn |
| Sträng | Användarens e-postadress | |
| password | Sträng | Användarens lösenord |
| password_confirmation | Sträng | Upprepa användarens lösenord |
curl --location --request GET 'https://mvsep.com/api/app/register' --form 'name="user"'
--form 'email="asdf@example.com"'
--form 'password="ASDFQWEr123"'
--form 'password_confirmation="ASDFQWEr123"'
| Nyckel | Värde |
|---|---|
| success |
|
| message | Inträffar när formuläret är giltigt |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Formuläret är ogiltigt |
För att få användarinformation måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/app/user
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Din API-token>'
| Nyckel | Värde |
|---|---|
| success |
|
| data | Innehåller information om när autentiseringsuppgifterna är giltiga |
| data -> name | Användarens namn |
| data -> email | Användarens e-postadress |
| data -> api_token | Användarens API-nyckel. Se till att förvara den i säker lagring och använd för efterföljande åtgärder. |
| data -> premium_minutes | Krediter som är kvar för användaren |
| data -> premium_enabled |
Om användaren har tillåtit att krediter spenderas.
|
| data -> long_filenames_enabled |
Om användaren vill ha extra information i filnamn:
|
| data -> current_queue | Visar pågående separationer för användaren |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Ogiltig API-nyckel |
För att få grundläggande informationssepareringshistorik för användaren måste du ringa ett GET-anrop till följande webbadress:
https://mvsep.com/api/app/separation_history
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
| start | Heltal | (valfritt) Startpunktsförskjutning, standardvärdet är 0 (dvs. starta från senaste) |
| limit | Heltal | (valfritt) Maximalt antal returnerade resultat, standardvärdet är 10, maxvärdet är 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Din API-token>&start=1&limit=2'
| Nyckel | Värde |
|---|---|
| success |
|
| data | Innehåller grundläggande informationsuppsättning om tidigare separationer |
| data -> hash | Separations-Hash |
| data -> job_exists | Innehåller grundläggande informationsuppsättning om tidigare separationer |
| data -> credits | Hur många poäng som användes för jobbet, noll om separation inte finns |
| data -> time_left | Ungefärlig tid kvar tills jobbet tas bort |
| data -> algorithm | Innehåller grundläggande information om använd separationstyp (se fliken HÄMTA SEPARATIONSTYPER för information om returnerade parametrar) |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Ogiltig API-nyckel |
För att aktivera premiumanvändning för användaren måste du ringa ett POST-anrop till följande url:
https://mvsep.com/api/app/enable_premium
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Din API-token>"'
| Nyckel | Värde |
|---|---|
| success |
|
| message | Informerar om operationens status |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Ogiltig API-nyckel |
För att inaktivera premiumanvändning för användaren måste du ringa ett POST-anrop till följande webbadress:
https://mvsep.com/api/app/disable_premium
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Din API-token>"'
| Nyckel | Värde |
|---|---|
| success |
|
| message | Informerar om operationens status |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Ogiltig API-nyckel |
Om du vill aktivera långa filnamn för användaren måste du göra ett POST-anrop till följande URL:
https://mvsep.com/api/app/enable_long_filenames
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Din API-token>"'
| Nyckel | Värde |
|---|---|
| success |
|
| message | Informerar om operationens status |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Ogiltig API-nyckel |
Om du vill inaktivera långa filnamn för användaren måste du göra ett POST-anrop till följande URL:
https://mvsep.com/api/app/disable_long_filenames
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Din API-token>"'
| Nyckel | Värde |
|---|---|
| success |
|
| message | Informerar om operationens status |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Ogiltig API-nyckel |
För att få information om Quality Checker-köposter måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/quality_checker/queue
| Fält | Typ | Beskrivning |
|---|---|---|
| start | Heltal | (valfritt) Startpunktsförskjutning, standardvärdet är 0 (dvs. starta från senaste) |
| limit | Heltal | (valfritt) Maximalt antal returnerade resultat, standardvärdet är 10, maxvärdet är 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Returnerar data som en matris:
| Nyckel | Värde |
|---|---|
| id | Identifikationsnummer för posten |
| dataset_type | Datasettyp som valts när posten/topplistan lades till
|
| date | Skapat datum för inlägget |
| algo_name | Namn på den använda separationstypen/algoritmen |
| main_text | Beskrivning av använd separationstyp/algoritm |
| proc | Bearbetningsstatus
|
| proc_remote_date | Tidsstämpel för bearbetningsdatum |
| msg | Returnerar "OK" om det lyckas, annars visas ett felmeddelande |
| metrics | Information om inmatningsstatistik |
| sdr_* (wildcard) | SDR för motsvarande stammar |
| dataset_name | Namn på datasetet |
För att få information om Quality Checker-topplistor måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/quality_checker/leaderboard
| Fält | Typ | Beskrivning |
|---|---|---|
| dataset_type | Sträng | Datasettyp, standardvärdet är 0 om inget anges.
|
| start | Heltal | (valfritt) Startpunktsförskjutning, standardvärdet är 0 (dvs. starta från senaste) |
| limit | Heltal | (valfritt) Maximalt antal returnerade resultat, standardvärdet är 10, maxvärdet är 20. |
| algo_name_filter | Sträng | Filtrerar separationstyp/algoritmnamn efter given text |
| sort | Sträng | Sortera efter given SDR för stammen. Du kan få en lista över sorterbara värden för given datasettyp från sortables-tangenten som svar. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Nyckel | Värde |
|---|---|
| data | Innehåller en matris med poster i kvalitetskontrollen. Se avsnittet HÄMTA KÖ-svar från kvalitetskontrollen för mer information. |
| dataset_type | Använd datasettypnyckel |
| sortables | Nycklar som kan användas för att sortera använd datasettyp efter given stam i sekventiell ordning. |
| sort | Använde sorteringsnyckeln från sortable. |
För att skapa en kvalitetskontrollpost måste du göra ett POST-anrop till följande URL:
https://mvsep.com/api/quality_checker/add
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | (obligatoriskt) Din API-nyckel |
| zipfile | Binär | (obligatoriskt) Zip-fil som ska bearbetas |
| algo_name | Sträng | (obligatoriskt) Algoritmens namn |
| main_text | Sträng | (obligatoriskt) Beskrivning av algoritmen |
| dataset_type | Sträng | Datauppsättningstyp. Standardinställningen är 0
0 - Synth1 - Multi2 - Piano3 - Lead/Back Vocals4 - Guitar5 - Medley Vox6 - Strings7 - Wind8 - DNR v3 Test9 - Super Resolution Checker for Music10 - Drums Separation (5 stems)11 - Male/Female vocals separation12 - Phantom Center |
| password | Sträng | (obligatoriskt) Lösenord för att radera algoritm |
| ensemble | Heltal | 0 - algoritmen är inte ensemble. 1 - algoritmen är ensemble. |
curl --location 'https://mvsep.com/api/quality_checker/add' --form 'zipfile=@"/path/to/zipfile"' --form 'algo_name="Test Algorithm Name"' --form 'main_text="Test Algorithm Description"' --form 'dataset_type="2"' --form 'ensemble="1"' --form 'password="test"'
| Nyckel | Värde |
|---|---|
| success |
|
| data | Innehåller information om inträde |
| data -> id | ID för posten |
| data -> link | Länk till inlägge |
MVSEP API använder följande felkoder:
| Felkod | Betydelse |
|---|---|
| 400 | Formuläret är ogiltigt |
| 401 |
Okänd eller ogiltig api_token. Detta fel uppstår om du använder en okänd API-nyckel
|
För att få information om Quality Checker-köpost efter id måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/quality_checker/entry
| Fält | Typ | Beskrivning |
|---|---|---|
| id | Heltal | (obligatoriskt) ID för posten |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
För att ta bort en post i Quality Checker-kön med ID och lösenord måste du göra ett GET-anrop till följande URL:
https://mvsep.com/api/quality_checker/delete
| Fält | Typ | Beskrivning |
|---|---|---|
| id | Heltal | (obligatoriskt) ID för posten |
| password | Sträng | (obligatoriskt) Använde lösenordet för posten |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Nyckel | Värde |
|---|---|
| success |
|
| data->message | Visar om posten har raderats |
turbo@mvsep.com