Information om webbplatsen
Vanliga frågor
Kvalitetskontroll
Algoritmer
Fullständig API-dokumentation
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 detta 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 geostyrs: anropare i Europa dirigeras till de, anropare i Nordasien till hk och alla övriga till de2. För API-integrationer rekommenderar vi att man uttryckligen anropar en regional slutpunkt — det håller hela jobbets livscykel på en och samma värd, oavsett varifrån dina förfrågningar kommer.
Varje separation 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. Standardvärdet är direct. Krävs inte om parametern audiofile är angiven. Typer som stöds är direct (direktnedladdning), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Heltal | (valfritt) Separationstyp, standardvärdet är 20. Detta är ID:t för separationstypen, se avsnittet HÄMTA SEPARATIONSTYPER för mer information. Ignoreras när <code class="higlighted">preset_id</code> anges. |
| preset_id | Heltal | (valfritt) Kör en av dina sparade förinställningar på filen i stä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 pollar 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) Tredje ytterligare fältet för separationstyp |
| output_format | Heltal | (valfritt) utdataformat, standardvärdet är 0 (mp3 (320 kbps)) |
| is_demo | Boolean | (valfritt) om separationen ska publiceras på demosidan, standardvärdet är false |
| webhook_url | Sträng | (optional) A URL we will POST the finished result to, so you do not have to keep polling. The body is the same JSON as GET SEPARATION. This overrides the account-wide address set on the webhooks page, which is useful when several of your own users share one API token. Must be a publicly reachable http or https address. |
| 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 Clavinet | 135 | |
| MVSep Mellotron | 136 | |
| 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 | |
| Upmixing by Jazzpear | 137 | |
| 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å nyckeln success |
| data -> link | Visar länk till "GET RESULT"-URL:en för det skapade jobbet (visas endast när success är true) |
| data -> hash | Visar den skapade jobbhashen (visas endast när success är true) |
| data -> message | Visar beskrivningen av ett fel (visas endast när success ä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ällningskörningar: polla den hash du fick tillbaka från preset_id precis som du skulle göra med en separation. Svarsstrukturen är identisk — status går via 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 stem. En körning är endast synlig för det konto som skapade den.
| Fält | Typ | Beskrivning |
|---|---|---|
| hash | Sträng | Separationshash |
| mirror | Heltal | (valfritt) Använder en annan spegel om den sätts till 1, standardvärdet är 0. Kräver api_token och 1 kredit om den sätts 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å nyckeln status |
| data -> queue_count | Visar antalet obearbetade jobb i användarens prioritet (visas endast när status är waiting eller distributing) |
| data -> current_order | Visar ordningen på användarens jobb (visas endast när status är waiting eller distributing) |
| 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 detaljer om algoritmen som använts 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 done) |
| data -> finished_chunks | Visar antalet färdiga delar av ett stort jobb (visas endast när status är distributing) |
| data -> all_chunks | Visar det totala antalet delar i ett stort jobb (visas endast när status är distributing) |
Ta bort en av dina egna separationer – ett vanligt jobb eller en förinställd körning. Detta tar bort posten och dess utdatafiler. En separation som fortfarande bearbetas måste först avbrytas. Att ta bort den återbetalar inte krediter, eftersom arbetet redan har utförts.
POST https://mvsep.com/api/separation/delete
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ält | Typ | Beskrivning |
|---|---|---|
| hash | Sträng | Separationshash |
| api_token | Sträng | Användarens API-nyckel. Obligatoriskt. |
curl --location --request POST 'https://mvsep.com/api/separation/delete'
--form 'api_token="<Din API-token>"'
--form 'hash="20230327071601-0e3e5c6c85-13-dimensions.mp3"'
| Nyckel | Värde |
|---|---|
| success |
|
| data -> message | Visar en beskrivning av status (visas på alla statusar, visar felorsak istället när status är failed) |
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 | Separationshash |
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å nyckeln status |
| data -> queue_count | Visar antalet obearbetade jobb i användarens prioritet (visas endast när status är waiting). |
| data -> current_order | Visar ordningen på användarens jobb (visas endast när status är waiting). |
| data -> message | Visar statusbeskrivningen (endast när status är failed). |
| data -> link | Visar länk till "GET RESULT"-URL:en för det skapade jobbet (visas endast när status är done). |
| data -> hash | Hash för separationen (visas endast när status är done). |
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 | Separationshash |
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 typer 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 array:
| Nyckel | Värde |
|---|---|
| render_id | Värde för separationstyp (ID) |
| name | Namnet på separationstypen |
| algorithm_group_id | Gruppen som separationstypen tillhör: |
| algorithm_group | Innehåller information om den algoritmgrupp som algoritmen tillhör. |
| 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(<ljudfilens längd i sekunder> * price_coefficient / 60)?:1
|
| usage | Visar månatligt användningsantal för separationstypen |
| rating | Visar separationstypens månatliga betyg som en 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 ytterligare fältet. En av nycklarna i <code>algorithm_fields -> options</code> |
| 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 array:
| Nyckel | Värde |
|---|---|
| title | Titel på nyheten |
| lang | Titel på nyheten |
| text | Fullständig beskrivning av nyheten |
| created_at | Datum för nyheten |
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 array med aktuella köer för olika planer:
|
| plan |
Innehåller aktuell kö för din nuvarande plan (lägg till api_token i förfrågan för registrerad plan/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 nyckel för ytterligare fält från algorithm_fields -> name i svaret från GET SEPARATION TYPES och skicka sedan en av det fältets options-nycklar som värde. Exempel: options[vocals]=1. |
| additional_options | Sträng | Valfritt filter som söker råtext i lagrad jobbalternativsdata. Föredra options[FIELD] för nya integrationer eftersom det är tydligare och enklare att sätta ihop. |
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 array:
| Nyckel | Värde |
|---|---|
| hash | Separationshash |
| 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 hämta användarens grundläggande separationshistorik måste du göra ett GET-anrop till följande URL:
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 en array med grundläggande information om tidigare separationer |
| data -> hash | Separationshash |
| data -> job_exists | Innehåller en array med grundläggande information om tidigare separationer |
| data -> credits | Hur många krediter som användes för jobbet, null om separationen 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) Returnerar endast köp i detta tillstånd, t.ex. succeeded. Utelämna det (eller ange all) för att få allt som webbplatsens egen historiksida visar, vilket inkluderar kassagångar som påbörjats men aldrig slutförts — de har statusen unpaid och gav 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, beviljade credits, payment_method (stripe, paddle, yookassa, google_play eller app_store) och date. |
| total | Hur många köp som matchar totalt, oavsett limit och offset — använd det 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 göra 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 göra ett POST-anrop till följande URL:
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 array:
| Nyckel | Värde |
|---|---|
| id | Identifikationsnummer för posten |
| dataset_type | Datasettyp som valts när posten/topplistan lades till
|
| date | Datum då posten skapades |
| 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 postens mätvärden |
| sdr_* (wildcard) | SDR för motsvarande stems |
| 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 angiven SDR för en stem. Du kan hämta listan över sorterbara värden för en given datasettyp från nyckeln sortables i svaret. |
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 array med poster från kvalitetskontrollen. Se svaret för HÄMTA KÖ i avsnittet Kvalitetskontroll för mer information. |
| dataset_type | Datasettypnyckeln som användes |
| sortables | Nycklar som kan användas för att sortera den använda datasettypen efter en given stem i tur och ordning. |
| sort | Sorteringsnyckeln som användes, hämtad från sortables. |
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 | Datasettyp. Standardvärdet är 0.
|
| 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 posten |
| data -> id | ID för posten |
| data -> link | Länk till posten |
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) Lösenordet som användes 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-cliVanliga frågor
Kvalitetskontroll
Algoritmer
Fullständig API-dokumentation