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.
MVSEP runs regional API endpoints. All regions share one account database, so the same account, API key and job hashes work everywhere:
https://de.mvsep.com/apihttps://hk.mvsep.com/apiRequests to https://mvsep.com/api are geo-steered to the region nearest to the caller. For API integrations we recommend calling a regional endpoint explicitly — it keeps the whole job lifecycle on one host regardless of where your requests originate from.
Every separation is processed and stored in the region where it was created, and the download URLs returned in responses always point to that region's host. For best performance, choose the endpoint closest to your servers and use the same host for the whole job lifecycle — create, status polling and file downloads.
You can query the status of any job from any region (the database is shared), but the output files themselves are always served by the region that owns the job.
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:
Nyckel: add_opt2 Namn: Overlap Alternativ:
|
| BS PolarFormer (vocals, instrumental) | 123 | Nyckel: add_opt1 Namn: Model type Alternativ:
Nyckel: add_opt2 Namn: Overlap Alternativ:
|
| MelBand Roformer (vocals, instrumental) | 48 | Nyckel: add_opt1 Namn: Vocal model type Alternativ:
Nyckel: add_opt2 Namn: Overlap 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:
Nyckel: add_opt2 Namn: Processing Mode 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 Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| 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 Pedal Steel Guitar | 124 | |
| 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 Whistle | 132 | |
| 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 Clap | 133 | |
| MVSep Cowbell | 128 | |
| 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 | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 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:
|
| Mega 53-stem Model | 126 | |
| 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 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Nyckel: add_opt1 Namn: How to extract Alternativ:
|
| 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 - Synthetic dataset1 - Multisong dataset4 - Guitar2 - Piano5 - Medley Vox6 - Strings7 - Wind8 - DNR v3 Test9 - Super Resolution Checker for Music3 - Lead/Back Vocals10 - Drums Separation (5 stems)11 - Male/Female vocals separation12 - Phantom Center13 - Synth Vocals 202614 - MUSDB18 (Test) |
| 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