L'API di MVSEP fornisce un accesso programmatico per creare una separazione, restituire i risultati, ottenere informazioni sul sito e gestire le impostazioni dell'utente.
Per utilizzare questa API, hai bisogno di una chiave API. Non sei loggato, accedi per ottenere il tuo token API.
Nota: gli utenti Premium possono richiedere un numero illimitato di processi contemporanei, mentre gli utenti non Premium possono richiederne solo 1 alla volta.
MVSEP utilizza endpoint API regionali. Tutte le regioni condividono un solo database degli account, quindi lo stesso account, la stessa chiave API e gli stessi hash dei processi funzionano ovunque:
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://sg.mvsep.com/apihttps://hk.mvsep.com/api — deprecato, vedi sottoLa regione di Hong Kong è deprecata. Singapore la sostituisce e il dominio apex indirizza già lì il traffico asiatico anziché a Hong Kong. Le integrazioni esistenti non si romperanno. hk.mvsep.com continua a funzionare anche oggi e, quando la macchina di Hong Kong verrà dismessa, il nome host continuerà a rispondere — servito da Singapore, con i file archiviati trasferiti — quindi gli URL di download che già possiedi resteranno validi. Non è fissata alcuna data di chiusura. Le nuove integrazioni dovrebbero chiamare https://mvsep.com/api, oppure https://sg.mvsep.com/api se hai un motivo per fissare una regione specifica; le chiamate a hk.mvsep.com verranno servite da Singapore, quindi fissarlo non ti lega più a Hong Kong.
Le richieste a https://mvsep.com/api vengono instradate su base geografica verso una regione vicina: chi chiama dall'Europa viene indirizzato a de, chi chiama dall'Asia a sg e tutti gli altri a de2. Per la maggior parte delle integrazioni il dominio apex è la scelta giusta: segue da solo l'instradamento corrente, così non ti ritrovi mai a puntare a una regione che è stata dismessa. Fissa un host regionale solo quando ti serve davvero e preparati a rivedere quella scelta: gli endpoint regionali possono essere deprecati, come lo è ora Hong Kong.
Ogni separazione viene elaborata e archiviata nella regione in cui è stata creata, e gli URL di download restituiti nelle risposte puntano sempre all'host di quella regione. Questi URL sono assoluti, quindi non devi fissare tu un host per tenere insieme il ciclo di vita di un processo: segui gli URL che ti fornisce l'API e creazione, interrogazione e download si allineeranno da soli.
Puoi interrogare lo stato di qualsiasi processo da qualsiasi regione (il database è condiviso), ma i file di output vengono sempre serviti dalla regione a cui il processo appartiene.
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 20. È l'ID del tipo di separazione: consulta la sezione OTTIENI TIPI DI SEPARAZIONE per maggiori informazioni. Viene ignorato quando è specificato <code class="higlighted">preset_id</code>. |
| preset_id | Intero | (facoltativo) Applica al file uno dei tuoi preset salvati invece di un singolo algoritmo. Specifica sep_type oppure preset_id — un preset definisce i propri algoritmi, opzioni e formati di output, quindi sep_type, i campi add_opt e output_format vengono tutti ignorati insieme ad esso. La risposta restituisce un hash da interrogare esattamente come una separazione; il risultato contiene una voce per ogni nodo Output del preset. Consulta la tabella dei preset qui sotto per gli ID. |
| 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) | (opzionale) Terzo campo aggiuntivo del tipo di separazione |
| output_format | Intero | (opzionale) formato di output, predefinito 0 (mp3 (320kbps)) |
| is_demo | Booleano | (opzionale) indica se la separazione deve essere pubblicata nella pagina demo, predefinito false |
| webhook_url | Stringa (testo) | (opzionale) Un URL a cui invieremo tramite POST il risultato completato, così non dovrai continuare a eseguire il polling. Il corpo della richiesta è lo stesso JSON di GET SEPARATION. Questo sostituisce l'indirizzo impostato a livello di account nella pagina dei webhook, utile quando diversi utenti condividono uno stesso token API. Deve essere un indirizzo http o https pubblicamente raggiungibile. |
| 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:
Chiave: add_opt2 Nome: Overlap Opzioni:
Chiave: add_opt3 Nome: Set of stems Opzioni:
|
| BS PolarFormer (vocals, instrumental) | 123 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Overlap Opzioni:
|
| MelBand Roformer (vocals, instrumental) | 48 | Chiave: add_opt1 Nome: Vocal model type Opzioni:
Chiave: add_opt2 Nome: Overlap 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:
Chiave: add_opt2 Nome: Processing Mode 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 Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| MVSep Clavinet | 135 | |
| MVSep Mellotron | 136 | |
| 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 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 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Celesta (celesta, other) | 110 | Chiave: add_opt2 Nome: How to extract Opzioni:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| 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 1.0 | 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 | |
| Upmixing by Jazzpear | 137 | |
| DeEffect vocals by gilliaan | 138 | |
| 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:
|
| UniverSR (Super Resolution) | 139 | Chiave: add_opt1 Nome: Model type Opzioni:
Chiave: add_opt2 Nome: Input sample rate Opzioni:
Chiave: add_opt3 Nome: Guidance scale 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 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Chiave: add_opt1 Nome: How to extract Opzioni:
|
| 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:
|
I preset sono privati dell'account che li ha creati, quindi questa tabella mostra i tuoi preset oltre a quelli selezionati. Puoi crearli e modificarli nell'editor dei preset.
Non hai ancora nessun preset. Accedi e creane uno nell'editor dei preset: il suo ID apparirà qui.
| 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
Lo stesso endpoint restituisce anche le esecuzioni dei preset: interroga l'hash ottenuto da preset_id esattamente come faresti con una separazione. La struttura della risposta è identica — status passa da waiting e processing a done — e data.type è preset_run. Ogni voce di data.files corrisponde a un nodo Output del preset, denominato in base alla propria etichetta anziché a uno stem. Un'esecuzione è visibile solo all'account che l'ha creata.
| 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 ancora elaborati nella coda di priorità 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 (presente in tutti gli stati; quando status è failed mostra invece il motivo dell'errore) |
| 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 di 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 audio di output (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) |
Elimina una delle tue separazioni: un processo normale oppure l'esecuzione di un preset. Vengono rimossi il record e i relativi file di output. Una separazione ancora in elaborazione deve prima essere annullata. L'eliminazione non rimborsa i crediti, perché l'elaborazione è già stata eseguita.
POST https://mvsep.com/api/separation/delete
Puoi interrogare lo stato di qualsiasi processo da qualsiasi regione (il database è condiviso), ma i file di output vengono sempre serviti dalla regione a cui il processo appartiene.
| Campo | Tipo | Descrizione |
|---|---|---|
| hash | Stringa (testo) | Hash della separazione |
| api_token | Stringa (testo) | Chiave API dell'utente. Obbligatoria. |
curl --location --request POST 'https://mvsep.com/api/separation/delete'
--form 'api_token="<Il tuo Token API>"'
--form 'hash="20230327071601-0e3e5c6c85-13-dimensions.mp3"'
| Chiave | Valore |
|---|---|
| success |
|
| data -> message | Mostra la descrizione dello stato (presente in tutti gli stati; quando status è failed mostra invece il motivo dell'errore) |
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 | Nome visualizzato del campo aggiuntivo del tipo di separazione. |
| algorithm_fields -> options | Coppie chiave-valore codificate in JSON del campo aggiuntivo |
| 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) Numero massimo di risultati restituiti, predefinito 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)
|
La posizione dei tuoi processi nella coda. Usa questo endpoint invece di tirare a indovinare sull'attesa: restituisce ciò che è in coda per il tuo account, ciò che è già in esecuzione, quanti processi precedono il tuo processo in coda più vecchio e una stima prudenziale in secondi. È abbastanza leggero da poter essere interrogato con la stessa frequenza dell'endpoint di stato della separazione.
https://mvsep.com/api/app/queue/summary
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | (richiesto) Chiave API dell'utente |
curl --location --request GET 'https://mvsep.com/api/app/queue/summary?api_token=<Il tuo Token API>'
| Chiave | Valore |
|---|---|
| queued | I tuoi processi in attesa di un worker. |
| processing | I tuoi processi attualmente su una GPU. |
| ahead | Processi che precedono il tuo processo in coda più vecchio, conteggiati all'interno del tuo livello. |
| estimated_wait_seconds | Secondi stimati prima che il tuo processo in coda più vecchio venga avviato. Volutamente prudenziale. null quando non è misurabile: non hai nulla in coda, oppure l'attività recente è troppo scarsa per ricavarne una velocità. Considera null come «sconosciuto», mai come «adesso». |
| throughput_per_min | Processi presi in carico al minuto su tutto il parco GPU, misurati su una finestra recente anziché configurati. |
Per le regole di pianificazione dietro questi numeri — ordine dei livelli, come gli account Premium si dividono la capacità e cosa determina l'attesa — vedi Come funziona la coda.
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) Numero massimo di risultati restituiti, predefinito 10, il massimo è 20. |
| algorithm_id | Intero | ID facoltativo del tipo di separazione. Usalo per ottenere solo le separazioni demo create da un determinato algoritmo. I valori corrispondono a render_id dell'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) | Filtro facoltativo di tipo "contiene" applicato ai dati grezzi delle opzioni salvate del processo. Per le nuove integrazioni è preferibile options[FIELD], perché è esplicito e più facile da comporre. |
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 | Contiene informazioni di base sul tipo di separazione utilizzato (fai riferimento alla scheda "OTTIENI TIPI DI SEPARAZIONE" per informazioni sui parametri restituiti) |
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 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 archivio sicuro e di usarla 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 nei nomi dei file:
|
L'API MVSEP utilizza i seguenti codici di errore:
| Codice di errore | Significato |
|---|---|
| 400 | Credenziali inserite non corrette |
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 archivio sicuro e di usarla 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 nei 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 delle separazioni 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) Numero massimo di risultati restituiti, predefinito 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 un array di informazioni di base sulle separazioni precedenti |
| data -> hash | Hash della separazione |
| data -> job_exists | Contiene un array di informazioni di base sulle separazioni precedenti |
| data -> credits | Quanti crediti sono stati usati per il processo, null se la separazione non esiste |
| data -> time_left | Tempo approssimativo rimanente prima che il processo sia cancellato |
| data -> algorithm | Contiene informazioni di base sul tipo di separazione utilizzato (fai riferimento alla scheda "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 ottenere gli acquisti di crediti di questo account, dal più recente al più vecchio, effettua una chiamata GET al seguente URL:
https://mvsep.com/api/purchases
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
| limit | Intero | (facoltativo) Numero di acquisti da restituire, da 1 a 100. Il valore predefinito è 20. |
| offset | Intero | (facoltativo) Numero di acquisti da saltare durante la navigazione nella cronologia. Il valore predefinito è 0. |
| status | Stringa (testo) | (facoltativo) Restituisce solo gli acquisti in questo stato, ad esempio succeeded. Omettilo (o passa all) per ottenere tutto ciò che viene mostrato nella pagina della cronologia del sito web, inclusi i checkout avviati ma mai completati — questi hanno lo stato unpaid e non hanno generato alcun credito. |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<Il tuo Token API>&status=succeeded&limit=20'
| Chiave | Valore |
|---|---|
| purchases | Una voce per ogni acquisto: payment_id, status, amount, credits concessi, payment_method (stripe, paddle, yookassa, google_play o app_store) e date. |
| total | Quanti acquisti corrispondono in totale, ignorando limit e offset: usalo per impaginare i risultati. |
| credits | Il saldo crediti attuale dell'account. |
MVSEP ti invia un'email quando il tuo saldo crediti scende alla soglia che hai scelto, così un'integrazione in esecuzione non si interrompe all'improvviso. GET restituisce l'impostazione corrente; POST la modifica. L'avviso viene inviato una sola volta e non si ripete finché il saldo non risale sopra la soglia.
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| Campo | Tipo | Descrizione |
|---|---|---|
| api_token | Stringa (testo) | Chiave API dell'utente |
| credit_threshold | Intero | (Solo POST, obbligatorio) Invia l'avviso quando il saldo raggiunge o scende al di sotto di questo numero di crediti. 0 disattiva l'avviso. Modificando la soglia, viene riattivato un avviso già inviato. |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<Il tuo Token API>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<Il tuo Token API>' --form 'credit_threshold=100'
| Chiave | Valore |
|---|---|
| credit_threshold | La soglia attualmente fissata, in crediti. |
| enabled | <code>true</code> quando viene impostata una soglia superiore a zero, altrimenti <code>false</code>. |
| credits | Il saldo crediti attuale dell'account. |
| notified | <code>true</code> una volta inviato l'avviso relativo al calo attuale; si disattiva automaticamente quando il saldo torna al di sopra della soglia. |
| L'indirizzo a cui viene inviato l'avviso. |
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 i nomi file lunghi 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 i nomi file lunghi 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) Numero massimo di risultati restituiti, predefinito 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 di dataset scelto al momento dell'aggiunta della voce / tipo di classifica
|
| 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 |
| 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) Numero massimo di risultati restituiti, predefinito 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 in base all'SDR dello stem indicato. Puoi ottenere l'elenco dei valori ordinabili per il tipo di dataset scelto dalla chiave sortables nella risposta. |
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 |
Librerie, app e integrazioni realizzate sulla base di questa API. Salvo dove diversamente indicato, si tratta di progetti della comunità: non sono gestiti da MVSEP e non possiamo garantirne l'affidabilità.
Questa versione è distribuita su PyPI con il nome mvsep-cli e indica MVSEP come autore, il che potrebbe farla sembrare ufficiale. È pubblicata e gestita da una terza parte, non da MVSEP, e il repository del codice sorgente a cui rimanda non esiste. Richiede il tuo token API, quindi ti consigliamo di leggere il codice sorgente prima di incollare un token al suo interno.
mvsep-cli: pypi.org/project/mvsep-cli
