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ä.
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:
|
| BS PolarFormer (vocals, instrumental) | 123 | Avain: add_opt1 Nimi: Overlap Vaihtoehdot:
|
| MelBand Roformer (vocals, instrumental) | 48 | Avain: add_opt1 Nimi: Vocal model type 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:
|
| 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 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 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 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 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 (braam , other) | 117 | |
| MVSep FX (fx, other) | 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:
|
| 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 | |
| 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