turbo@mvsep.com
L'API di MVSEP fornisce accesso programmatico per creare una separazione, restituisce i risultati, ottiene le informazione del sito e controlla la capacità dell'utente.
Per utilizzare questa API, hai bisogno di una chiave API. Non sei loggato, accedi per ottenere il tuo token API.
Esempi in Python: https://github.com/ZFTurbo/MVSep-API-Examples
Applicazione non ufficiale MacVSep per MacOS: https://github.com/septcoco/macvsep
I webhooks possono essere impostati qui: Pagina webhooks
Specifica OpenAPI: mvsep-openapi-spec.json
Nota: gli utenti Premium possono richiedere un numero illimitato di task di separazioni contemporanei, mentre gli utenti non Premium possono richiedere solo 1 task di separazione alla volta.
Per creare una separazione devi effettuare una chiamata POST al seguente URL:
https://mvsep.com/api/separation/create
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | La tua chiave API |
| audiofile | Binario | File audio da processare. Non necessario se è impostato il parametro url o il modello non prevede file in input. Per i modelli di matchering, usare target_audiofile e reference_audiofile come input invece di audiofile. |
| url | Stringa (testo) | Link al file audio. Non necessario se è impostato il parametro audiofile. |
| remote_type | Stringa (testo) | (Opzionale) Origine del file audio remoto. Di default, è direct. Non richiesto se è impostato il parametro audiofile. Origini supportate sono direct (download diretto), ) mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Intero | (opzionale) Tipo di separazione, predefinito 11 (Modello Demucs3 B (voce, batteria, basso, altro)) |
| add_opt1 | Stringa (testo) | (opzionale) Primo campo aggiuntivo del tipo di separazione |
| add_opt2 | Stringa (testo) | (opzionale) Secondo campo aggiuntivo del tipo di separazione |
| add_opt3 | Stringa (testo) | (Facoltativo) Tipo di separazione, terzo campo addizionale |
| output_format | Intero | (opzionale) formato di output, predefinito 0 (mp3 (320kbps)) |
| is_demo | Booleano | (opzionale) la separazione dovrebbe essere pubblicata sulla pagina demo, predefinito è falso |
| Nome | Valore | Parametri opzionali |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Chiave: add_opt1 Nome: Output files Opzioni:
Chiave: add_opt2 Nome: Model Type Opzioni:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Chiave: add_opt1 Nome: Output files Opzioni:
Chiave: add_opt2 Nome: Model Type Opzioni:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Chiave: add_opt1 Nome: Output files Opzioni:
Chiave: add_opt2 Nome: Model Type Opzioni:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| BS Roformer (vocals, instrumental) | 40 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
|
| BS PolarFormer (vocals, instrumental) | 123 | Chiave: add_opt1 Nome: Overlap Opzioni:
|
| MelBand Roformer (vocals, instrumental) | 48 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
|
| MDX23C (vocals, instrumental) | 25 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
|
| SCNet (vocals, instrumental) | 46 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
|
| MDX B (vocals, instrumental) | 23 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Chiave: add_opt1 Nome: Model Type Opzioni:
Chiave: add_opt2 Nome: Agressiveness Opzioni:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Chiave: add_opt1 Nome: Karaoke model type Opzioni:
Chiave: add_opt2 Nome: Extraction type Opzioni:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Chiave: add_opt1 Nome: Karaoke model type Opzioni:
|
| MVSep Crowd removal (crowd, other) | 34 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| Medley Vox (Multi-singer separation) | 53 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Chiave: add_opt1 Nome: Model Type Opzioni:
|
| MVSep Male/Female separation | 57 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Choir (choir, other) | 112 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Drums (drums, other) | 44 | Chiave: add_opt1 Nome: Drums model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
Chiave: add_opt3 Nome: Output files Opzioni:
|
| MVSep Bass (bass, other) | 41 | Chiave: add_opt1 Nome: Bass model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
Chiave: add_opt3 Nome: Output files Opzioni:
|
| MVSep Synth (synth, other) | 88 | Chiave: add_opt1 Nome: How to extract Opzioni:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Chiave: add_opt1 Nome: Model Type Opzioni:
Chiave: add_opt2 Nome: Preprocess Opzioni:
|
| MVSep Piano (piano, other) | 29 | Chiave: add_opt1 Nome: Piano model type Opzioni:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Chiave: add_opt1 Nome: Organ model type Opzioni:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Chiave: add_opt1 Nome: Guitar model type Opzioni:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| 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 | Chiave: add_opt1 Nome: String model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Cello (cello, other) | 70 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Double Bass (double-bass, other) | 73 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Wind (wind, other) | 54 | Chiave: add_opt1 Nome: Wind model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
Chiave: add_opt3 Nome: Output files Opzioni:
|
| MVSep Brass (brass, other) | 107 | Chiave: add_opt1 Nome: How to extract Opzioni:
|
| MVSep Woodwind (woodwind, other) | 108 | Chiave: add_opt1 Nome: How to extract Opzioni:
|
| MVSep Saxophone (saxophone, other) | 61 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| MVSep Flute (flute, other) | 67 | Chiave: add_opt1 Nome: Flute model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Trumpet (trumpet, other) | 71 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Trombone (trombone, other) | 75 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Oboe (oboe, other) | 77 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Clarinet (clarinet, other) | 78 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep French Horn (french-horn, other) | 82 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Harmonica (harmonica, other) | 87 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| 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 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Celesta (celesta, other) | 110 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Chiave: add_opt1 Nome: Model Type Opzioni:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: How to extract Opzioni:
Chiave: add_opt3 Nome: Output files Opzioni:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Cutoff (Hz) Opzioni:
|
| Reverb Removal (noreverb) | 22 | Chiave: add_opt1 Nome: Model Type Opzioni:
Chiave: add_opt2 Nome: Preprocess Opzioni:
|
| DeNoise by aufr33 and gabox | 47 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| AudioSR (Super Resolution) | 59 | Chiave: add_opt1 Nome: Cutoff (Hz) Opzioni:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Chiave: add_opt1 Nome: Text prompt Opzioni: Chiave: add_opt2 Nome: Length (in seconds) Opzioni:
|
| Whisper (extract text from audio) | 39 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Transcription type Opzioni:
|
| Parakeet (extract text from audio) | 64 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Version Opzioni:
|
| VibeVoice (Voice Cloning) | 103 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Text prompt Opzioni: Chiave: add_opt3 Nome: Extract vocals first Opzioni:
|
| VibeVoice (TTS) | 104 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Text prompt Opzioni: |
| Qwen3-TTS (Custom Voice) | 118 | Chiave: add_opt1 Nome: Text prompt Opzioni: Chiave: add_opt2 Nome: Speaker Opzioni:
Chiave: add_opt3 Nome: Language Opzioni:
Chiave: add_opt4 Nome: Voice description Opzioni: |
| Qwen3-TTS (Voice Design) | 119 | Chiave: add_opt1 Nome: Text prompt Opzioni: Chiave: add_opt2 Nome: Voice description Opzioni: Chiave: add_opt3 Nome: Language Opzioni:
|
| Qwen3-TTS (Voice Cloning) | 120 | Chiave: add_opt1 Nome: Text prompt Opzioni: Chiave: add_opt2 Nome: Reference text in audio (optional) Opzioni: Chiave: add_opt3 Nome: Language Opzioni:
Chiave: add_opt4 Nome: Extract vocals first Opzioni:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | Chiave: add_opt1 Nome: Text prompt Opzioni: Chiave: add_opt2 Nome: Speaker Opzioni:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Chiave: add_opt1 Nome: Model Type Opzioni:
|
| Aspiration (by Sucial) | 50 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| Phantom Centre extraction | 55 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Chiave: add_opt1 Nome: How to use Opzioni:
|
| Transkun (piano -> midi) | 113 | Chiave: add_opt1 Nome: How to extract Opzioni:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Chiave: add_opt1 Nome: Lyrics Opzioni: Chiave: add_opt10 Nome: Topic Opzioni:
Chiave: add_opt2 Nome: Tags (optional) Opzioni: Chiave: add_opt3 Nome: Genre Opzioni:
Chiave: add_opt4 Nome: Timbre Opzioni:
Chiave: add_opt5 Nome: Gender Opzioni:
Chiave: add_opt6 Nome: Mood Opzioni:
Chiave: add_opt7 Nome: Instrument Opzioni:
Chiave: add_opt8 Nome: Scene Opzioni:
Chiave: add_opt9 Nome: Region Opzioni:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
|
| Vit Large 23 (vocals, instrum) | 33 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| UVRv5 Demucs (vocals, music) | 17 | Chiave: add_opt1 Nome: Model Type Opzioni:
|
| 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 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| UnMix | 3 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| Zero Shot (Query Based) (Low quality) | 14 | Chiave: add_opt1 Nome: Model Type Opzioni:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Chiave: add_opt1 Nome: Model type Opzioni:
|
| Nome | Valore |
|---|---|
| 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="<Il tuo Token API>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Chiave | Valore |
|---|---|
| success |
|
| data | Contiene informazioni extra dipendenti dalla chiave success |
| data -> link | Mostra link all'URL "OTTIENI IL RISULTATO" del processo creato (mostrato solo nel caso in cui success è true) |
| data -> hash | Mostra l'hash del processo creato (mostrato solo nel caso in cui success è true) |
| data -> message | Mostra la descrizione di un errore (mostrato solo nel caso in cui success è false
|
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Mancano alcuni parametri o sono non validi. Questo errore appare quando non si passano tutti i parametri obbligatori o si passano parametri non validi. |
| 401 |
api_token sconosciuto o non valido. Questo errore appare se si utilizza una chiave API sconosciuta
|
Per ottenere il risultato della separazione, è necessario effettuare una chiamata GET al seguente URL:
https://mvsep.com/api/separation/get
| Campo | Tipo | Descrizione |
|---|---|---|
| hash | Stringa (testo) | Hash della separazione |
| mirror | Intero | (Facoltativo) Usa un altro mirror se è impostato su 1, predefinito a 0. Richiede api_token e 1 credito se impostato a 1. |
| api_token | Stringa (testo) | (Facoltativo) Chiave API dell'utente. Richiesto se il parametro del mirror è impostato a 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Chiave | Valore |
|---|---|
| success |
|
| status |
|
| data | Contiene informazioni extra che dipendono dalla chiave status |
| data -> queue_count | Mostra il numero dei processi non completati nella priority dell'utente (mostrato solo nel caso in cui status è waiting o distributing) |
| data -> current_order | Mostra l'ordine del processo dell'utente (mostrato solo nel caso in cui status è waiting o distributing) |
| data -> message | Mostra la descrizione dello stato (mostrato su tutti gli status, altrimenti mostra la ragione degli errori quando i>status è failed) |
| data -> algorithm | Mostra l'algoritmo utilizzato nel processo (mostrato solo quando status è done) |
| data -> algorithm_description | Mostra i dettagli dell'algoritmo utilizzato nel processo (mostrato solo quando status è done) |
| data -> output_format | Mostra il formato dell'output del processo (mostrato solo quando status è done) |
| data -> tags | Mostra i meta tags dell'audio (mostrato solo quando status è done) |
| data -> input_file | Mostra i dettagli del download dell'input audio (mostrato solo quando status è done) |
| data -> files | Mostra i dettagli del download degli output audio (mostrato solo quando status è done |
| data -> date | Mostra la data dell'inizio del processo (mostrato solo quando status è done) |
| data -> finished_chunks | Mostra il numero delle parti finite di un processo grande (mostrato solo quando status è distributing) |
| data -> all_chunks | Mostra il numero di tutte le parti di un processo grande (mostrato solo quando status è distributing) |
Per ottenere i risultati di un task di separazione da remoto, eseguire una chiamata GET al seguente url:
https://mvsep.com/api/separation/get-remote
| Campo | Tipo | Descrizione |
|---|---|---|
| hash | Stringa (testo) | Hash della separazione |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Chiave | Valore |
|---|---|
| success |
|
| status |
|
| data | Contiene informazioni extra che dipendono dalla chiave status |
| data -> queue_count | Mostra il numero di task di separazioni non processate in lista di priorità dell'utente (mostrato solo quando status è waiting). |
| data -> current_order | Mostra l'ordine del task di separazione dell'utente (mostrato solo quando status è waiting). |
| data -> message | Mostra la descrizione dello stato (solo quando status è failed). |
| data -> link | Mostra il link all'url "OTTIENI RISULTATI" del task di separazione creato (mostrato solo quando status è done). |
| data -> hash | Hash della separazione (mostrato solo quando status è done). |
Per annullare la separazione e far rimborsare i crediti usati (se il task di separazione non è ancora stato processato), eseguire una chiamata POST al seguente url:
https://mvsep.com/api/separation/cancel
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
| hash | Stringa (testo) | Hash della separazione |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Il tuo Token API>"' --form 'hash="<hash>"'
| Chiave | Valore |
|---|---|
| success |
|
Per ottenere dati dettagliati sui tipi di separazione, devi fare una chiamata GET al seguente url:
https://mvsep.com/api/app/algorithms
| Campo | Tipo | Descrizione |
|---|---|---|
| scopes | Stringa (testo) | Scegliere se includere modelli che usano diverse modalità di input.
single_upload se non fornito. Per ottenere tutti i modelli, impostare scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Restituisce i dati come un array (vettore):
| Chiave | Valore |
|---|---|
| render_id | Valore del tipo di separazione (ID) |
| name | Nome del tipo di separazione |
| algorithm_group_id | Il gruppo a cui appartiene il tipo di separazione: |
| algorithm_group | Contiene informazioni riguardo il gruppo di algoritmi a cui appartiene l'algoritmo. |
| algorithm_group -> name | Nome del gruppo di algoritmi. |
| audio_widget |
Il tipo di widget audio da usare per l'algoritmo. Può essere utilizzato per determinare la modalità di visualizzazione nel frontend del player audio per l'algoritmo. Possibili valori sono:
|
| orientation |
Per coloro a cui è destinato questo tipo di separazione:
|
| order_id | L'ordine del tipo di separazione |
| price_coefficient |
Usato per calcolare quanti crediti servono al processo per un utente premium. Usa questa formula : floor(<Durata dell'audiofile in secondi> * price_coefficient / 60)?:1
|
| usage | Mostra conteggio di utilizzi mensili per quel tipo di separazione |
| rating | Mostra valutazione mensile dell'utilizzo di quel tipo di separazione come array:
|
| algorithm_fields | Contiene informazioni riguardo i campi addizionali dei tipi di separazione |
| algorithm_fields -> name |
Mostra quale campo addizionale del tipo di separazione:
|
| algorithm_fields -> text | Mostra il nome del campo addizionale del tipo di separazione |
| algorithm_fields -> options | Valore delle catene della chiave codificata JSON del campo addizionale |
| algorithm_fields -> default_key | Valore predefinito del campo addizionale. Una delle chiavi di <code>algorithm_fields -> options</code> |
| algorithm_descriptions | Contiene informazioni sulla descrizione del tipo di separazione. |
| algorithm_descriptions -> short_description | Piccola descrizione del tipo di separazione che non usa HTML. |
| algorithm_descriptions -> long_description | Descrizione dettagliata del tipo di separazione che usa HTML. |
| algorithm_descriptions -> lang | Specifica il codice della lingua della descrizione. |
Per ottenere informazioni sulle ultime novità di MVSEP, devi fare una chiamata GET al seguente url:
https://mvsep.com/api/app/news
| Campo | Tipo | Descrizione |
|---|---|---|
| lang | Stringa (testo) | (facoltativo) codice lingua a 2 lettere (en, ru) |
| start | Intero | (facoltativo) Punto di inizio offset, predefiniti a 0 (i.e. comincia dall'ultimo) |
| limit | Intero | (facoltativo) Massima quantità di dettagli restituita, predefiniti a 10, il massimo è 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Restituisce i dati come un array (vettore):
| Chiave | Valore |
|---|---|
| title | Titolo delle notizie |
| lang | Titolo delle notizie |
| text | Descrizione completa delle notizie |
| created_at | Data delle notizie |
Per ottenere conteggio della coda di elaborazione del sito, eseguire una chiamata GET al seguente url:
https://mvsep.com/api/app/queue
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | (opzionale) Chiave API dell'utente |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Chiave | Valore |
|---|---|
| queue |
Contiene array di code di elaborazione attuali per vari piani:
|
| plan |
Contiene il numero in coda attuale per il piano scelto (aggiungere api_token per ottenere il valore riservato a utenti registrati/premium)
|
Per avere informazioni sulle separazioni demo, devi fare una chiamata GET al seguente url:
https://mvsep.com/api/app/demo
| Campo | Tipo | Descrizione |
|---|---|---|
| start | Intero | (facoltativo) Punto di inizio offset, predefiniti a 0 (i.e. comincia dall'ultimo) |
| limit | Intero | (facoltativo) Massima quantità di dettagli restituita, predefiniti a 10, il massimo è 20. |
| algorithm_id | Intero | ID opzionale del tipo di separazione. Utilizzare esclusivamente per richiedere separazioni demo create da un singolo algoritmo. I valori render_id si trovano nell'endpoint OTTIENI TIPI DI SEPARAZIONE |
| options[FIELD] | Stringa (testo) / intero | Filtro opzionale per valori di parametri dell'algoritmo. Sostituire FIELD con un campo chiave aggiuntivo da algorithm_fields -> name nella risposta da OTTIENI TIPI DI SEPARAZIONE, quindi passa una delle chiavi options di quel campo come valore. Esempio: options[vocals]=1. |
| additional_options | Stringa (testo) | ? |
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'
Per creare filtri per le opzioni, innanzitutto chiamare https://mvsep.com/api/app/algorithms e ispezionare la lista di campi algorithm_fields di ogni algoritmo. Usare il campo name dentro a options[FIELD] e usare una delle chiavi di opzione JSON come valore.
Restituisce i dati come un array (vettore):
| Chiave | Valore |
|---|---|
| hash | Hash della separazione |
| date | Data della separazione |
| input_audio | URL dell'input audio |
| size | Dimensioni dell'input audio |
| algorithm | Contieni informazioni base sul tipo di separazione utilizzata (si riferisce al tab "OTTIENI TIPI DI SEPARAZIONE" per informazioni sui parametri restituiti) |
Per autenticare l'utente e ottenere la sua chiave API, devi fare una chiamata POST al seguente url:
https://mvsep.com/api/app/login
| Campo | Tipo | Descrizione |
|---|---|---|
| Stringa (testo) | Email dell'utente | |
| password | Stringa (testo) | Password dell'utente |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Email dell'utente>"' --form 'password="<Password dell'utente>"'
| Chiave | Valore |
|---|---|
| success |
|
| data | Contiene informazioni quando le credenziali sono corrette |
| data -> name | Nome dell'utente |
| data -> email | Email dell'utente |
| data -> api_token | La chiave API dell'utente. Assicurati di conservarla in un posto sicuro e usuale per le operazioni successive. |
| data -> premium_minutes | Crediti rimanenti dell'utente |
| data -> premium_enabled |
Se l'utente ha acconsentito che i crediti vengano spesi.
|
| data -> long_filenames_enabled |
Se l'utente vuole informazioni extra sui nomi dei file:
|
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Credenziali inserite non corrette |
Per registrare l'utente al sito MVSEP, devi fare una chiamata POST al seguente url:
https://mvsep.com/api/app/register
| Campo | Tipo | Descrizione |
|---|---|---|
| name | Stringa (testo) | Nome dell'utente |
| Stringa (testo) | Email dell'utente | |
| password | Stringa (testo) | Password dell'utente |
| password_confirmation | Stringa (testo) | Reinserisci la password dell'utente |
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"'
| Chiave | Valore |
|---|---|
| success |
|
| message | Avviene quando il modulo è valido |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Modulo invalido |
Per ottenere informazioni sull'utente, devi fare una chiamata GET al seguente url:
https://mvsep.com/api/app/user
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Il tuo Token API>'
| Chiave | Valore |
|---|---|
| success |
|
| data | Contiene informazioni quando le credenziali sono corrette |
| data -> name | Nome dell'utente |
| data -> email | Email dell'utente |
| data -> api_token | La chiave API dell'utente. Assicurati di conservarla in un posto sicuro e usuale per le operazioni successive. |
| data -> premium_minutes | Crediti rimanenti dell'utente |
| data -> premium_enabled |
Se l'utente ha acconsentito che i crediti vengano spesi.
|
| data -> long_filenames_enabled |
Se l'utente vuole informazioni extra sui nomi dei file:
|
| data -> current_queue | Mostra le separazioni in corso per l'utente |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Chiave API non valida |
Per ottenere informazioni di base sulla cronologia dell'utente, devi fare una chiamata GET al seguente url:
https://mvsep.com/api/app/separation_history
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
| start | Intero | (facoltativo) Punto di inizio offset, predefiniti a 0 (i.e. comincia dall'ultimo) |
| limit | Intero | (facoltativo) Massima quantità di dettagli restituita, predefiniti a 10, il massimo è 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Il tuo Token API>&start=1&limit=2'
| Chiave | Valore |
|---|---|
| success |
|
| data | Contiene array di informazione di base sulle precedenti operazioni |
| data -> hash | Hash della separazione |
| data -> job_exists | Contiene array di informazione di base sulle precedenti operazioni |
| data -> credits | Quando crediti utilizzati per il processo, è nullo se la separazione non esiste |
| data -> time_left | Tempo approssimativo rimanente prima che il processo sia cancellato |
| data -> algorithm | Contieni informazioni base sul tipo di separazione utilizzata (si riferisce al tab "OTTIENI TIPI DI SEPARAZIONE" per informazioni sui parametri restituiti) |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Chiave API non valida |
Per abilitare l'uso premium per l'utente, devi fare una chiamata POST al seguente url:
https://mvsep.com/api/app/enable_premium
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Il tuo Token API>"'
| Chiave | Valore |
|---|---|
| success |
|
| message | Informa sullo stato dell'operazione |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Chiave API non valida |
Per disabilitare l'uso premium per l'utente, devi fare una chiamata POST al seguente url:
https://mvsep.com/api/app/disable_premium
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Il tuo Token API>"'
| Chiave | Valore |
|---|---|
| success |
|
| message | Informa sullo stato dell'operazione |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Chiave API non valida |
Per abilitare lunghi filenames per l'utente, devi fare una chiamata POST al seguente url:
https://mvsep.com/api/app/enable_long_filenames
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Il tuo Token API>"'
| Chiave | Valore |
|---|---|
| success |
|
| message | Informa sullo stato dell'operazione |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Chiave API non valida |
Per disabilitare lunghi filenames per l'utente, devi fare una chiamata POST al seguente url:
https://mvsep.com/api/app/disable_long_filenames
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Il tuo Token API>"'
| Chiave | Valore |
|---|---|
| success |
|
| message | Informa sullo stato dell'operazione |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Chiave API non valida |
Per ottenere più informazioni riguardo alle voci del database del verificatore di qualità in coda, eseguire una chiamata GET al seguente url:
https://mvsep.com/api/quality_checker/queue
| Campo | Tipo | Descrizione |
|---|---|---|
| start | Intero | (facoltativo) Punto di inizio offset, predefiniti a 0 (i.e. comincia dall'ultimo) |
| limit | Intero | (facoltativo) Massima quantità di dettagli restituita, predefiniti a 10, il massimo è 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Restituisce i dati come un array (vettore):
| Chiave | Valore |
|---|---|
| id | Numero identificativo della voce del database |
| dataset_type | Tipo del dataset scelto al momento dell'aggiunta del tipo di voce / leaderboard
|
| date | Data di creazione della voce del database |
| algo_name | Nome del tipo/algoritmo di separazione usato |
| main_text | Descrizione del tipo/algoritmo di separazione usato |
| proc | Stato dell'elaborazione
|
| proc_remote_date | Timestamp della data di elaborazione |
| msg | Restituisce "OK" se completato, altrimenti mostra un messaggio d'errore |
| metrics | Informazioni sulle metriche delle voci di database |
| sdr_* (wildcard) | SDR degli stem corrispondenti !!!NOTE: "degli stems" could better translate to "delle tracce" in a more intuitive way, meaning "of the tracks", but would lose its meaning in this context of audio separation |
| dataset_name | Nome del dataset |
Per ottenere più informazioni riguardo alle leaderboard del verificatore di qualità, eseguire una chiamata GET al seguente url:
https://mvsep.com/api/quality_checker/leaderboard
| Campo | Tipo | Descrizione |
|---|---|---|
| dataset_type | Stringa (testo) | Tipo del dataset, di default 0 se non specificato.
|
| start | Intero | (facoltativo) Punto di inizio offset, predefiniti a 0 (i.e. comincia dall'ultimo) |
| limit | Intero | (facoltativo) Massima quantità di dettagli restituita, predefiniti a 10, il massimo è 20. |
| algo_name_filter | Stringa (testo) | Filtra per il testo fornito i nomi del tipo/algoritmo di separazione |
| sort | Stringa (testo) | Ordina per SDR dello stem. Puoi ottenere una lista di valori ordinabili per il tipo di dataset fornito dalla chiave sortables. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Chiave | Valore |
|---|---|
| data | Contiene un array di voci di database del verificatore di qualità. Fare riferimento alla risposta di OTTIENI CODA nella sezione del verificatore di qualità per maggiori informazioni. |
| dataset_type | Chiave del tipo di dataset usato |
| sortables | Chiavi che possono essere usate per ordinare un certo stem per tipo di dataset usato, in ordine sequenziale. |
| sort | Chiave di ordinamento usata da dati ordinabili. |
Per creare una voce di database del verificatore di qualità, eseguire una chiamata POST al seguente url:
https://mvsep.com/api/quality_checker/add
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | (richiesto) La tua chiave API |
| zipfile | Binario | (richiesto) File ZIP da elaborare |
| algo_name | Stringa (testo) | (richiesto) Nome dell'algoritmo |
| main_text | Stringa (testo) | (richiesto) Descrizione dell'algoritmo |
| dataset_type | Stringa (testo) | Tipo di dataset. Di default è 0.
|
| password | Stringa (testo) | (richiesto) Password per eliminare l'algoritmo |
| ensemble | Intero | 0 - l'algoritmo non è un ensemble di modelli. 1 - l'algoritmo è un ensemble di modelli. |
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"'
| Chiave | Valore |
|---|---|
| success |
|
| data | Contiene informazioni riguardo alla voce |
| data -> id | ID della voce del database |
| data -> link | Link alla voce del database |
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Modulo invalido |
| 401 |
api_token sconosciuto o non valido. Questo errore appare se si utilizza una chiave API sconosciuta
|
Per ottenere informazioni sulla voce di database del verificatore di qualità in base all'ID, eseguire una chiamata GET al seguente url:
https://mvsep.com/api/quality_checker/entry
| Campo | Tipo | Descrizione |
|---|---|---|
| id | Intero | (richiesto) ID della voce del database |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Per eliminare voci di database del verificatore di qualità tramite il loro ID e password, eseguire una chiamata GET al seguente url:
https://mvsep.com/api/quality_checker/delete
| Campo | Tipo | Descrizione |
|---|---|---|
| id | Intero | (richiesto) ID della voce del database |
| password | Stringa (testo) | (richiesto) Password utilizzata per la voce di database |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Chiave | Valore |
|---|---|
| success |
|
| data->message | Mostra se la voce di database è stata eliminata |
turbo@mvsep.com