turbo@mvsep.com
Az MVSEP API programozott hozzáférést biztosít az elválasztás létrehozásához, az eredmények visszaadásához, a webhely információinak lekéréséhez és a felhasználói képességek szabályozásához.
Az API használatához API-kulcsra van szüksége. Nincs bejelentkezve, kérjük, jelentkezzen be, hogy megkapja API-tokenjét.
Példák Pythonban: https://github.com/ZFTurbo/MVSep-API-Examples
Nem hivatalos MacVSep alkalmazás Mac OS-re: https://github.com/septcoco/macvsep
Webhookok itt állíthatók be: Webhookok oldal
OpenAPI specifikáció: mvsep-openapi-spec.json
Fontos megjegyezni, hogy a prémium felhasználók korlátlan számú egyidejű feladatot kérhetnek, míg a nem prémium felhasználók csak 1 egyidejű feladatot kérhetnek.
MVSEP runs regional API endpoints. All regions share one account database, so the same account, API key and job hashes work everywhere:
https://de.mvsep.com/apihttps://hk.mvsep.com/apiRequests to https://mvsep.com/api are geo-steered to the region nearest to the caller. For API integrations we recommend calling a regional endpoint explicitly — it keeps the whole job lifecycle on one host regardless of where your requests originate from.
Every separation is processed and stored in the region where it was created, and the download URLs returned in responses always point to that region's host. For best performance, choose the endpoint closest to your servers and use the same host for the whole job lifecycle — create, status polling and file downloads.
You can query the status of any job from any region (the database is shared), but the output files themselves are always served by the region that owns the job.
Az elválasztás létrehozásához POST-hívást kell indítania a következő URL-re:
https://mvsep.com/api/separation/create
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | Az Ön API-kulcsa |
| audiofile | Bináris | Feldolgozandó hangfájl. Nem szükséges, ha az url paraméter be van állítva, vagy a modell nem használ fájlbemenetet. Egyező modellek esetén a target_audiofile és a reference_audiofile paramétereket kell használni bemenetként az audiofile helyett. |
| url | Húr | Hivatkozás a hangfájlra. Nem szükséges, ha az audiofile paraméter be van állítva. |
| remote_type | Húr | (opcionális) A hangfájl távoli típusa. Alapértelmezés szerint direct. Nem szükséges, ha az audiofile paraméter be van állítva. A támogatott típusok: direct (közvetlen letöltés), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Egész szám | (opcionális) Elválasztási típus, alapértelmezés szerint 11 (Demucs3 Model B (ének, dob, basszusgitár, egyéb)) |
| add_opt1 | Húr | (nem kötelező) Elválasztás típusa az első további mező |
| add_opt2 | Húr | (nem kötelező) Elválasztás típusa második kiegészítő mező |
| add_opt3 | Húr | (választható) Elkülönítési típus harmadik kiegészítő mező |
| output_format | Egész szám | (opcionális) kimeneti formátum, alapértelmezés szerint 0 (mp3 (320 kbps)) |
| is_demo | Logikai | (opcionális), ha az elválasztást közzé kell tenni a bemutató oldalon, az alapértelmezett érték false |
| Név | Érték | További mezők |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Kulcs: add_opt1 Név: Output files Lehetőségek:
Kulcs: add_opt2 Név: Model Type Lehetőségek:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Kulcs: add_opt1 Név: Output files Lehetőségek:
Kulcs: add_opt2 Név: Model Type Lehetőségek:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Kulcs: add_opt1 Név: Output files Lehetőségek:
Kulcs: add_opt2 Név: Model Type Lehetőségek:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| BS Roformer (vocals, instrumental) | 40 | Kulcs: add_opt1 Név: Vocal model type Lehetőségek:
Kulcs: add_opt2 Név: Overlap Lehetőségek:
|
| BS PolarFormer (vocals, instrumental) | 123 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: Overlap Lehetőségek:
|
| MelBand Roformer (vocals, instrumental) | 48 | Kulcs: add_opt1 Név: Vocal model type Lehetőségek:
Kulcs: add_opt2 Név: Overlap Lehetőségek:
|
| MDX23C (vocals, instrumental) | 25 | Kulcs: add_opt1 Név: Vocal model type Lehetőségek:
|
| SCNet (vocals, instrumental) | 46 | Kulcs: add_opt1 Név: Vocal model type Lehetőségek:
|
| MDX B (vocals, instrumental) | 23 | Kulcs: add_opt1 Név: Vocal model type Lehetőségek:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
Kulcs: add_opt2 Név: Agressiveness Lehetőségek:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Kulcs: add_opt1 Név: Karaoke model type Lehetőségek:
Kulcs: add_opt2 Név: Extraction type Lehetőségek:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Kulcs: add_opt1 Név: Karaoke model type Lehetőségek:
|
| MVSep Crowd removal (crowd, other) | 34 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| Medley Vox (Multi-singer separation) | 53 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
Kulcs: add_opt2 Név: Processing Mode Lehetőségek:
|
| MVSep Male/Female separation | 57 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Choir (choir, other) | 112 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Drums (drums, other) | 44 | Kulcs: add_opt1 Név: Drums model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
Kulcs: add_opt3 Név: Output files Lehetőségek:
|
| MVSep Bass (bass, other) | 41 | Kulcs: add_opt1 Név: Bass model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
Kulcs: add_opt3 Név: Output files Lehetőségek:
|
| MVSep Synth (synth, other) | 88 | Kulcs: add_opt1 Név: How to extract Lehetőségek:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
Kulcs: add_opt2 Név: Preprocess Lehetőségek:
|
| MVSep Piano (piano, other) | 29 | Kulcs: add_opt1 Név: Piano model type Lehetőségek:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Kulcs: add_opt1 Név: Organ model type Lehetőségek:
|
| 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 | Kulcs: add_opt1 Név: Guitar model type Lehetőségek:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| 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 | Kulcs: add_opt1 Név: String model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Cello (cello, other) | 70 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Double Bass (double-bass, other) | 73 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Wind (wind, other) | 54 | Kulcs: add_opt1 Név: Wind model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
Kulcs: add_opt3 Név: Output files Lehetőségek:
|
| MVSep Brass (brass, other) | 107 | Kulcs: add_opt1 Név: How to extract Lehetőségek:
|
| MVSep Woodwind (woodwind, other) | 108 | Kulcs: add_opt1 Név: How to extract Lehetőségek:
|
| MVSep Saxophone (saxophone, other) | 61 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| MVSep Flute (flute, other) | 67 | Kulcs: add_opt1 Név: Flute model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Trumpet (trumpet, other) | 71 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Trombone (trombone, other) | 75 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Oboe (oboe, other) | 77 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Clarinet (clarinet, other) | 78 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep French Horn (french-horn, other) | 82 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Harmonica (harmonica, other) | 87 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| 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 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Celesta (celesta, other) | 110 | Kulcs: add_opt2 Név: How to extract Lehetőségek:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: How to extract Lehetőségek:
Kulcs: add_opt3 Név: Output files Lehetőségek:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: Cutoff (Hz) Lehetőségek:
|
| Reverb Removal (noreverb) | 22 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
Kulcs: add_opt2 Név: Preprocess Lehetőségek:
|
| DeNoise by aufr33 and gabox | 47 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| AudioSR (Super Resolution) | 59 | Kulcs: add_opt1 Név: Cutoff (Hz) Lehetőségek:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Kulcs: add_opt1 Név: Text prompt Lehetőségek: Kulcs: add_opt2 Név: Length (in seconds) Lehetőségek:
|
| Whisper (extract text from audio) | 39 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: Transcription type Lehetőségek:
|
| Parakeet (extract text from audio) | 64 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: Version Lehetőségek:
|
| VibeVoice (Voice Cloning) | 103 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: Text prompt Lehetőségek: Kulcs: add_opt3 Név: Extract vocals first Lehetőségek:
|
| VibeVoice (TTS) | 104 | Kulcs: add_opt1 Név: Model type Lehetőségek:
Kulcs: add_opt2 Név: Text prompt Lehetőségek: |
| Qwen3-TTS (Custom Voice) | 118 | Kulcs: add_opt1 Név: Text prompt Lehetőségek: Kulcs: add_opt2 Név: Speaker Lehetőségek:
Kulcs: add_opt3 Név: Language Lehetőségek:
Kulcs: add_opt4 Név: Voice description Lehetőségek: |
| Qwen3-TTS (Voice Design) | 119 | Kulcs: add_opt1 Név: Text prompt Lehetőségek: Kulcs: add_opt2 Név: Voice description Lehetőségek: Kulcs: add_opt3 Név: Language Lehetőségek:
|
| Qwen3-TTS (Voice Cloning) | 120 | Kulcs: add_opt1 Név: Text prompt Lehetőségek: Kulcs: add_opt2 Név: Reference text in audio (optional) Lehetőségek: Kulcs: add_opt3 Név: Language Lehetőségek:
Kulcs: add_opt4 Név: Extract vocals first Lehetőségek:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | Kulcs: add_opt1 Név: Text prompt Lehetőségek: Kulcs: add_opt2 Név: Speaker Lehetőségek:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
|
| Aspiration (by Sucial) | 50 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| Phantom Centre extraction | 55 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Kulcs: add_opt1 Név: How to use Lehetőségek:
|
| Transkun (Piano -> MIDI) | 113 | Kulcs: add_opt1 Név: How to extract Lehetőségek:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Kulcs: add_opt1 Név: How to extract Lehetőségek:
|
| HeartMuLa (Song Gen) | 121 | Kulcs: add_opt1 Név: Lyrics Lehetőségek: Kulcs: add_opt10 Név: Topic Lehetőségek:
Kulcs: add_opt2 Név: Tags (optional) Lehetőségek: Kulcs: add_opt3 Név: Genre Lehetőségek:
Kulcs: add_opt4 Név: Timbre Lehetőségek:
Kulcs: add_opt5 Név: Gender Lehetőségek:
Kulcs: add_opt6 Név: Mood Lehetőségek:
Kulcs: add_opt7 Név: Instrument Lehetőségek:
Kulcs: add_opt8 Név: Scene Lehetőségek:
Kulcs: add_opt9 Név: Region Lehetőségek:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Kulcs: add_opt1 Név: Vocal model type Lehetőségek:
|
| Vit Large 23 (vocals, instrum) | 33 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| UVRv5 Demucs (vocals, music) | 17 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
|
| 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 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| UnMix | 3 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| Zero Shot (Query Based) (Low quality) | 14 | Kulcs: add_opt1 Név: Model Type Lehetőségek:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Kulcs: add_opt1 Név: Model type Lehetőségek:
|
| Név | Érték |
|---|---|
| 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="<Az API-tokenje>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Kulcs | Érték |
|---|---|
| success |
|
| data | A siker kulcs függvényében további információkat tartalmaz. |
| data -> link | Megjeleníti a létrehozott feladat "EREDMÉNY SZEREZÉSE" URL-címére mutató hivatkozást (csak akkor jelenik meg, ha a siker igaz) |
| data -> hash | Megjeleníti a létrehozott feladatkivonatot (csak akkor jelenik meg, ha a siker igaz) |
| data -> message | Megjeleníti a hiba leírását (csak akkor jelenik meg, ha a siker hamis) |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Néhány paraméter hiányzik vagy érvénytelen. Ez a hiba akkor jelenik meg, ha nem ad át minden kötelező paramétert, vagy érvénytelen paramétereket ad át. |
| 401 |
Ismeretlen vagy érvénytelen api_token. Ez a hiba akkor jelenik meg, ha ismeretlen API-kulcsot használ
|
Az elválasztás eredményének eléréséhez GET-hívást kell indítania a következő URL-re:
https://mvsep.com/api/separation/get
| Terület | típus | Leírás |
|---|---|---|
| hash | Húr | Elválasztás Hash |
| mirror | Egész szám | (opcionális) Egy másik tükröt használ, ha 1-re van állítva, alapértelmezés szerint 0. Ha 1-re van állítva, api_token és 1 kredit szükséges. |
| api_token | Húr | (opcionális) a felhasználó API-kulcsa. Szükséges, ha a tükrözési paraméter 1-re van állítva. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Kulcs | Érték |
|---|---|
| success |
|
| status |
|
| data | Az állapot billentyűtől függően további információkat tárol |
| data -> queue_count | Megjeleníti a feldolgozatlan munkák számát a felhasználó prioritásában (csak akkor jelenik meg, ha az állapot várakozik vagy elosztás) |
| data -> current_order | Megjeleníti a felhasználó feladatának sorrendjét (csak akkor jelenik meg, ha az állapot várakozik vagy elosztás) |
| data -> message | Megjeleníti az állapot leírását (minden állapotnál megjelenik, helyette a hiba okát mutatja, ha az állapot sikertelen) |
| data -> algorithm | Megjeleníti a munkánál használt algoritmust (csak akkor jelenik meg, ha az állapot kész) |
| data -> algorithm_description | Megjeleníti a munkához használt algoritmus részleteit (csak akkor jelenik meg, ha az állapot kész) |
| data -> output_format | Megjeleníti a feladat kimeneti formátumát (csak akkor jelenik meg, ha az állapot kész) |
| data -> tags | Megjeleníti az audio metacímkéket (csak akkor jelenik meg, ha az állapot kész) |
| data -> input_file | Megjeleníti a bemeneti hangletöltés részleteit (csak akkor jelenik meg, ha az állapot kész) |
| data -> files | Megjeleníti a kimeneti hangok letöltésének részleteit (csak akkor jelenik meg, ha az állapot kész) |
| data -> date | Megjeleníti a munka feldolgozási dátumát (csak akkor jelenik meg, ha az állapot kész) |
| data -> finished_chunks | Egy nagy feladat befejezett részeinek számát mutatja (csak akkor jelenik meg, ha az státusz elosztás) |
| data -> all_chunks | Egy nagy feladat összes részének számát mutatja (csak akkor jelenik meg, ha az állapot elosztás) |
Egy távoli feladat eredményének lekéréséhez GET hívást kell kezdeményezni a következő URL-címre:
https://mvsep.com/api/separation/get-remote
| Terület | típus | Leírás |
|---|---|---|
| hash | Húr | Elválasztás Hash |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Kulcs | Érték |
|---|---|
| success |
|
| status |
|
| data | Az állapot billentyűtől függően további információkat tárol |
| data -> queue_count | Megjeleníti a feldolgozatlan feladatok számát a felhasználó prioritásában (csak akkor látható, ha a státusz várakozás). |
| data -> current_order | A felhasználó feladatainak sorrendjét mutatja (csak akkor látható, ha a státusz várakozás). |
| data -> message | Megjeleníti az állapot leírását (csak akkor, ha a status értéke sikertelen). |
| data -> link | Megjeleníti a létrehozott munkakör „EREDMÉNY LEKÉRÉSE” URL-címére mutató linket (csak akkor látható, ha a státusz kész). |
| data -> hash | Az elválasztás hash-e (csak akkor jelenik meg, ha a státusz kész). |
A szétválasztás megszakításához és a felhasznált kreditek visszatérítéséhez (ha a szétválasztás még nem feldolgozás alatt áll) POST hívást kell kezdeményezni a következő URL-címre:
https://mvsep.com/api/separation/cancel
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
| hash | Húr | Elválasztás Hash |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Az API-tokenje>"' --form 'hash="<hash>"'
| Kulcs | Érték |
|---|---|
| success |
|
Az elválasztási típusok részletes adatainak megtekintéséhez GET-hívást kell indítania a következő URL-re:
https://mvsep.com/api/app/algorithms
| Terület | típus | Leírás |
|---|---|---|
| scopes | Húr | Belefoglalja-e a különböző bemeneti formákat használó modelleket.
single_upload, ha nincs megadva. Az összes modell lekéréséhez állítsa be a scopes=single_upload,no_upload,matchering_upload értéket.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Az adatokat tömbként adja vissza:
| Kulcs | Érték |
|---|---|
| render_id | Elválasztás típusának értéke (ID) |
| name | Az elválasztás típusának neve |
| algorithm_group_id | A csoport, ahová az elválasztás típusa tartozik: |
| algorithm_group | Információkat tartalmaz arról az algoritmuscsoportról, amelyhez az algoritmus tartozik. |
| algorithm_group -> name | Az algoritmuscsoport neve. |
| audio_widget |
Az algoritmushoz használandó audio widget típusa. Ezzel meghatározható, hogyan jelenjen meg az algoritmus audiolejátszója a felhasználói felületen. A lehetséges értékek a következők:
|
| orientation |
Kinek szól ez az elválasztási típus:
|
| order_id | Az elválasztás típusának sorrendje |
| price_coefficient |
Arra szolgál, hogy kiszámítsa, hány kreditet vesz fel a munka a prémium felhasználótól. Ezt a képletet használja : floor(<audiofájl időtartama másodpercben> * price_coefficient / 60)?:1
|
| usage | A szétválasztási típus havi használati számát mutatja. |
| rating | A szeparációs típus havi használati értékelését mutatja tömbként:
|
| algorithm_fields | Információkat tartalmaz az elválasztás típusú további mezőkről |
| algorithm_fields -> name |
Megmutatja, hogy az elválasztástípus melyik további mezője:
|
| algorithm_fields -> text | Az elválasztástípus kiegészítő mezőjének megjelenítési neve. |
| algorithm_fields -> options | További mezők JSON kódolt kulcsértékláncai |
| algorithm_fields -> default_key | A kiegészítő mező alapértelmezett értéke. Az <code>algorithm_fields -> options</code> egyik kulcsa |
| algorithm_descriptions | Információkat tartalmaz az elválasztás típusának leírásáról |
| algorithm_descriptions -> short_description | A HTML-t nem használó elválasztási típus kis leírása. |
| algorithm_descriptions -> long_description | A HTML-t használó elválasztási típus részletes leírása. |
| algorithm_descriptions -> lang | A leírás megadott nyelvi kódja. |
Az MVSEP-pel kapcsolatos legfrissebb hírekről való tájékoztatáshoz GET-hívást kell kezdeményeznie a következő URL-címen:
https://mvsep.com/api/app/news
| Terület | típus | Leírás |
|---|---|---|
| lang | Húr | (nem kötelező) 2 betűs nyelvi kód (en, ru) |
| start | Egész szám | (opcionális) Kezdőpont eltolás, alapértelmezés szerint 0 (azaz a legkésőbbi kezdettől) |
| limit | Egész szám | (nem kötelező) A visszaadott találatok maximális száma, alapértelmezés szerint 10, maximum 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Az adatokat tömbként adja vissza:
| Kulcs | Érték |
|---|---|
| title | A hírek címe |
| lang | A hírek címe |
| text | A hír teljes leírása |
| created_at | A hírek dátuma |
A webhely várólistájának információinak lekéréséhez GET hívást kell kezdeményeznie a következő URL-címre:
https://mvsep.com/api/app/queue
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | (opcionális) A felhasználó API kulcsa |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Kulcs | Érték |
|---|---|
| queue |
Különböző csomagok aktuális várólistáinak tömbjét tartalmazza:
|
| plan |
Az aktuális csomag aktuális várólistáját tartalmazza (add hozzá az api_token kódot a regisztrált/prémium csomag kéréséhez):
|
Ha információt szeretne kapni a demó szétválasztásról, GET-hívást kell indítania a következő URL-re:
https://mvsep.com/api/app/demo
| Terület | típus | Leírás |
|---|---|---|
| start | Egész szám | (opcionális) Kezdőpont eltolás, alapértelmezés szerint 0 (azaz a legkésőbbi kezdettől) |
| limit | Egész szám | (nem kötelező) A visszaadott találatok maximális száma, alapértelmezés szerint 10, maximum 20. |
| algorithm_id | Egész szám | Opcionális elválasztási típus azonosító. Ezzel egyetlen algoritmus által létrehozott demó elválasztásokat adhat vissza. Az értékek megegyeznek a GET SEPARATION TYPES végpont render_id értékével. |
| options[FIELD] | Karakterlánc / Egész szám | Opcionális szűrő az algoritmusopciók értékéhez. Cserélje le a FIELD értéket egy további mezőkulccsal az algorithm_fields -> name mezőből a GET SEPARATION TYPES válaszban, majd adja át az adott mező egyik options kulcsát értékként. Példa: options[vocals]=1. |
| additional_options | Húr | Opcionális, raw tartalomszűrés a tárolt feladatbeállítás-adatok alapján. Új integrációkhoz az options[FIELD] paramétert részesítsd előnyben, mert explicit és könnyebben összeállítható. |
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'
Opciós szűrők létrehozásához először hívd meg a https://mvsep.com/api/app/algorithms függvényt, és vizsgáld meg az egyes algoritmusok algorithm_fields listáját. Használd a name mezőt az options[FIELD] mezőben, és az egyik JSON opciókulcsot használd értékként.
Az adatokat tömbként adja vissza:
| Kulcs | Érték |
|---|---|
| hash | Elválasztás Hash |
| date | A szétválás dátuma |
| input_audio | Adja meg a hang URL-címét |
| size | Bemeneti hangméret |
| algorithm | Alapvető információkat tartalmaz a használt elválasztási típusról (a visszaadott paraméterekkel kapcsolatos információkért tekintse meg az ELKEVÁLASZTÁSI TÍPUSOK BESZERZÉSE lapot) |
A felhasználó hitelesítéséhez és a felhasználó API-kulcsának lekérdezéséhez POST-hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/login
| Terület | típus | Leírás |
|---|---|---|
| Húr | A felhasználó e-mail címe | |
| password | Húr | A felhasználó jelszava |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<A felhasználó e-mail címe>"' --form 'password="<A felhasználó jelszava>"'
| Kulcs | Érték |
|---|---|
| success |
|
| data | Információt tartalmaz, ha a hitelesítő adatok érvényesek |
| data -> name | A felhasználó neve |
| data -> email | A felhasználó e-mail címe |
| data -> api_token | A felhasználó API-kulcsa. Győződj meg róla, hogy biztonságos tárolóhelyen tárolod, és használd későbbi műveletekhez. |
| data -> premium_minutes | A felhasználónak megmaradt kreditek |
| data -> premium_enabled |
A felhasználó engedélyezte-e a kreditek elköltését.
|
| data -> long_filenames_enabled |
Kíván-e a felhasználó extra információkat a fájlnevekben:
|
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Helytelen hitelesítő adatok lettek megadva |
A felhasználó MVSEP oldalra történő regisztrálásához POST hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/register
| Terület | típus | Leírás |
|---|---|---|
| name | Húr | A felhasználó neve |
| Húr | A felhasználó e-mail címe | |
| password | Húr | A felhasználó jelszava |
| password_confirmation | Húr | Ismételd meg a felhasználó jelszavát |
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"'
| Kulcs | Érték |
|---|---|
| success |
|
| message | Akkor következik be, ha az űrlap érvényes |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Az űrlap érvénytelen |
A felhasználói adatok lekérdezéséhez GET-hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/user
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Az API-tokenje>'
| Kulcs | Érték |
|---|---|
| success |
|
| data | Információt tartalmaz, ha a hitelesítő adatok érvényesek |
| data -> name | A felhasználó neve |
| data -> email | A felhasználó e-mail címe |
| data -> api_token | A felhasználó API-kulcsa. Győződj meg róla, hogy biztonságos tárolóhelyen tárolod, és használd későbbi műveletekhez. |
| data -> premium_minutes | A felhasználónak megmaradt kreditek |
| data -> premium_enabled |
A felhasználó engedélyezte-e a kreditek elköltését.
|
| data -> long_filenames_enabled |
Kíván-e a felhasználó extra információkat a fájlnevekben:
|
| data -> current_queue | Megjeleníti a folyamatban lévő elválasztásokat a felhasználó számára |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Érvénytelen API kulcs |
Ahhoz, hogy alapinformációkat kapj a felhasználó elkülönítéseinek előzményeiről, egy GET hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/separation_history
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
| start | Egész szám | (opcionális) Kezdőpont eltolás, alapértelmezés szerint 0 (azaz a legkésőbbi kezdettől) |
| limit | Egész szám | (nem kötelező) A visszaadott találatok maximális száma, alapértelmezés szerint 10, maximum 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Az API-tokenje>&start=1&limit=2'
| Kulcs | Érték |
|---|---|
| success |
|
| data | Alapvető információkat tartalmaz a korábbi elválasztásokról |
| data -> hash | Elválasztás Hash |
| data -> job_exists | Alapvető információkat tartalmaz a korábbi elválasztásokról |
| data -> credits | Hány kreditpontot használtak fel a feladathoz, null, ha nem létezik az elkülönítés. |
| data -> time_left | A feladat törléséig hátralévő becsült idő |
| data -> algorithm | Alapvető információkat tartalmaz a használt elválasztási típusról (a visszaadott paraméterekkel kapcsolatos információkért tekintse meg az ELKEVÁLASZTÁSI TÍPUSOK BESZERZÉSE lapot) |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Érvénytelen API kulcs |
A felhasználó prémiumhasználatának engedélyezéséhez POST-hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/enable_premium
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Az API-tokenje>"'
| Kulcs | Érték |
|---|---|
| success |
|
| message | Tájékoztat a művelet állapotáról |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Érvénytelen API kulcs |
A felhasználó prémiumhasználatának letiltásához POST-hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/disable_premium
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Az API-tokenje>"'
| Kulcs | Érték |
|---|---|
| success |
|
| message | Tájékoztat a művelet állapotáról |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Érvénytelen API kulcs |
Ahhoz, hogy engedélyezd a hosszú fájlneveket a felhasználó számára, egy POST hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/enable_long_filenames
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Az API-tokenje>"'
| Kulcs | Érték |
|---|---|
| success |
|
| message | Tájékoztat a művelet állapotáról |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Érvénytelen API kulcs |
Ahhoz, hogy letiltsd a hosszú fájlneveket a felhasználó számára, egy POST hívást kell indítanod a következő url-re:
https://mvsep.com/api/app/disable_long_filenames
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | A felhasználó API kulcsa |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Az API-tokenje>"'
| Kulcs | Érték |
|---|---|
| success |
|
| message | Tájékoztat a művelet állapotáról |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Érvénytelen API kulcs |
A Minőség-ellenőrző várólista bejegyzéseivel kapcsolatos információk lekéréséhez GET hívást kell kezdeményeznie a következő URL-címre:
https://mvsep.com/api/quality_checker/queue
| Terület | típus | Leírás |
|---|---|---|
| start | Egész szám | (opcionális) Kezdőpont eltolás, alapértelmezés szerint 0 (azaz a legkésőbbi kezdettől) |
| limit | Egész szám | (nem kötelező) A visszaadott találatok maximális száma, alapértelmezés szerint 10, maximum 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Az adatokat tömbként adja vissza:
| Kulcs | Érték |
|---|---|
| id | Bejegyzés azonosító száma |
| dataset_type | A bejegyzés/ranglista típusának hozzáadásakor kiválasztott adathalmaztípus
|
| date | A bejegyzés létrehozásának dátuma |
| algo_name | A használt elválasztási típus/algoritmus neve |
| main_text | A használt elválasztási típus/algoritmus leírása |
| proc | A feldolgozás állapota
|
| proc_remote_date | A feldolgozás dátumának időbélyegzője |
| msg | Sikeres művelet esetén „OK” értéket ad vissza, egyébként hibaüzenetet jelenít meg. |
| metrics | Információk a belépési mutatókról |
| sdr_* (wildcard) | A megfelelő tövek SDR-je |
| dataset_name | Az adathalmaz neve |
A Quality Checker ranglistáival kapcsolatos információk megszerzéséhez GET hívást kell kezdeményeznie a következő URL-címen:
https://mvsep.com/api/quality_checker/leaderboard
| Terület | típus | Leírás |
|---|---|---|
| dataset_type | Húr | Adatkészlet típusa, ha nincs megadva, alapértelmezett értéke 0.
|
| start | Egész szám | (opcionális) Kezdőpont eltolás, alapértelmezés szerint 0 (azaz a legkésőbbi kezdettől) |
| limit | Egész szám | (nem kötelező) A visszaadott találatok maximális száma, alapértelmezés szerint 10, maximum 20. |
| algo_name_filter | Húr | A megadott szöveg alapján szűri az elválasztási típus/algoritmus nevét |
| sort | Húr | Rendezés a törzs adott SDR-je szerint. A rendezhető értékek listáját az adott adathalmaztípushoz a sortables kulcsra válaszul kérheti le. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Kulcs | Érték |
|---|---|
| data | Minőség-ellenőrző bejegyzések tömbjét tartalmazza. További információkért lásd a Minőség-ellenőrzőtől kapott válasz GET QUEUE szakaszt. |
| dataset_type | Használt adatkészlet-típuskulcs |
| sortables | Kulcsok, amelyekkel a használt adathalmaz típusa adott törzs szerint, szekvenciális sorrendben rendezhető. |
| sort | A rendezhető rendezési kulcsát használtuk. |
Minőség-ellenőrző bejegyzés létrehozásához POST hívást kell kezdeményezni a következő URL-címre:
https://mvsep.com/api/quality_checker/add
| Terület | típus | Leírás |
|---|---|---|
| api_token | Húr | (kötelező) Az Ön API-kulcsa |
| zipfile | Bináris | (kötelező) Feldolgozandó zip fájl |
| algo_name | Húr | (kötelező) Az algoritmus neve |
| main_text | Húr | (kötelező) Az algoritmus leírása |
| dataset_type | Húr | Adatkészlet típusa. Alapértelmezés szerint 0.
|
| password | Húr | (kötelező) Jelszó az algoritmus törléséhez |
| ensemble | Egész szám | 0 - az algoritmus nem együttes. 1 - az algoritmus együttes. |
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"'
| Kulcs | Érték |
|---|---|
| success |
|
| data | Információkat tartalmaz a bejegyzésről |
| data -> id | a bejegyzés azonosítója |
| data -> link | Link a bejegyzéshez |
Az MVSEP API a következő hibakódokat használja:
| Hibakód | Jelentése |
|---|---|
| 400 | Az űrlap érvénytelen |
| 401 |
Ismeretlen vagy érvénytelen api_token. Ez a hiba akkor jelenik meg, ha ismeretlen API-kulcsot használ
|
A Minőség-ellenőrző várólistájára való belépéssel kapcsolatos információk azonosító szerinti lekéréséhez GET hívást kell kezdeményeznie a következő URL-címre:
https://mvsep.com/api/quality_checker/entry
| Terület | típus | Leírás |
|---|---|---|
| id | Egész szám | (kötelező) a bejegyzés azonosítója |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
A Minőség-ellenőrző várólistájának azonosító és jelszó szerinti törléséhez GET hívást kell kezdeményeznie a következő URL-címre:
https://mvsep.com/api/quality_checker/delete
| Terület | típus | Leírás |
|---|---|---|
| id | Egész szám | (kötelező) a bejegyzés azonosítója |
| password | Húr | (kötelező) A belépéshez használt jelszó |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Kulcs | Érték |
|---|---|
| success |
|
| data->message | Megjeleníti, hogy a bejegyzés törölve lett-e |
turbo@mvsep.com