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.
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 driver regionala API-ändpunkter. Alla regioner delar på en och samma kontodatabas, vilket innebär att samma konto, API-nyckel och jobb-hashvärden fungerar överallt:
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://hk.mvsep.com/apiFörfrågningar till https://mvsep.com/api geostyras till den region som ligger närmast den som skickar förfrågan. För API-integrationer rekommenderar vi att man uttryckligen anropar en regional slutpunkt – det gör att hela jobbets livscykel hålls på en enda värd, oavsett varifrån dina förfrågningar kommer.
Varje separering bearbetas och lagras i den region där den skapades, och de nedladdnings-URL:er som returneras i svaren pekar alltid på den regionens värd. För bästa prestanda bör du välja den slutpunkt som ligger närmast dina servrar och använda samma värd under hela jobbets livscykel – skapande, statusavfrågningar och filnedladdningar.
Du kan kontrollera statusen för vilket jobb som helst från vilken region som helst (databasen är gemensam), men själva utdatafilerna levereras alltid av den region som äger jobbet.
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)) |
| preset_id | Heltal | (valfritt) Använd en av dina sparade förinställningar på filen istället för en enskild algoritm. Ange antingen sep_type eller preset_id — en förinställning definierar sina egna algoritmer, alternativ och utdataformat, så sep_type, fälten add_opt och output_format ignoreras alla tillsammans med den. Svaret returnerar en hash som du avfrågar precis som en separation; resultatet innehåller en post per utgångsnod i förinställningen. Se förinställningstabellen nedan för dina id:n. |
| 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:
Nyckel: add_opt3 Namn: Set of stems 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:
|
Förinställningarna är privata för det konto som skapade dem, så den här tabellen visar dina förinställningar samt de utvalda. Skapa och redigera dem i förinställningsredigeraren.
Du har inga förinställningar ännu. Logga in och skapa en i förinställningsredigeraren, så kommer dess ID att visas här.
| 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
Samma slutpunkt returnerar förinställda körningar: avfråga den hash du fick tillbaka från preset_id på exakt samma sätt som du skulle göra vid en separation. Höljet är identiskt — status går från waiting och processing till done — och data.type är preset_run. Varje post i data.files är en utgångsnod i förinställningen, namngiven efter sin etikett snarare än efter en stam. En körning är endast synlig för det konto som skapade den.
| 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 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 |
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 |
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 hämta kreditköpen för detta konto, med de senaste först, gör ett GET-anrop till följande URL:
https://mvsep.com/api/purchases
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
| limit | Heltal | (valfritt) Antal köp som ska returneras, 1–100. Standardvärdet är 20. |
| offset | Heltal | (valfritt) Antalet köp som ska hoppas över vid bläddring i historiken. Standardvärdet är 0. |
| status | Sträng | (valfritt) Visar endast köp i detta tillstånd, t.ex. lyckades. Utelämna det (eller ange all) för att få allt som webbplatsens egen historiksida visar, vilket inkluderar kassar som påbörjats men aldrig slutförts — dessa har statusen unpaid och ger inga krediter. |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<Din API-token>&status=succeeded&limit=20'
| Nyckel | Värde |
|---|---|
| purchases | En post per köp: payment_id, status, amount, credits beviljade, betalningsmetod (stripe, paddle, yookassa, google_play eller app_store) och datum. |
| total | Hur många köp stämmer överens totalt, om man bortser från gräns och förskjutning — använd detta för att bläddra. |
| credits | Kontots aktuella kreditsaldo. |
MVSEP skickar ett e-postmeddelande när ditt kreditsaldo sjunker till en tröskel som du själv väljer, så att en pågående integration inte avbryts oväntat. GET returnerar den aktuella inställningen; POST ändrar den. Varningen skickas en gång och upprepas inte förrän saldot åter stiger över tröskeln.
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| Fält | Typ | Beskrivning |
|---|---|---|
| api_token | Sträng | Användarens API-nyckel |
| credit_threshold | Heltal | (Endast POST, obligatoriskt) Skicka en avisering när saldot är lika med eller lägre än detta antal krediter. 0 inaktiverar aviseringen. Om tröskelvärdet ändras återaktiveras en avisering som redan har skickats. |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<Din API-token>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<Din API-token>' --form 'credit_threshold=100'
| Nyckel | Värde |
|---|---|
| credit_threshold | Den tröskel som för närvarande gäller, uttryckt i krediter. |
| enabled | <code>true</code> när ett tröskelvärde över noll har angetts, annars <code>false</code>. |
| credits | Kontots aktuella kreditsaldo. |
| notified | <code>true</code> när varningen har skickats för den aktuella nedgången; avaktiveras automatiskt när saldot åter stiger över tröskelvärdet. |
| Den adress som varningen skickas till. |
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 |
Bibliotek, appar och integrationer som bygger på detta API. Om inget annat anges är detta projekt som drivs av användargemenskapen: de underhålls inte av MVSEP, och vi kan inte garantera deras kvalitet.
Den här distribueras på PyPI under namnet mvsep-cli och anger MVSEP som upphovsman, vilket kan få den att verka officiell. Den publiceras och underhålls av en tredje part, inte av MVSEP, och det källkodsarkiv som den länkar till finns inte. Den ber om din API-token, så läs igenom källkoden innan du klistrar in en token där.
mvsep-cli: pypi.org/project/mvsep-cli
turbo@mvsep.com