turbo@mvsep.com
Informații despre site
Întrebări Frecvente
Instrument de Verificare a Calității
Algoritmi
Documentație API completă
API-ul MVSEP oferă acces programatic pentru a crea o separare, a returna rezultatele, a obține informații despre site și a controla capacitățile utilizatorului.
Pentru a folosi acest API, ai nevoie de o cheie API. Nu sunteți conectat, vă rugăm să vă conectați pentru a obține tokenul API.
Exemple în Python: https://github.com/ZFTurbo/MVSep-API-Examples
Aplicația neoficială MacVSep pentru Mac OS: https://github.com/septcoco/macvsep
Webhook-urile pot fi configurate aici: Pagina Webhooks
Specificația OpenAPI: mvsep-openapi-spec.json
Rețineți că utilizatorii Premium pot solicita un număr nelimitat de sarcini simultane, în timp ce utilizatorii care nu sunt Premium pot solicita doar 1 sarcină simultană.
Pentru a crea o sarcină de separare, trebuie să faci un call POST către următorul URL:
https://mvsep.com/api/separation/create
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia ta API |
| audiofile | Binar | Fișier audio de procesat. Nu este necesar dacă este setat parametrul url sau dacă modelul nu utilizează intrarea de fișiere. Pentru modelele de potrivire, utilizați target_audiofile și reference_audiofile ca intrare în locul parametrului audiofile. |
| url | Șir | Link către fișierul audio. Nu este necesar dacă este setat parametrul audiofile. |
| remote_type | Șir | (opțional) Tipul de acces la fișierul audio. Valoarea implicită este direct. Nu este necesar dacă este setat parametrul audiofile. Tipurile acceptate sunt direct (Descărcare directă), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Număr întreg | (opțional) Tip separare, implicit 11 (Demucs3 Model B (vocals, drums, bass, other) |
| add_opt1 | Șir | (opțional) Tip separare primul câmp adițional |
| add_opt2 | Șir | (opțional) Tip separare câmp adițional secundar |
| add_opt3 | Șir | (opțional) Tip separare al treilea câmp suplimentar |
| output_format | Număr întreg | (opțional) format de ieșire, implicit 0 (mp3 (320kbps)) |
| is_demo | boolean | (opțional) varianta separată trebuie să fie postată pe pagina demo-urilor, implicit fals |
| Nume | Valoare | Câmpuri suplimentare |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Cheie: add_opt1 Nume: Output files Opțiuni:
Cheie: add_opt2 Nume: Model Type Opțiuni:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Cheie: add_opt1 Nume: Output files Opțiuni:
Cheie: add_opt2 Nume: Model Type Opțiuni:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Cheie: add_opt1 Nume: Output files Opțiuni:
Cheie: add_opt2 Nume: Model Type Opțiuni:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| BS Roformer (vocals, instrumental) | 40 | Cheie: add_opt1 Nume: Vocal model type Opțiuni:
|
| BS PolarFormer (vocals, instrumental) | 123 | Cheie: add_opt1 Nume: Overlap Opțiuni:
|
| MelBand Roformer (vocals, instrumental) | 48 | Cheie: add_opt1 Nume: Vocal model type Opțiuni:
|
| MDX23C (vocals, instrumental) | 25 | Cheie: add_opt1 Nume: Vocal model type Opțiuni:
|
| SCNet (vocals, instrumental) | 46 | Cheie: add_opt1 Nume: Vocal model type Opțiuni:
|
| MDX B (vocals, instrumental) | 23 | Cheie: add_opt1 Nume: Vocal model type Opțiuni:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Cheie: add_opt1 Nume: Model Type Opțiuni:
Cheie: add_opt2 Nume: Agressiveness Opțiuni:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Cheie: add_opt1 Nume: Karaoke model type Opțiuni:
Cheie: add_opt2 Nume: Extraction type Opțiuni:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Cheie: add_opt1 Nume: Karaoke model type Opțiuni:
|
| MVSep Crowd removal (crowd, other) | 34 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| Medley Vox (Multi-singer separation) | 53 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Cheie: add_opt1 Nume: Model Type Opțiuni:
|
| MVSep Male/Female separation | 57 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Choir (choir, other) | 112 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Drums (drums, other) | 44 | Cheie: add_opt1 Nume: Drums model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
Cheie: add_opt3 Nume: Output files Opțiuni:
|
| MVSep Bass (bass, other) | 41 | Cheie: add_opt1 Nume: Bass model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
Cheie: add_opt3 Nume: Output files Opțiuni:
|
| MVSep Synth (synth, other) | 88 | Cheie: add_opt1 Nume: How to extract Opțiuni:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Cheie: add_opt1 Nume: Model Type Opțiuni:
Cheie: add_opt2 Nume: Preprocess Opțiuni:
|
| MVSep Piano (piano, other) | 29 | Cheie: add_opt1 Nume: Piano model type Opțiuni:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Cheie: add_opt1 Nume: Organ model type Opțiuni:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Cheie: add_opt1 Nume: Guitar model type Opțiuni:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| 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 | Cheie: add_opt1 Nume: String model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Cello (cello, other) | 70 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Double Bass (double-bass, other) | 73 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Wind (wind, other) | 54 | Cheie: add_opt1 Nume: Wind model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
Cheie: add_opt3 Nume: Output files Opțiuni:
|
| MVSep Brass (brass, other) | 107 | Cheie: add_opt1 Nume: How to extract Opțiuni:
|
| MVSep Woodwind (woodwind, other) | 108 | Cheie: add_opt1 Nume: How to extract Opțiuni:
|
| MVSep Saxophone (saxophone, other) | 61 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| MVSep Flute (flute, other) | 67 | Cheie: add_opt1 Nume: Flute model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Trumpet (trumpet, other) | 71 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Trombone (trombone, other) | 75 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Oboe (oboe, other) | 77 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Clarinet (clarinet, other) | 78 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep French Horn (french-horn, other) | 82 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Harmonica (harmonica, other) | 87 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| 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 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Celesta (celesta, other) | 110 | Cheie: add_opt2 Nume: How to extract Opțiuni:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Cheie: add_opt1 Nume: Model Type Opțiuni:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: How to extract Opțiuni:
Cheie: add_opt3 Nume: Output files Opțiuni:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: Cutoff (Hz) Opțiuni:
|
| Reverb Removal (noreverb) | 22 | Cheie: add_opt1 Nume: Model Type Opțiuni:
Cheie: add_opt2 Nume: Preprocess Opțiuni:
|
| DeNoise by aufr33 and gabox | 47 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| AudioSR (Super Resolution) | 59 | Cheie: add_opt1 Nume: Cutoff (Hz) Opțiuni:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Cheie: add_opt1 Nume: Text prompt Opțiuni: Cheie: add_opt2 Nume: Length (in seconds) Opțiuni:
|
| Whisper (extract text from audio) | 39 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: Transcription type Opțiuni:
|
| Parakeet (extract text from audio) | 64 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: Version Opțiuni:
|
| VibeVoice (Voice Cloning) | 103 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: Text prompt Opțiuni: Cheie: add_opt3 Nume: Extract vocals first Opțiuni:
|
| VibeVoice (TTS) | 104 | Cheie: add_opt1 Nume: Model type Opțiuni:
Cheie: add_opt2 Nume: Text prompt Opțiuni: |
| Qwen3-TTS (Custom Voice) | 118 | Cheie: add_opt1 Nume: Text prompt Opțiuni: Cheie: add_opt2 Nume: Speaker Opțiuni:
Cheie: add_opt3 Nume: Language Opțiuni:
Cheie: add_opt4 Nume: Voice description Opțiuni: |
| Qwen3-TTS (Voice Design) | 119 | Cheie: add_opt1 Nume: Text prompt Opțiuni: Cheie: add_opt2 Nume: Voice description Opțiuni: Cheie: add_opt3 Nume: Language Opțiuni:
|
| Qwen3-TTS (Voice Cloning) | 120 | Cheie: add_opt1 Nume: Text prompt Opțiuni: Cheie: add_opt2 Nume: Reference text in audio (optional) Opțiuni: Cheie: add_opt3 Nume: Language Opțiuni:
Cheie: add_opt4 Nume: Extract vocals first Opțiuni:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | Cheie: add_opt1 Nume: Text prompt Opțiuni: Cheie: add_opt2 Nume: Speaker Opțiuni:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Cheie: add_opt1 Nume: Model Type Opțiuni:
|
| Aspiration (by Sucial) | 50 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| Phantom Centre extraction | 55 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Cheie: add_opt1 Nume: How to use Opțiuni:
|
| Transkun (piano -> midi) | 113 | Cheie: add_opt1 Nume: How to extract Opțiuni:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Cheie: add_opt1 Nume: Lyrics Opțiuni: Cheie: add_opt10 Nume: Topic Opțiuni:
Cheie: add_opt2 Nume: Tags (optional) Opțiuni: Cheie: add_opt3 Nume: Genre Opțiuni:
Cheie: add_opt4 Nume: Timbre Opțiuni:
Cheie: add_opt5 Nume: Gender Opțiuni:
Cheie: add_opt6 Nume: Mood Opțiuni:
Cheie: add_opt7 Nume: Instrument Opțiuni:
Cheie: add_opt8 Nume: Scene Opțiuni:
Cheie: add_opt9 Nume: Region Opțiuni:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Cheie: add_opt1 Nume: Vocal model type Opțiuni:
|
| Vit Large 23 (vocals, instrum) | 33 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| UVRv5 Demucs (vocals, music) | 17 | Cheie: add_opt1 Nume: Model Type Opțiuni:
|
| 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 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| UnMix | 3 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| Zero Shot (Query Based) (Low quality) | 14 | Cheie: add_opt1 Nume: Model Type Opțiuni:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Cheie: add_opt1 Nume: Model type Opțiuni:
|
| Nume | Valoare |
|---|---|
| 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="<Tokenul tău API>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Cheie | Valoare |
|---|---|
| success |
|
| data | Deține informații suplimentare în funcție de tasta success |
| data -> link | Afișează linkul către URL-ul "GET RESULT" al lucrării create (afișat numai atunci când success este true) |
| data -> hash | Afișează hash-ul lucrării create (afișat numai atunci când success este true) |
| data -> message | Afișează descrierea unei erori (afișată numai atunci când success este |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Anumiți parametri lipsesc sau nu sunt valabili. Această eroare apare atunci când nu treci toți parametrii obligatorii sau treci parametri nevalabili. |
| 401 |
api_token necunoscut sau nevalid. Această eroare apare dacă folosești o cheie API incorectă
|
Pentru a primi rezultatul separării, trebuie să faci un call POST către următorul URL:
https://mvsep.com/api/separation/get
| Câmp | Tip | Descriere |
|---|---|---|
| hash | Șir | Hash separare |
| mirror | Număr întreg | (opțional) Folosește o altă oglindă dacă este setată la 1, implicit la 0. Necesită api_token și 1 credit dacă este setat la 1. |
| api_token | Șir | cheie API (opțională) a utilizatorului. Obligatoriu dacă parametrul oglindă este setat la 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Cheie | Valoare |
|---|---|
| success |
|
| status |
|
| data | Conține informații suplimentare în funcție de tasta status |
| data -> queue_count | Afișează numărul de lucrări neprocesate în prioritatea utilizatorului (afișat numai atunci când status este |
| data -> current_order | Afișează ordinea lucrării utilizatorului (afișată numai atunci când status este |
| data -> message | Afișează descrierea stării (afișată pe toate stările, afișează motivul erorii în schimb atunci când status este |
| data -> algorithm | Afișează algoritmul utilizat la locul de muncă (afișat numai atunci când status este |
| data -> algorithm_description | Afișează detaliile algoritmului utilizat pe loc de muncă (afișat numai atunci când status este |
| data -> output_format | Afișează formatul de ieșire al lucrării (afișat numai atunci când status este |
| data -> tags | Afișează metaetichetele audio (afișate numai atunci când status este |
| data -> input_file | Afișează detaliile de descărcare audio de intrare (afișate numai atunci când status este |
| data -> files | Afișează detaliile de descărcare a sunetelor de ieșire (afișate numai atunci când status este |
| data -> date | Afișează data procesării lucrării (afișată numai atunci când status este |
| data -> finished_chunks | Afișează numărul de piese finalizate ale unei lucrări mari (afișat numai atunci când status este |
| data -> all_chunks | Afișează numărul tuturor părților unei lucrări mari (afișat numai atunci când status este |
Pentru a obține rezultatul unei sarcini executate la distanță, trebuie să efectuați o solicitare GET la următoarea adresă URL:
https://mvsep.com/api/separation/get-remote
| Câmp | Tip | Descriere |
|---|---|---|
| hash | Șir | Hash separare |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Cheie | Valoare |
|---|---|
| success |
|
| status |
|
| data | Conține informații suplimentare în funcție de tasta status |
| data -> queue_count | Afișează numărul de sarcini neprocesate din lista de priorități a utilizatorului (se afișează numai când starea este în așteptare). |
| data -> current_order | Afișează ordinea sarcinilor utilizatorului (se afișează numai când starea este în așteptare). |
| data -> message | Afișează descrierea stării (numai atunci când status are valoarea failed). |
| data -> link | Afișează linkul către adresa URL „GET RESULT” a sarcinii create (afișat numai când status este done). |
| data -> hash | Hash-ul separării (afișat doar când status este done). |
Pentru a anula separarea și a rambursa creditele utilizate (dacă separarea nu a fost încă procesată), trebuie să efectuați o solicitare POST la următoarea adresă URL:
https://mvsep.com/api/separation/cancel
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
| hash | Șir | Hash separare |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Tokenul tău API>"' --form 'hash="<hash>"'
| Cheie | Valoare |
|---|---|
| success |
|
Pentru a obține date detaliate despre tipurile de separare, trebuie să efectuați un apel GET la următoarea adresă URL:
https://mvsep.com/api/app/algorithms
| Câmp | Tip | Descriere |
|---|---|---|
| scopes | Șir | Dacă să includem modele care utilizează diferite tipuri de date de intrare.
single_upload. Pentru a obține toate modelele, setați scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Returnează datele ca matrice:
| Cheie | Valoare |
|---|---|
| render_id | Valoarea tipului de separare (ID) |
| name | Numele tipului de separare |
| algorithm_group_id | Grupul în care aparține tipul de separare: |
| algorithm_group | Conține informații despre grupul de algoritmi din care face parte algoritmul respectiv. |
| algorithm_group -> name | Numele grupului de algoritmi. |
| audio_widget |
Tipul de widget audio care va fi utilizat pentru algoritm. Acesta poate fi folosit pentru a stabili modul în care va fi afișat playerul audio al algoritmului în interfața utilizatorului. Valorile posibile sunt:
|
| orientation |
Pentru cine se destinează acest tip de separare:
|
| order_id | Ordinea tipului de separare |
| price_coefficient |
Folosit pentru a calcula câte credite ia munca de la utilizatorul premium. Folosește această formulă : floor(<durata fișierului audio în secunde> * price_coefficient / 60)?:1
|
| usage | Afișează numărul de utilizări lunare pentru tipul de separare |
| rating | Afișează statistica lunară a utilizării tipului de separare sub formă de matrice:
|
| algorithm_fields | Conține informații despre câmpurile suplimentare de tip separare |
| algorithm_fields -> name |
Arată ce câmp suplimentar de tip separare:
|
| algorithm_fields -> text | Numele afișat al câmpului suplimentar al tipului de separare. |
| algorithm_fields -> options | JSON Lanțuri cheie-valoare codificate de câmp suplimentar |
| algorithm_fields -> default_key | Valoarea implicită a câmpului suplimentar. Una dintre cheile <code>algorithm_fields -> options</code> |
| algorithm_descriptions | Conține informații despre descrierile tipului de separare |
| algorithm_descriptions -> short_description | Descriere mică a tipului de separare care nu utilizează HTML. |
| algorithm_descriptions -> long_description | Descriere detaliată a tipului de separare care utilizează HTML. |
| algorithm_descriptions -> lang | Codul de limbă specificat al descrierii. |
Pentru a obține informații despre cele mai recente știri despre MVSEP, trebuie să efectuați un apel GET la următoarea adresă URL:
https://mvsep.com/api/app/news
| Câmp | Tip | Descriere |
|---|---|---|
| lang | Șir | (opțional) cod de limbă din 2 litere (en, ru) |
| start | Număr întreg | (opțional) Decalaj punct de plecare, implicit la 0 (adică începe de la cel mai recent) |
| limit | Număr întreg | (opțional) Numărul maxim de rezultate returnate, implicit la 10, maximul este 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Returnează datele ca matrice:
| Cheie | Valoare |
|---|---|
| title | Titlul știrii |
| lang | Titlul știrii |
| text | Descrierea completă a știrilor |
| created_at | Data știrii |
Pentru a obține informații despre coada site-ului, trebuie să efectuați o solicitare GET la următoarea adresă URL:
https://mvsep.com/api/app/queue
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | (opțional) Cheia API a utilizatorului |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Cheie | Valoare |
|---|---|
| queue |
Conține o listă cu cozile actuale pentru diferite planuri:
|
| plan |
Conține coada curentă pentru planul actual (adăugați api_token la cerere pentru planul înregistrat/premium):
|
Pentru a obține informații despre separările demonstrative, trebuie să efectuați un apel GET la următoarea adresă URL:
https://mvsep.com/api/app/demo
| Câmp | Tip | Descriere |
|---|---|---|
| start | Număr întreg | (opțional) Decalaj punct de plecare, implicit la 0 (adică începe de la cel mai recent) |
| limit | Număr întreg | (opțional) Numărul maxim de rezultate returnate, implicit la 10, maximul este 20. |
| algorithm_id | Număr întreg | ID opțional al tipului de separare. Utilizați această opțiune pentru a afișa doar separările demo create de un singur algoritm. Valorile corespund cu render_id din punctul de interfață GET SEPARATION TYPES. |
| options[FIELD] | Șir / Număr întreg | Filtru opțional pentru valorile opțiunilor algoritmului. Înlocuiți FIELD cu o cheie de câmp suplimentară din algorithm_fields -> name din răspunsul GET SEPARATION TYPES, apoi transmiteți una dintre cheile options ale acelui câmp ca valoare. Exemplu: options[vocals]=1. |
| additional_options | Șir | Opțiunea „raw” include un filtru pentru datele de opțiuni ale sarcinilor stocate. Pentru integrările noi, se recomandă utilizarea formatului options[FIELD], deoarece este mai explicit și mai ușor de configurat. |
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'
Pentru a crea filtre de opțiuni, apelați mai întâi https://mvsep.com/api/app/algorithms și verificați lista algorithm_fields a fiecărui algoritm. Folosiți câmpul name în cadrul options[FIELD] și utilizați una dintre cheile de opțiuni JSON ca valoare.
Returnează datele ca matrice:
| Cheie | Valoare |
|---|---|
| hash | Hash separare |
| date | Data separării |
| input_audio | URL audio de intrare |
| size | Dimensiunea audio de intrare |
| algorithm | Conține informații de bază despre tipul de separare utilizat (consultați fila GET SEPARATION TYPES pentru informații despre parametrii returnați) |
Pentru a autentifica utilizatorul și a obține cheia API a utilizatorului, trebuie să efectuați un apel POST la următoarea adresă URL:
https://mvsep.com/api/app/login
| Câmp | Tip | Descriere |
|---|---|---|
| Șir | E-mailul utilizatorului | |
| password | Șir | Parola utilizatorului |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<E-mailul utilizatorului>"' --form 'password="<Parola utilizatorului>"'
| Cheie | Valoare |
|---|---|
| success |
|
| data | Conține informații când acreditările sunt valide |
| data -> name | Numele utilizatorului |
| data -> email | E-mailul utilizatorului |
| data -> api_token | Cheia API a utilizatorului. Asigurați-vă că îl depozitați într-un depozit securizat și utilizați-l pentru operațiuni ulterioare. |
| data -> premium_minutes | Credite rămase pentru utilizator |
| data -> premium_enabled |
Dacă utilizatorul a permis cheltuirea creditelor.
|
| data -> long_filenames_enabled |
Dacă utilizatorul dorește informații suplimentare în numele fișierelor:
|
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Acreditări incorecte specificate |
Pentru a înregistra utilizatorul pe site-ul MVSEP, trebuie să efectuați un apel POST la următoarea adresă URL:
https://mvsep.com/api/app/register
| Câmp | Tip | Descriere |
|---|---|---|
| name | Șir | Numele utilizatorului |
| Șir | E-mailul utilizatorului | |
| password | Șir | Parola utilizatorului |
| password_confirmation | Șir | Repetați parola utilizatorului |
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"'
| Cheie | Valoare |
|---|---|
| success |
|
| message | Apare atunci când formularul este valid |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Formularul nu este valid |
Pentru a obține informații despre utilizator, trebuie să efectuați un apel GET la următoarea adresă URL:
https://mvsep.com/api/app/user
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Tokenul tău API>'
| Cheie | Valoare |
|---|---|
| success |
|
| data | Conține informații când acreditările sunt valide |
| data -> name | Numele utilizatorului |
| data -> email | E-mailul utilizatorului |
| data -> api_token | Cheia API a utilizatorului. Asigurați-vă că îl depozitați într-un depozit securizat și utilizați-l pentru operațiuni ulterioare. |
| data -> premium_minutes | Credite rămase pentru utilizator |
| data -> premium_enabled |
Dacă utilizatorul a permis cheltuirea creditelor.
|
| data -> long_filenames_enabled |
Dacă utilizatorul dorește informații suplimentare în numele fișierelor:
|
| data -> current_queue | Afișează separările în curs de desfășurare pentru utilizator |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Cheie API nevalidă |
Pentru a obține istoricul de separare a informațiilor de bază ale utilizatorului, trebuie să efectuați un apel GET la următoarea adresă URL:
https://mvsep.com/api/app/separation_history
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
| start | Număr întreg | (opțional) Decalaj punct de plecare, implicit la 0 (adică începe de la cel mai recent) |
| limit | Număr întreg | (opțional) Numărul maxim de rezultate returnate, implicit la 10, maximul este 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Tokenul tău API>&start=1&limit=2'
| Cheie | Valoare |
|---|---|
| success |
|
| data | Conține informații de bază despre separările anterioare |
| data -> hash | Hash separare |
| data -> job_exists | Conține informații de bază despre separările anterioare |
| data -> credits | Câte credite au fost folosite pentru lucrare, nule dacă nu există separare |
| data -> time_left | Timp aproximativ rămas până la ștergerea lucrării |
| data -> algorithm | Conține informații de bază despre tipul de separare utilizat (consultați fila GET SEPARATION TYPES pentru informații despre parametrii returnați) |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Cheie API nevalidă |
Pentru a activa utilizarea premium pentru utilizator, trebuie să efectuați un apel POST la următoarea adresă URL:
https://mvsep.com/api/app/enable_premium
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Tokenul tău API>"'
| Cheie | Valoare |
|---|---|
| success |
|
| message | Informează despre stadiul operațiunii |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Cheie API nevalidă |
Pentru a dezactiva utilizarea premium pentru utilizator, trebuie să efectuați un apel POST la următoarea adresă URL:
https://mvsep.com/api/app/disable_premium
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Tokenul tău API>"'
| Cheie | Valoare |
|---|---|
| success |
|
| message | Informează despre stadiul operațiunii |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Cheie API nevalidă |
Pentru a activa numele de fișiere lungi pentru utilizator, trebuie să efectuați un apel POST la următoarea adresă URL:
https://mvsep.com/api/app/enable_long_filenames
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Tokenul tău API>"'
| Cheie | Valoare |
|---|---|
| success |
|
| message | Informează despre stadiul operațiunii |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Cheie API nevalidă |
Pentru a dezactiva numele de fișiere lungi pentru utilizator, trebuie să efectuați un apel POST la următoarea adresă URL:
https://mvsep.com/api/app/disable_long_filenames
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | Cheia API a utilizatorului |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Tokenul tău API>"'
| Cheie | Valoare |
|---|---|
| success |
|
| message | Informează despre stadiul operațiunii |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Cheie API nevalidă |
Pentru a obține informații despre înregistrările din coada Quality Checker, trebuie să efectuați o solicitare GET la următoarea adresă URL:
https://mvsep.com/api/quality_checker/queue
| Câmp | Tip | Descriere |
|---|---|---|
| start | Număr întreg | (opțional) Decalaj punct de plecare, implicit la 0 (adică începe de la cel mai recent) |
| limit | Număr întreg | (opțional) Numărul maxim de rezultate returnate, implicit la 10, maximul este 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Returnează datele ca matrice:
| Cheie | Valoare |
|---|---|
| id | Numărul de identificare al înregistrării |
| dataset_type | Tipul setului de date selectat la adăugarea înregistrării / tipul clasamentului
|
| date | Data creării înregistrării |
| algo_name | Denumirea tipului/algoritmului de separare utilizat |
| main_text | Descrierea tipului/algoritmului de separare utilizat |
| proc | Stadiul prelucrării
|
| proc_remote_date | Data și ora procesării |
| msg | Returnează „OK” dacă operațiunea se desfășoară cu succes; în caz contrar, afișează un mesaj de eroare |
| metrics | Informații despre indicatorii de acces |
| sdr_* (wildcard) | SDR-ul tulpinilor corespunzătoare |
| dataset_name | Numele setului de date |
Pentru a obține informații despre clasamentele Quality Checker, trebuie să efectuați o solicitare GET la următoarea adresă URL:
https://mvsep.com/api/quality_checker/leaderboard
| Câmp | Tip | Descriere |
|---|---|---|
| dataset_type | Șir | Tipul setului de date; dacă nu este specificat, valoarea implicită este 0.
|
| start | Număr întreg | (opțional) Decalaj punct de plecare, implicit la 0 (adică începe de la cel mai recent) |
| limit | Număr întreg | (opțional) Numărul maxim de rezultate returnate, implicit la 10, maximul este 20. |
| algo_name_filter | Șir | Filtrează denumirile tipurilor/algoritmilor de separare în funcție de textul introdus |
| sort | Șir | Sortează în funcție de valoarea SDR a trunchiului. Poți obține lista valorilor care pot fi sortate pentru un anumit tip de set de date din cheia sortables din răspuns. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Cheie | Valoare |
|---|---|
| data | Conține o serie de intrări din Quality Checker. Pentru mai multe informații, consultați secțiunea „Răspunsul la comanda GET QUEUE din Quality Checker”. |
| dataset_type | Cheie pentru tipul setului de date utilizat |
| sortables | Chei care pot fi utilizate pentru a sorta tipurile de seturi de date utilizate în ordine secvențială, pe baza unei rădăcini date. |
| sort | Cheie de sortare utilizată din sortable. |
Pentru a crea o înregistrare în Quality Checker, trebuie să efectuați o solicitare POST la următoarea adresă URL:
https://mvsep.com/api/quality_checker/add
| Câmp | Tip | Descriere |
|---|---|---|
| api_token | Șir | (obligatoriu) Cheia ta API |
| zipfile | Binar | (obligatoriu) Fișier ZIP de procesat |
| algo_name | Șir | (obligatoriu) Numele algoritmului |
| main_text | Șir | (obligatoriu) Descrierea algoritmului |
| dataset_type | Șir | Tipul setului de date. Valoarea implicită este 0.
|
| password | Șir | (obligatoriu) Algoritm de ștergere a parolei |
| ensemble | Număr întreg | 0 - algoritmul nu este un ansamblu. 1 - algoritmul este un ansamblu. |
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"'
| Cheie | Valoare |
|---|---|
| success |
|
| data | Conține informații despre înregistrare |
| data -> id | ID-ul înregistrării |
| data -> link | Link către articol |
API-ul MVSEP folosește următoarele coduri de eroare:
| Cod de Eroare | Înseamnă |
|---|---|
| 400 | Formularul nu este valid |
| 401 |
api_token necunoscut sau nevalid. Această eroare apare dacă folosești o cheie API incorectă
|
Pentru a obține informații despre o înregistrare din coada Quality Checker pe baza ID-ului, trebuie să efectuați o solicitare GET la următoarea adresă URL:
https://mvsep.com/api/quality_checker/entry
| Câmp | Tip | Descriere |
|---|---|---|
| id | Număr întreg | (obligatoriu) ID-ul înregistrării |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Pentru a șterge o intrare din coada Quality Checker pe baza ID-ului și a parolei, trebuie să efectuați o solicitare GET la următoarea adresă URL:
https://mvsep.com/api/quality_checker/delete
| Câmp | Tip | Descriere |
|---|---|---|
| id | Număr întreg | (obligatoriu) ID-ul înregistrării |
| password | Șir | (obligatoriu) Parola utilizată pentru acces |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Cheie | Valoare |
|---|---|
| success |
|
| data->message | Indică dacă înregistrarea a fost ștersă |
turbo@mvsep.com
Întrebări Frecvente
Instrument de Verificare a Calității
Algoritmi
Documentație API completă