turbo@mvsep.com
MVSEP API tarjoaa ohjelmallisen pääsyn erottelun luomiseen, tulosten palauttamiseen, sivuston tietojen hakemiseen ja käyttäjän ominaisuuksien hallintaan.
API-avaimen käyttöön tarvitset API-avaimen. Et ole kirjautunut sisään, kirjaudu sisään saadaksesi API-tunnuksesi.
Esimerkkejä Pythonissa: https://github.com/ZFTurbo/MVSep-API-Examples
Epävirallinen MacVSep-sovellus Mac OS:lle: https://github.com/septcoco/macvsep
Webhookit voidaan määrittää täällä: Webhooks-sivu
OpenAPI-spesifikaatio: mvsep-openapi-spec.json
Huomaa, että Premium-käyttäjät voivat pyytää rajattomasti samanaikaisia töitä, kun taas muut kuin Premium-käyttäjät voivat pyytää vain yhtä samanaikaista työtä.
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.
Erottamisen luomiseksi sinun tulee tehdä POST-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/separation/create
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | API-avaimesi |
| audiofile | Binääri | Käsiteltävä äänitiedosto. Ei pakollinen, jos url-parametri on asetettu tai malli ei käytä tiedostosyöttöä. Käytä yhteensovitusmalleissa syötteenä target_audiofile- ja reference_audiofile-parametreja audiofile-parametrin sijaan. |
| url | String | Linkki äänitiedostoon. Ei pakollinen, jos audiofile-parametri on asetettu. |
| remote_type | String | (valinnainen) Äänitiedoston etätyyppi. Oletusarvo on direct. Ei pakollinen, jos audiofile-parametri on asetettu. Tuetut tyypit ovat direct (suora lataus), mega (MEGA), drive (Google Drive) ja dropbox (Dropbox). |
| sep_type | Kokonaisluku | (valinnainen) Erottelun tyyppi, oletusarvoisesti 11 (Demucs3 Model B (laulu, rummut, basso, muut)) |
| add_opt1 | String | (valinnainen) Erottelun tyypin ensimmäinen lisäkenttä |
| add_opt2 | String | (valinnainen) Erottelun tyypin toinen lisäkenttä |
| add_opt3 | String | (valinnainen) Erotustyypin kolmas lisäkenttä |
| output_format | Kokonaisluku | (valinnainen) tulostusmuoto, oletusarvoisesti 0 (mp3 (320kbps)) |
| is_demo | Totuusarvo | (valinnainen) julkaistaanko erottelu demo-sivulla, oletusarvoisesti false |
| Nimi | Arvo | Lisäkentät |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Avain: add_opt1 Nimi: Output files Vaihtoehdot:
Avain: add_opt2 Nimi: Model Type Vaihtoehdot:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Avain: add_opt1 Nimi: Output files Vaihtoehdot:
Avain: add_opt2 Nimi: Model Type Vaihtoehdot:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Avain: add_opt1 Nimi: Output files Vaihtoehdot:
Avain: add_opt2 Nimi: Model Type Vaihtoehdot:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| BS Roformer (vocals, instrumental) | 40 | Avain: add_opt1 Nimi: Vocal model type Vaihtoehdot:
Avain: add_opt2 Nimi: Overlap Vaihtoehdot:
|
| BS PolarFormer (vocals, instrumental) | 123 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: Overlap Vaihtoehdot:
|
| MelBand Roformer (vocals, instrumental) | 48 | Avain: add_opt1 Nimi: Vocal model type Vaihtoehdot:
Avain: add_opt2 Nimi: Overlap Vaihtoehdot:
|
| MDX23C (vocals, instrumental) | 25 | Avain: add_opt1 Nimi: Vocal model type Vaihtoehdot:
|
| SCNet (vocals, instrumental) | 46 | Avain: add_opt1 Nimi: Vocal model type Vaihtoehdot:
|
| MDX B (vocals, instrumental) | 23 | Avain: add_opt1 Nimi: Vocal model type Vaihtoehdot:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
Avain: add_opt2 Nimi: Agressiveness Vaihtoehdot:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Avain: add_opt1 Nimi: Karaoke model type Vaihtoehdot:
Avain: add_opt2 Nimi: Extraction type Vaihtoehdot:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Avain: add_opt1 Nimi: Karaoke model type Vaihtoehdot:
|
| MVSep Crowd removal (crowd, other) | 34 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| Medley Vox (Multi-singer separation) | 53 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
Avain: add_opt2 Nimi: Processing Mode Vaihtoehdot:
|
| MVSep Male/Female separation | 57 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Choir (choir, other) | 112 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Drums (drums, other) | 44 | Avain: add_opt1 Nimi: Drums model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
Avain: add_opt3 Nimi: Output files Vaihtoehdot:
|
| MVSep Bass (bass, other) | 41 | Avain: add_opt1 Nimi: Bass model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
Avain: add_opt3 Nimi: Output files Vaihtoehdot:
|
| MVSep Synth (synth, other) | 88 | Avain: add_opt1 Nimi: How to extract Vaihtoehdot:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
Avain: add_opt2 Nimi: Preprocess Vaihtoehdot:
|
| MVSep Piano (piano, other) | 29 | Avain: add_opt1 Nimi: Piano model type Vaihtoehdot:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Avain: add_opt1 Nimi: Organ model type Vaihtoehdot:
|
| 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 | Avain: add_opt1 Nimi: Guitar model type Vaihtoehdot:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| 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 | Avain: add_opt1 Nimi: String model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Cello (cello, other) | 70 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Double Bass (double-bass, other) | 73 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Wind (wind, other) | 54 | Avain: add_opt1 Nimi: Wind model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
Avain: add_opt3 Nimi: Output files Vaihtoehdot:
|
| MVSep Brass (brass, other) | 107 | Avain: add_opt1 Nimi: How to extract Vaihtoehdot:
|
| MVSep Woodwind (woodwind, other) | 108 | Avain: add_opt1 Nimi: How to extract Vaihtoehdot:
|
| MVSep Saxophone (saxophone, other) | 61 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| MVSep Flute (flute, other) | 67 | Avain: add_opt1 Nimi: Flute model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Trumpet (trumpet, other) | 71 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Trombone (trombone, other) | 75 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Oboe (oboe, other) | 77 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Clarinet (clarinet, other) | 78 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep French Horn (french-horn, other) | 82 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Harmonica (harmonica, other) | 87 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| 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 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Celesta (celesta, other) | 110 | Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: How to extract Vaihtoehdot:
Avain: add_opt3 Nimi: Output files Vaihtoehdot:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: Cutoff (Hz) Vaihtoehdot:
|
| Reverb Removal (noreverb) | 22 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
Avain: add_opt2 Nimi: Preprocess Vaihtoehdot:
|
| DeNoise by aufr33 and gabox | 47 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| AudioSR (Super Resolution) | 59 | Avain: add_opt1 Nimi: Cutoff (Hz) Vaihtoehdot:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Avain: add_opt1 Nimi: Text prompt Vaihtoehdot: Avain: add_opt2 Nimi: Length (in seconds) Vaihtoehdot:
|
| Whisper (extract text from audio) | 39 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: Transcription type Vaihtoehdot:
|
| Parakeet (extract text from audio) | 64 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: Version Vaihtoehdot:
|
| VibeVoice (Voice Cloning) | 103 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: Text prompt Vaihtoehdot: Avain: add_opt3 Nimi: Extract vocals first Vaihtoehdot:
|
| VibeVoice (TTS) | 104 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
Avain: add_opt2 Nimi: Text prompt Vaihtoehdot: |
| Qwen3-TTS (Custom Voice) | 118 | Avain: add_opt1 Nimi: Text prompt Vaihtoehdot: Avain: add_opt2 Nimi: Speaker Vaihtoehdot:
Avain: add_opt3 Nimi: Language Vaihtoehdot:
Avain: add_opt4 Nimi: Voice description Vaihtoehdot: |
| Qwen3-TTS (Voice Design) | 119 | Avain: add_opt1 Nimi: Text prompt Vaihtoehdot: Avain: add_opt2 Nimi: Voice description Vaihtoehdot: Avain: add_opt3 Nimi: Language Vaihtoehdot:
|
| Qwen3-TTS (Voice Cloning) | 120 | Avain: add_opt1 Nimi: Text prompt Vaihtoehdot: Avain: add_opt2 Nimi: Reference text in audio (optional) Vaihtoehdot: Avain: add_opt3 Nimi: Language Vaihtoehdot:
Avain: add_opt4 Nimi: Extract vocals first Vaihtoehdot:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | Avain: add_opt1 Nimi: Text prompt Vaihtoehdot: Avain: add_opt2 Nimi: Speaker Vaihtoehdot:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
|
| Aspiration (by Sucial) | 50 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| Phantom Centre extraction | 55 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Avain: add_opt1 Nimi: How to use Vaihtoehdot:
|
| Transkun (Piano -> MIDI) | 113 | Avain: add_opt1 Nimi: How to extract Vaihtoehdot:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Avain: add_opt1 Nimi: How to extract Vaihtoehdot:
|
| HeartMuLa (Song Gen) | 121 | Avain: add_opt1 Nimi: Lyrics Vaihtoehdot: Avain: add_opt10 Nimi: Topic Vaihtoehdot:
Avain: add_opt2 Nimi: Tags (optional) Vaihtoehdot: Avain: add_opt3 Nimi: Genre Vaihtoehdot:
Avain: add_opt4 Nimi: Timbre Vaihtoehdot:
Avain: add_opt5 Nimi: Gender Vaihtoehdot:
Avain: add_opt6 Nimi: Mood Vaihtoehdot:
Avain: add_opt7 Nimi: Instrument Vaihtoehdot:
Avain: add_opt8 Nimi: Scene Vaihtoehdot:
Avain: add_opt9 Nimi: Region Vaihtoehdot:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Avain: add_opt1 Nimi: Vocal model type Vaihtoehdot:
|
| Vit Large 23 (vocals, instrum) | 33 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| UVRv5 Demucs (vocals, music) | 17 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
|
| 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 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| UnMix | 3 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| Zero Shot (Query Based) (Low quality) | 14 | Avain: add_opt1 Nimi: Model Type Vaihtoehdot:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Avain: add_opt1 Nimi: Model type Vaihtoehdot:
|
| Nimi | Arvo |
|---|---|
| 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="<API-tunnuksesi>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Avain | Arvo |
|---|---|
| success |
|
| data | Sisältää lisätietoja success-näppäimestä riippuen |
| data -> link | Näyttää linkin luodun työn HAE TULOS -URL-osoitteeseen (näkyy vain, kun success on true) |
| data -> hash | Näyttää luodun työn hajautusarvon (näytetään vain, kun success on true) |
| data -> message | Näyttää virheen kuvauksen (näkyy vain, kun success on false) |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Joitakin parametreja puuttuu tai ne ovat virheellisiä. Tämä virhe ilmenee, kun et välitä kaikkia pakollisia parametreja tai välität virheellisiä parametreja. |
| 401 |
Tuntematon tai epäkelpo api_token. Tämä virhe ilmenee, jos käytät tuntematonta API-avainta
|
Erottelun tuloksen saamiseksi sinun tulee tehdä GET-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/separation/get
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| hash | String | Erottelun Hash |
| mirror | Kokonaisluku | (valinnainen) Käyttää toista peiliä, jos asetuksena on 1, oletusarvo on 0. Edellyttää api_token ja 1 krediittiä, jos arvoksi on määritetty 1. |
| api_token | String | (valinnainen) käyttäjän API-avain. Pakollinen, jos peiliparametrin arvoksi on asetettu 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Avain | Arvo |
|---|---|
| success |
|
| status |
|
| data | Sisältää lisätietoja status-näppäimestä riippuen |
| data -> queue_count | Näyttää käsittelemättömien töiden määrän käyttäjän prioriteetissa (näkyy vain, kun status on waiting tai distributing) |
| data -> current_order | Näyttää käyttäjän töiden järjestyksen (näkyy vain, kun status on waiting tai distributing) |
| data -> message | Näyttää tilan kuvauksen (näkyy kaikissa tiloissa, näyttää virheen syyn, kun status on failed) |
| data -> algorithm | Näyttää työssä käytetyn algoritmin (näkyy vain, kun status on |
| data -> algorithm_description | Näyttää käytetyn algoritmin tiedot työssä (näkyy vain, kun status on |
| data -> output_format | Näyttää työn tulostusmuodon (näkyy vain, kun status on done) |
| data -> tags | Näyttää äänen sisällönkuvauskentät (näytetään vain, kun tila on |
| data -> input_file | Näyttää äänen lataustiedot (näytetään vain, kun tila on |
| data -> files | Näyttää ulostulon lataustiedot (näkyy vain, kun status on done) |
| data -> date | Näyttää työn käsittelypäivämäärän (näkyy vain, kun status on done) |
| data -> finished_chunks | Näyttää suuren työn valmiiden osien määrän (näkyy vain, kun tila on |
| data -> all_chunks | Näyttää suuren työn kaikkien osien määrän (näkyy vain, kun status on distributing) |
Saadaksesi etätyön tuloksen, sinun on tehtävä GET-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/separation/get-remote
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| hash | String | Erottelun Hash |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Avain | Arvo |
|---|---|
| success |
|
| status |
|
| data | Sisältää lisätietoja status-näppäimestä riippuen |
| data -> queue_count | Näyttää käyttäjän prioriteetin mukaisten käsittelemättömien töiden määrän (näytetään vain, kun tila on odottaa). |
| data -> current_order | Näyttää käyttäjän työtehtävien järjestyksen (näytetään vain, kun tila on odottaa
|
| data -> message | Näyttää tilan kuvauksen (vain kun status on failed). |
| data -> link | Näyttää linkin luodun työtehtävän "HAE TULOS" -URL-osoitteeseen (näytetään vain, kun tila on valmis). |
| data -> hash | Erottelun tiiviste (näytetään vain, kun status on done). |
Peruuttaaksesi erottelun ja hyvittääksesi käytetyt krediitit (jos erottelua ei vielä käsitellä), sinun on tehtävä POST-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/separation/cancel
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
| hash | String | Erottelun Hash |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<API-tunnuksesi>"' --form 'hash="<hash>"'
| Avain | Arvo |
|---|---|
| success |
|
Jos haluat saada yksityiskohtaisia tietoja erottelutyypeistä, sinun on soitettava GET-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/algorithms
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| scopes | String | Sisällytetäänkö mallit, jotka käyttävät erilaisia syöttötapoja.
single_upload, jos sitä ei ole annettu. Saat kaikki mallit asettamalla scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Palauttaa tiedot matriisina.:
| Avain | Arvo |
|---|---|
| render_id | Erotustyypin arvo (ID) |
| name | Erotustyypin nimi |
| algorithm_group_id | Ryhmä, johon erottelutyyppi kuuluu: |
| algorithm_group | Sisältää tietoa algoritmiryhmästä, johon algoritmi kuuluu. |
| algorithm_group -> name | Algoritmiryhmän nim |
| audio_widget |
Algoritmissa käytettävän ääniwidgetin tyyppi. Tätä voidaan käyttää määrittämään, miten algoritmin äänisoitin näytetään käyttöliittymässä. Mahdollisia arvoja ovat:
|
| orientation |
Kenelle tämä erottelutyyppi on tarkoitettu:
|
| order_id | Erottelutyypin järjestys |
| price_coefficient |
Käytetään laskemaan, kuinka monta krediittiä työ vie premium-käyttäjältä. Käyttää tätä kaavaa : floor(<äänitiedoston kesto sekunteina> * price_coefficient / 60)?:1
|
| usage | Näyttää erottelutyypin kuukausittaisen käyttömäärän |
| rating | Näyttää erottelutyypin kuukausittaisen käyttöluokituksen taulukkona:
|
| algorithm_fields | Sisältää tietoja erottelutyypin muista kentistä. |
| algorithm_fields -> name |
Näyttää, mikä erotustyypin lisäkenttä:
|
| algorithm_fields -> text | Erotustyypin lisäkentän näyttönimi. |
| algorithm_fields -> options | JSON Lisäkentän koodatut avainarvoketjut |
| algorithm_fields -> default_key | Lisäkentän oletusarvo. Yksi <koodin>algorithm_fields -> vaihtoehdoista< / koodi> |
| algorithm_descriptions | Sisältää tietoja erotustyypin kuvauksista |
| algorithm_descriptions -> short_description | Pieni kuvaus erotustyypistä, joka ei käytä HTML-koodia. |
| algorithm_descriptions -> long_description | HTML-koodia käyttävän erotustyypin yksityiskohtainen kuvaus. |
| algorithm_descriptions -> lang | Kuvauksen määritetty kielikoodi. |
Saadaksesi tietoa viimeisimmistä MVSEP-uutisista, sinun on soitettava GET-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/news
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| lang | String | (valinnainen) 2-kirjaiminen kielikoodi (en, ru) |
| start | Kokonaisluku | (valinnainen) Lähtöpisteen siirtymä, oletusarvo 0 (eli alkaa uusimmasta) |
| limit | Kokonaisluku | (valinnainen) Palautettujen tulosten enimmäismäärä, oletusarvo 10, maksimi on 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Palauttaa tiedot matriisina.:
| Avain | Arvo |
|---|---|
| title | Uutisen otsikko |
| lang | Uutisen otsikko |
| text | Täydellinen kuvaus uutisista |
| created_at | Uutisen päivämäärä |
Saadaksesi sivuston jonotiedot, sinun on tehtävä GET-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/queue
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | (valinnainen) Käyttäjän API-avain |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Avain | Arvo |
|---|---|
| queue |
Sisältää taulukon eri sopimusten nykyisistä jonoista:
|
| plan |
Sisältää nykyisen jonon nykyiselle sopimukselle (lisää api_token rekisteröityä/premium-sopimusta koskevaan pyyntöön):
|
Jos haluat saada tietoja esittelyeroista, sinun on soitettava GET-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/demo
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| start | Kokonaisluku | (valinnainen) Lähtöpisteen siirtymä, oletusarvo 0 (eli alkaa uusimmasta) |
| limit | Kokonaisluku | (valinnainen) Palautettujen tulosten enimmäismäärä, oletusarvo 10, maksimi on 20. |
| algorithm_id | Kokonaisluku | Valinnainen erottelutyypin tunnus. Käytä tätä palauttaaksesi vain yhden algoritmin luomat demoerottelut. Arvot vastaavat GET SEPARATION TYPES -päätepisteen render_id-ominaisuutta |
| options[FIELD] | Merkkijono / Kokonaisluku | Valinnainen suodatin algoritmiasetusten arvoille. Korvaa FIELD lisäkenttäavaimella kohdasta algorithm_fields -> name GET SEPARATION TYPES -vastauksessa ja anna sitten yksi kyseisen kentän options-avaimista arvona. Esimerkki: options[vocals]=1. |
| additional_options | String | Valinnainen raakadatasuodatin tallennettujen työvaihtoehtotietojen perusteella. Suosittelemme options[FIELD]-metodia uusille integraatioille, koska se on selkeä ja helpompi koota. |
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'
Luodaksesi vaihtoehtosuodattimia, kutsu ensin https://mvsep.com/api/app/algorithms ja tutki jokaisen algoritmin algorithm_fields-luetteloa. Käytä name-kenttää options[FIELD]-kentän sisällä ja käytä yhtä JSON-asetusavaimista arvona.
Palauttaa tiedot matriisina.:
| Avain | Arvo |
|---|---|
| hash | Erottelun Hash |
| date | Eron päivämäärä |
| input_audio | Syötä äänen URL-osoite |
| size | Tulon äänen koko |
| algorithm | Sisältää perustietoja käytetystä erottelutyypistä (katso lisätietoja palautetuista parametreista kohdasta HAE EROTTELUTYYPIT) |
Jos haluat todentaa käyttäjän ja saada käyttäjän API-avaimen, sinun on soitettava POST-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/login
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| String | Käyttäjän sähköpostiosoite | |
| password | String | Käyttäjän salasana |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Käyttäjän sähköpostiosoite>"' --form 'password="<Käyttäjän salasana>"'
| Avain | Arvo |
|---|---|
| success |
|
| data | Sisältää tiedot, kun tunnistetiedot ovat kelvollisia |
| data -> name | Käyttäjän nimi |
| data -> email | Käyttäjän sähköpostiosoite |
| data -> api_token | Käyttäjän API-avain. Varmista, että säilytät sitä turvallisessa säilytyksessä ja käytät sitä seuraavia toimintoja varten. |
| data -> premium_minutes | Käyttäjälle jäävät krediitit |
| data -> premium_enabled |
Salliko käyttäjä krediittien käyttämisen.
|
| data -> long_filenames_enabled |
Haluaako käyttäjä lisätietoja tiedostonimissä:
|
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheelliset tunnistetiedot määritetty |
Jos haluat rekisteröidä käyttäjän MVSEP-sivustoon, sinun on soitettava POST-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/register
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| name | String | Käyttäjän nimi |
| String | Käyttäjän sähköpostiosoite | |
| password | String | Käyttäjän salasana |
| password_confirmation | String | Toista käyttäjän salasana |
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"'
| Avain | Arvo |
|---|---|
| success |
|
| message | Tapahtuu, kun lomake on kelvollinen |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Lomake on virheellinen |
Jotta saat käyttäjätietoja, sinun on soitettava GET-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/user
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<API-tunnuksesi>'
| Avain | Arvo |
|---|---|
| success |
|
| data | Sisältää tiedot, kun tunnistetiedot ovat kelvollisia |
| data -> name | Käyttäjän nimi |
| data -> email | Käyttäjän sähköpostiosoite |
| data -> api_token | Käyttäjän API-avain. Varmista, että säilytät sitä turvallisessa säilytyksessä ja käytät sitä seuraavia toimintoja varten. |
| data -> premium_minutes | Käyttäjälle jäävät krediitit |
| data -> premium_enabled |
Salliko käyttäjä krediittien käyttämisen.
|
| data -> long_filenames_enabled |
Haluaako käyttäjä lisätietoja tiedostonimissä:
|
| data -> current_queue | Näyttää käyttäjän jatkuvat erottelut |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheellinen API-avain |
Jos haluat saada käyttäjän perustietojen erotteluhistorian, sinun on soitettava GET-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/separation_history
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
| start | Kokonaisluku | (valinnainen) Lähtöpisteen siirtymä, oletusarvo 0 (eli alkaa uusimmasta) |
| limit | Kokonaisluku | (valinnainen) Palautettujen tulosten enimmäismäärä, oletusarvo 10, maksimi on 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<API-tunnuksesi>&start=1&limit=2'
| Avain | Arvo |
|---|---|
| success |
|
| data | Sisältää perustietotaulukon aiemmista eroista |
| data -> hash | Erottelun Hash |
| data -> job_exists | Sisältää perustietotaulukon aiemmista eroista |
| data -> credits | Kuinka monta krediittiä työhön käytettiin, null, jos erottelua ei ole |
| data -> time_left | Arvioitu aika, joka on jäljellä työn poistamiseen |
| data -> algorithm | Sisältää perustietoja käytetystä erottelutyypistä (katso lisätietoja palautetuista parametreista kohdasta HAE EROTTELUTYYPIT) |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheellinen API-avain |
Jos haluat ottaa premium-käytön käyttöön käyttäjälle, sinun on soitettava POST-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/enable_premium
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<API-tunnuksesi>"'
| Avain | Arvo |
|---|---|
| success |
|
| message | Tiedottaa toiminnan tilasta |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheellinen API-avain |
Jos haluat poistaa premium-käytön käytöstä käyttäjältä, sinun on soitettava POST-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/disable_premium
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<API-tunnuksesi>"'
| Avain | Arvo |
|---|---|
| success |
|
| message | Tiedottaa toiminnan tilasta |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheellinen API-avain |
Jos haluat ottaa käyttäjälle käyttöön pitkät tiedostonimet, sinun on soitettava POST-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/enable_long_filenames
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<API-tunnuksesi>"'
| Avain | Arvo |
|---|---|
| success |
|
| message | Tiedottaa toiminnan tilasta |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheellinen API-avain |
Jos haluat poistaa pitkät tiedostonimet käytöstä käyttäjältä, sinun on soitettava POST-puhelu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/app/disable_long_filenames
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | Käyttäjän API-avain |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<API-tunnuksesi>"'
| Avain | Arvo |
|---|---|
| success |
|
| message | Tiedottaa toiminnan tilasta |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Virheellinen API-avain |
Saadaksesi tietoja laaduntarkistimen jonomerkinnöistä, sinun on tehtävä GET-kutsu seuraavaan URL-osoitteeseen
https://mvsep.com/api/quality_checker/queue
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| start | Kokonaisluku | (valinnainen) Lähtöpisteen siirtymä, oletusarvo 0 (eli alkaa uusimmasta) |
| limit | Kokonaisluku | (valinnainen) Palautettujen tulosten enimmäismäärä, oletusarvo 10, maksimi on 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Palauttaa tiedot matriisina.:
| Avain | Arvo |
|---|---|
| id | Merkinnän tunnistenumero |
| dataset_type | Merkinnän / tulostaulukon tyypin lisäyksen yhteydessä valittu tietojoukon tyyppi
|
| date | Merkinnän luontipäivämäärä |
| algo_name | Käytetyn erotustyypin/algoritmin nimi |
| main_text | Käytetyn erotustyypin/algoritmin kuvaus |
| proc | Käsittelyn tila
|
| proc_remote_date | Käsittelypäivämäärän aikaleima |
| msg | Palauttaa "OK", jos onnistuu, muuten näyttää virheilmoituksen |
| metrics | Tietoa aloitusmittareista |
| sdr_* (wildcard) | Vastaavien varsien SDR |
| dataset_name | Aineistosarjan nimi |
Saadaksesi tietoa Quality Checkerin tulostaulukoista, sinun on tehtävä GET-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/quality_checker/leaderboard
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| dataset_type | String | Tietojoukon tyyppi, oletusarvo on 0, jos sitä ei anneta.
|
| start | Kokonaisluku | (valinnainen) Lähtöpisteen siirtymä, oletusarvo 0 (eli alkaa uusimmasta) |
| limit | Kokonaisluku | (valinnainen) Palautettujen tulosten enimmäismäärä, oletusarvo 10, maksimi on 20. |
| algo_name_filter | String | Suodattaa erottelutyypin/algoritmin nimet annetun tekstin perusteella |
| sort | String | Lajittele annetun vartalon SDR:n mukaan. Voit saada luettelon lajiteltavista arvoista tietylle tietojoukkotyypille vastauksena olevasta sortables-avaimesta. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Avain | Arvo |
|---|---|
| data | Sisältää joukon laaduntarkistuksen merkintöjä. Lisätietoja on osiossa GET QUEUE -vastaus laaduntarkistajalta. |
| dataset_type | Käytetty tietojoukon tyyppiavain |
| sortables | Avaimet, joita voidaan käyttää lajittelemaan käytetty tietojoukko tyyppi annetun runko-osan mukaan peräkkäisessä järjestyksessä. |
| sort | Käytetty lajitteluavainta lajiteltavasta. |
Laaduntarkistusmerkinnän luomiseksi sinun on tehtävä POST-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/quality_checker/add
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| api_token | String | (pakollinen) API-avaimesi |
| zipfile | Binääri | (pakollinen) Käsiteltävä zip-tiedosto |
| algo_name | String | (pakollinen) Algoritmin nimi |
| main_text | String | (pakollinen) Algoritmin kuvaus |
| dataset_type | String | Tietojoukon tyyppi. Oletusarvo on 0.
|
| password | String | (pakollinen) Salasana algoritmin poistamiseen |
| ensemble | Kokonaisluku | 0 - algoritmi ei ole ensemble. 1 - algoritmi on 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"'
| Avain | Arvo |
|---|---|
| success |
|
| data | Sisältää tietoa merkinnästä |
| data -> id | Merkinnän ID |
| data -> link | Linkki merkintään |
MVSEP API käyttää seuraavia virhekoodeja:
| Virhekoodi | Merkitsevä |
|---|---|
| 400 | Lomake on virheellinen |
| 401 |
Tuntematon tai epäkelpo api_token. Tämä virhe ilmenee, jos käytät tuntematonta API-avainta
|
Saadaksesi tietoa laaduntarkistimen jonomerkinnästä tunnuksen perusteella, sinun on tehtävä GET-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/quality_checker/entry
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| id | Kokonaisluku | (pakollinen) Merkinnän ID |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Laaduntarkistimen jonomerkinnän poistamiseksi tunnuksen ja salasanan perusteella sinun on tehtävä GET-kutsu seuraavaan URL-osoitteeseen:
https://mvsep.com/api/quality_checker/delete
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| id | Kokonaisluku | (pakollinen) Merkinnän ID |
| password | String | (pakollinen) Käytetty salasana sisäänkirjautumiseen |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Avain | Arvo |
|---|---|
| success |
|
| data->message | Näyttää, onko merkintä poistettu |
turbo@mvsep.com