turbo@mvsep.com
L’API MVSEP FOURNIT UN ACCÈS PROGRAMMATIQUE POUR CRÉER UNE SÉPARATION, RENVOYER LES RÉSULTATS, OBTENIR DES INFORMATIONS SUR LE SITE ET CONTRÔLER LES CAPACITÉS DE L’UTILISATEUR.
Pour utiliser cette API vous avez besoin d'une clé d'API. Vous n’êtes pas connecté, veuillez vous connecter pour obtenir votre jeton API.
Exemples en Python: https://github.com/ZFTurbo/MVSep-API-Examples
Application non officielle MacVSep pour Mac OS: https://github.com/septcoco/macvsep
Vous pouvez configurer les webhooks ici: Page Webhooks
Spécification OpenAPI: mvsep-openapi-spec.json
Veuillez noter que les utilisateurs Premium peuvent demander un nombre illimité de tâches simultanées, tandis que les utilisateurs non Premium ne peuvent demander qu'une seule tâche simultanée.
Pour créer une séparation vous devez effectuer un appel POST à l'URL suivante :
https://mvsep.com/api/separation/create
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Votre clé API |
| audiofile | Binaire | Fichier audio à traiter. Ce paramètre n'est pas nécessaire si le paramètre url est défini ou si le modèle n'utilise pas d'entrée de fichier. Pour les modèles de correspondance, utilisez target_audiofile et reference_audiofile comme entrées à la place de audiofile. |
| url | Chaîne | Lien vers le fichier audio. Non requis si le paramètre audiofile est défini. |
| remote_type | Chaîne | (facultatif) Type de téléchargement du fichier audio. La valeur par défaut est direct. Ce paramètre n'est pas nécessaire si le paramètre audiofile est défini. Les types pris en charge sont direct (téléchargement direct), mega (MEGA), drive (Google Drive) et dropbox (Dropbox). |
| sep_type | Entier | (facultatif) Type de séparation, par défaut 11 (Demucs3 modèle B (chant, batterie, basse, autre)) |
| add_opt1 | Chaîne | (facultatif) Type de séparation, champ supplémentaire 1 |
| add_opt2 | Chaîne | (facultatif) Type de séparation, champ supplémentaire 2 |
| add_opt3 | Chaîne | (facultatif) Troisième champ supplémentaire de type de séparation |
| output_format | Entier | (facultatif) format de sortie, 0 par défaut (mp3 (320 kbps)) |
| is_demo | booléen | (facultatif) si la séparation result devrait être publié sur la page de démonstration, false par défaut |
| Nom | Valeur | Champs supplémentaires |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Clé: add_opt1 Nom: Output files Options:
Clé: add_opt2 Nom: Model Type Options:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Clé: add_opt1 Nom: Output files Options:
Clé: add_opt2 Nom: Model Type Options:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Clé: add_opt1 Nom: Output files Options:
Clé: add_opt2 Nom: Model Type Options:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Clé: add_opt1 Nom: Model type Options:
|
| BS Roformer (vocals, instrumental) | 40 | Clé: add_opt1 Nom: Vocal model type Options:
|
| BS PolarFormer (vocals, instrumental) | 123 | Clé: add_opt1 Nom: Overlap Options:
|
| MelBand Roformer (vocals, instrumental) | 48 | Clé: add_opt1 Nom: Vocal model type Options:
|
| MDX23C (vocals, instrumental) | 25 | Clé: add_opt1 Nom: Vocal model type Options:
|
| SCNet (vocals, instrumental) | 46 | Clé: add_opt1 Nom: Vocal model type Options:
|
| MDX B (vocals, instrumental) | 23 | Clé: add_opt1 Nom: Vocal model type Options:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Clé: add_opt1 Nom: Model Type Options:
Clé: add_opt2 Nom: Agressiveness Options:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Clé: add_opt1 Nom: Karaoke model type Options:
Clé: add_opt2 Nom: Extraction type Options:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Clé: add_opt1 Nom: Karaoke model type Options:
|
| MVSep Crowd removal (crowd, other) | 34 | Clé: add_opt1 Nom: Model type Options:
|
| Medley Vox (Multi-singer separation) | 53 | Clé: add_opt1 Nom: Model type Options:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Clé: add_opt1 Nom: Model Type Options:
|
| MVSep Male/Female separation | 57 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Choir (choir, other) | 112 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Drums (drums, other) | 44 | Clé: add_opt1 Nom: Drums model type Options:
Clé: add_opt2 Nom: How to extract Options:
Clé: add_opt3 Nom: Output files Options:
|
| MVSep Bass (bass, other) | 41 | Clé: add_opt1 Nom: Bass model type Options:
Clé: add_opt2 Nom: How to extract Options:
Clé: add_opt3 Nom: Output files Options:
|
| MVSep Synth (synth, other) | 88 | Clé: add_opt1 Nom: How to extract Options:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Clé: add_opt1 Nom: Model Type Options:
Clé: add_opt2 Nom: Preprocess Options:
|
| MVSep Piano (piano, other) | 29 | Clé: add_opt1 Nom: Piano model type Options:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Clé: add_opt1 Nom: Organ model type Options:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Clé: add_opt1 Nom: Guitar model type Options:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Clé: add_opt1 Nom: Model type Options:
|
| 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 | Clé: add_opt1 Nom: String model type Options:
Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Cello (cello, other) | 70 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Double Bass (double-bass, other) | 73 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Wind (wind, other) | 54 | Clé: add_opt1 Nom: Wind model type Options:
Clé: add_opt2 Nom: How to extract Options:
Clé: add_opt3 Nom: Output files Options:
|
| MVSep Brass (brass, other) | 107 | Clé: add_opt1 Nom: How to extract Options:
|
| MVSep Woodwind (woodwind, other) | 108 | Clé: add_opt1 Nom: How to extract Options:
|
| MVSep Saxophone (saxophone, other) | 61 | Clé: add_opt1 Nom: Model type Options:
|
| MVSep Flute (flute, other) | 67 | Clé: add_opt1 Nom: Flute model type Options:
Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Trumpet (trumpet, other) | 71 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Trombone (trombone, other) | 75 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Oboe (oboe, other) | 77 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Clarinet (clarinet, other) | 78 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep French Horn (french-horn, other) | 82 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Harmonica (harmonica, other) | 87 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Clé: add_opt2 Nom: How to extract Options:
|
| 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 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Celesta (celesta, other) | 110 | Clé: add_opt2 Nom: How to extract Options:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Clé: add_opt1 Nom: Model type Options:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Clé: add_opt1 Nom: Model Type Options:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: How to extract Options:
Clé: add_opt3 Nom: Output files Options:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: Cutoff (Hz) Options:
|
| Reverb Removal (noreverb) | 22 | Clé: add_opt1 Nom: Model Type Options:
Clé: add_opt2 Nom: Preprocess Options:
|
| DeNoise by aufr33 and gabox | 47 | Clé: add_opt1 Nom: Model type Options:
|
| AudioSR (Super Resolution) | 59 | Clé: add_opt1 Nom: Cutoff (Hz) Options:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Clé: add_opt1 Nom: Text prompt Options: Clé: add_opt2 Nom: Length (in seconds) Options:
|
| Whisper (extract text from audio) | 39 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: Transcription type Options:
|
| Parakeet (extract text from audio) | 64 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: Version Options:
|
| VibeVoice (Voice Cloning) | 103 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: Text prompt Options: Clé: add_opt3 Nom: Extract vocals first Options:
|
| VibeVoice (TTS) | 104 | Clé: add_opt1 Nom: Model type Options:
Clé: add_opt2 Nom: Text prompt Options: |
| Qwen3-TTS (Custom Voice) | 118 | Clé: add_opt1 Nom: Text prompt Options: Clé: add_opt2 Nom: Speaker Options:
Clé: add_opt3 Nom: Language Options:
Clé: add_opt4 Nom: Voice description Options: |
| Qwen3-TTS (Voice Design) | 119 | Clé: add_opt1 Nom: Text prompt Options: Clé: add_opt2 Nom: Voice description Options: Clé: add_opt3 Nom: Language Options:
|
| Qwen3-TTS (Voice Cloning) | 120 | Clé: add_opt1 Nom: Text prompt Options: Clé: add_opt2 Nom: Reference text in audio (optional) Options: Clé: add_opt3 Nom: Language Options:
Clé: add_opt4 Nom: Extract vocals first Options:
|
| Bark (Speech Gen) | 115 | Clé: add_opt1 Nom: Text prompt Options: Clé: add_opt2 Nom: Speaker Options:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Clé: add_opt1 Nom: Model Type Options:
|
| Aspiration (by Sucial) | 50 | Clé: add_opt1 Nom: Model type Options:
|
| Phantom Centre extraction | 55 | Clé: add_opt1 Nom: Model type Options:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Clé: add_opt1 Nom: How to use Options:
|
| Transkun (piano -> midi) | 113 | Clé: add_opt1 Nom: How to extract Options:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Clé: add_opt1 Nom: Lyrics Options: Clé: add_opt10 Nom: Topic Options:
Clé: add_opt2 Nom: Tags (optional) Options: Clé: add_opt3 Nom: Genre Options:
Clé: add_opt4 Nom: Timbre Options:
Clé: add_opt5 Nom: Gender Options:
Clé: add_opt6 Nom: Mood Options:
Clé: add_opt7 Nom: Instrument Options:
Clé: add_opt8 Nom: Scene Options:
Clé: add_opt9 Nom: Region Options:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Clé: add_opt1 Nom: Model type Options:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Clé: add_opt1 Nom: Vocal model type Options:
|
| Vit Large 23 (vocals, instrum) | 33 | Clé: add_opt1 Nom: Model type Options:
|
| UVRv5 Demucs (vocals, music) | 17 | Clé: add_opt1 Nom: Model Type Options:
|
| 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 | Clé: add_opt1 Nom: Model type Options:
|
| UnMix | 3 | Clé: add_opt1 Nom: Model type Options:
|
| Zero Shot (Query Based) (Low quality) | 14 | Clé: add_opt1 Nom: Model Type Options:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Clé: add_opt1 Nom: Model type Options:
|
| Nom | Valeur |
|---|---|
| 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="<Votre jeton API>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Clé | Valeur |
|---|---|
| success |
|
| data | Contient des informations supplémentaires en fonction de la clé success |
| data -> link | Affiche le lien vers l’URL « GET RESULT » de la tâche créée (affiché uniquement lorsque success est true) |
| data -> hash | Affiche le hachage de la tâche créée (affiché uniquement lorsque success est true) |
| data -> message | Affiche la description d’une erreur (uniquement lorsque success est false) |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Certains paramètres sont manquants ou invalides. Cette erreur apparaît lorsqu'on ne transmette pas tous les paramètres obligatoires ou lorsqu'on transmette des paramètres non valides. |
| 401 |
api_token est inconnu ou non valide. Cette erreur se produit si l'on utilise une clé API inconnue
|
Pour obtenir le résultat de la séparation, vous devez effectuer un appel GET à l'url suivante :
https://mvsep.com/api/separation/get
| Champ | Type | Description |
|---|---|---|
| hash | Chaîne | Ыomme de hachage de séparation |
| mirror | Entier | (facultatif) Utilise un autre miroir s'il est défini sur 1, la valeur par défaut est 0. Nécessite api_token et 1 crédit s'il est défini sur 1. |
| api_token | Chaîne | (facultatif) Clé API de l'utilisateur. Obligatoire si le paramètre miroir est défini sur 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Clé | Valeur |
|---|---|
| success |
|
| status |
|
| data | Contient des informations supplémentaires en fonction de la touche status |
| data -> queue_count | Affiche le nombre de tâches non traitées dans la priorité de l'utilisateur (affiché uniquement lorsque le statut est en attente ou en cours de distribution) |
| data -> current_order | Affiche l'ordre des tâches de l'utilisateur (affiché uniquement lorsque le statut est en attente ou en cours de distribution) |
| data -> message | Affiche la description de l'état (affiché sur tous les états, affiche la raison de l'erreur à la place lorsque l'état est échoué) |
| data -> algorithm | Affiche l’algorithme utilisé sur le travail (affiché uniquement lorsque status est done) |
| data -> algorithm_description | Affiche les détails de l’algorithme utilisé sur le travail (uniquement lorsque status est done) |
| data -> output_format | Affiche le format de sortie de la tâche (affiché uniquement lorsque status est done) |
| data -> tags | Affiche les balises méta audio (uniquement affichées lorsque status est done) |
| data -> input_file | Affiche les détails du téléchargement de l’audio d’entrée (uniquement lorsque status est done) |
| data -> files | Affiche les détails de téléchargement des audios de sortie (uniquement lorsque status est done) |
| data -> date | Affiche la date de traitement de la tâche (affichée uniquement lorsque status est done) |
| data -> finished_chunks | Affiche le nombre de pièces terminées d’un travail volumineux (uniquement lorsque status est distributing) |
| data -> all_chunks | Affiche le nombre de toutes les parties d’une tâche volumineuse (uniquement lorsque status est distributing) |
Pour obtenir le résultat d'une tâche à distance, vous devez effectuer une requête GET vers l'URL suivante :
https://mvsep.com/api/separation/get-remote
| Champ | Type | Description |
|---|---|---|
| hash | Chaîne | Ыomme de hachage de séparation |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Clé | Valeur |
|---|---|
| success |
|
| status |
|
| data | Contient des informations supplémentaires en fonction de la touche status |
| data -> queue_count | Affiche le nombre de tâches non traitées dans la file d'attente prioritaire de l'utilisateur (affiché uniquement lorsque status est waiting). |
| data -> current_order | Affiche l'ordre de la tâche de l'utilisateur (affiché uniquement lorsque status est waiting). |
| data -> message | Affiche la description de l'état (uniquement lorsque status est failed). |
| data -> link | Affiche le lien vers l'URL « GET RESULT » de la tâche créée (affiché uniquement lorsque status est done). |
| data -> hash | Hachage de la séparation (affiché uniquement lorsque status est done). |
Pour annuler la séparation et obtenir le remboursement des crédits utilisés (si la séparation n'est pas encore en cours de traitement), vous devez effectuer un appel POST vers l'URL suivante :
https://mvsep.com/api/separation/cancel
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
| hash | Chaîne | Ыomme de hachage de séparation |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Votre jeton API>"' --form 'hash="<hash>"'
| Clé | Valeur |
|---|---|
| success |
|
Pour obtenir les données détaillées sur les types de séparation, vous devez effectuer un appel GET à l’URL suivante :
https://mvsep.com/api/app/algorithms
| Champ | Type | Description |
|---|---|---|
| scopes | Chaîne | Faut-il inclure les modèles qui utilisent différents types de données d'entrée ?
single_upload. Pour obtenir tous les modèles, définissez scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Renvoie les données sous forme de tableau:
| Clé | Valeur |
|---|---|
| render_id | Valeur du type de séparation (ID) |
| name | Le nom du type de séparation |
| algorithm_group_id | Le groupe auquel appartient le type de séparation : |
| algorithm_group | Contient des informations sur le groupe d'algorithmes auquel appartient l'algorithme. |
| algorithm_group -> name | Nom du groupe d'algorithmes. |
| audio_widget |
Le type de widget audio à utiliser pour l'algorithme. Cela permet de déterminer comment afficher le lecteur audio de l'algorithme dans l'interface utilisateur. Les valeurs possibles sont :
|
| orientation |
À qui s'adresse ce type de séparation :
|
| order_id | L'ordre du type de séparation |
| price_coefficient |
Utilisé pour calculer combien de crédits le travail prend à l'utilisateur premium. Utilise cette formule : floor(<durée du fichier audio en secondes> * price_coefficient / 60)?:1
|
| usage | Affiche le nombre mensuel d'utilisations par type de séparation |
| rating | Affiche les taux d'utilisation mensuels par type de séparation sous forme de tableau :
|
| algorithm_fields | Contient des informations sur les champs supplémentaires du type de séparation |
| algorithm_fields -> name |
Affiche le champ supplémentaire du type de séparation :
|
| algorithm_fields -> text | Nom d'affichage du champ supplémentaire du type de séparation. |
| algorithm_fields -> options | Chaînes clé-valeur codées JSON de champs supplémentaires |
| algorithm_fields -> default_key | Valeur par défaut du champ supplémentaire. Une des clés de <code>algorithm_fields -> options</code> |
| algorithm_descriptions | Contient des informations sur les descriptions du type de séparation |
| algorithm_descriptions -> short_description | Petite description du type de séparation qui n'utilise pas HTML. |
| algorithm_descriptions -> long_description | Description détaillée du type de séparation qui utilise HTML. |
| algorithm_descriptions -> lang | Code de langue spécifié de la description. |
Pour obtenir des informations sur les dernières nouvelles concernant MVSEP, vous devez effectuer un appel GET à l’URL suivante :
https://mvsep.com/api/app/news
| Champ | Type | Description |
|---|---|---|
| lang | Chaîne | (facultatif) Code de langue à 2 lettres (en, ru) |
| start | Entier | (facultatif) Décalage du point de départ, par défaut 0 (c'est-à-dire démarrer à partir du plus récent) |
| limit | Entier | (facultatif) Quantité maximale de résultats renvoyés, la valeur par défaut est 10, le maximum est 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Renvoie les données sous forme de tableau:
| Clé | Valeur |
|---|---|
| title | Titre de la nouvelle |
| lang | Titre de la nouvelle |
| text | Description complète de l'actualité |
| created_at | Date de la nouvelle |
Pour obtenir des informations sur la file d'attente du site, vous devez effectuer une requête GET vers l'URL suivante :
https://mvsep.com/api/app/queue
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | (facultatif) Clé API de l'utilisateur |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Clé | Valeur |
|---|---|
| queue |
Contient un tableau des files d'attente actuelles pour les différents forfaits :
|
| plan |
Contient la file d'attente actuelle pour le forfait en cours (ajoutez api_token à la requête pour les forfaits « Registered » ou « Premium ») :
|
Pour obtenir des informations sur les séparations de démonstration, vous devez effectuer un appel GET à l'URL suivante :
https://mvsep.com/api/app/demo
| Champ | Type | Description |
|---|---|---|
| start | Entier | (facultatif) Décalage du point de départ, par défaut 0 (c'est-à-dire démarrer à partir du plus récent) |
| limit | Entier | (facultatif) Quantité maximale de résultats renvoyés, la valeur par défaut est 10, le maximum est 20. |
| algorithm_id | Entier | Identifiant facultatif du type de séparation. Utilisez-le pour renvoyer uniquement les séparations de démonstration créées par un algorithme donné. Les valeurs correspondent à render_id de l'interface GET SEPARATION TYPES. |
| options[FIELD] | Chaîne / Entier | Filtre facultatif pour les valeurs des options d'algorithme. Remplacez FIELD par une clé de champ supplémentaire issue de algorithm_fields -> name dans la réponse GET SEPARATION TYPES, puis transmettez l'une des clés options de ce champ comme valeur. Exemple : options[vocals]=1. |
| additional_options | Chaîne | Le format brut facultatif inclut un filtre sur les données d'options des tâches enregistrées. Pour les nouvelles intégrations, privilégiez options[FIELD], car cette syntaxe est explicite et plus facile à utiliser. |
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'
Pour créer des filtres d'options, commencez par appeler https://mvsep.com/api/app/algorithms et examinez la liste algorithm_fields de chaque algorithme. Utilisez le champ name à l'intérieur de options[FIELD] et attribuez-lui comme valeur l'une des clés d'option JSON.
Renvoie les données sous forme de tableau:
| Clé | Valeur |
|---|---|
| hash | Ыomme de hachage de séparation |
| date | Date de séparation |
| input_audio | URL d'entrée audio |
| size | Taille audio d'entrée |
| algorithm | Contient des informations de base sur le type de séparation utilisé (reportez-vous à l'onglet OBTENIR LES TYPES DE SÉPARATION pour plus d'informations sur les paramètres renvoyés) |
Pour authentifier l'utilisateur et obtenir sa clé API, vous devez effectuer un appel POST à l'URL suivante :
https://mvsep.com/api/app/login
| Champ | Type | Description |
|---|---|---|
| Chaîne | Email de l'utilisateur | |
| password | Chaîne | Mot de passe de l'utilisateur |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Email de l'utilisateur>"' --form 'password="<Mot de passe de l'utilisateur>"'
| Clé | Valeur |
|---|---|
| success |
|
| data | Contient des informations lorsque les informations d'identification sont valides |
| data -> name | Nom de l'utilisateur |
| data -> email | Email de l'utilisateur |
| data -> api_token | La clé API de l'utilisateur. Assurez-vous de la stocker dans un espace de stockage sécurisé et de l'utiliser pour les opérations ultérieures. |
| data -> premium_minutes | Crédits laissés à l'utilisateur |
| data -> premium_enabled |
Si l'utilisateur a autorisé la dépense de crédits.
|
| data -> long_filenames_enabled |
Si l'utilisateur souhaite des informations supplémentaires dans les noms de fichiers :
|
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Informations d'identification incorrectes spécifiées |
Pour inscrire l’utilisateur sur le site MVSEP, vous devez effectuer un appel POST à l’url suivante :
https://mvsep.com/api/app/register
| Champ | Type | Description |
|---|---|---|
| name | Chaîne | Nom de l'utilisateur |
| Chaîne | Email de l'utilisateur | |
| password | Chaîne | Mot de passe de l'utilisateur |
| password_confirmation | Chaîne | Répéter le mot de passe de l'utilisateur |
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"'
| Clé | Valeur |
|---|---|
| success |
|
| message | Se produit lorsque le formulaire n'est pas valide |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Le formulaire n'est pas valide |
Pour obtenir des informations sur l'utilisateur, vous devez effectuer un appel GET à l'URL suivante :
https://mvsep.com/api/app/user
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Votre jeton API>'
| Clé | Valeur |
|---|---|
| success |
|
| data | Contient des informations lorsque les informations d'identification sont valides |
| data -> name | Nom de l'utilisateur |
| data -> email | Email de l'utilisateur |
| data -> api_token | La clé API de l'utilisateur. Assurez-vous de la stocker dans un espace de stockage sécurisé et de l'utiliser pour les opérations ultérieures. |
| data -> premium_minutes | Crédits laissés à l'utilisateur |
| data -> premium_enabled |
Si l'utilisateur a autorisé la dépense de crédits.
|
| data -> long_filenames_enabled |
Si l'utilisateur souhaite des informations supplémentaires dans les noms de fichiers :
|
| data -> current_queue | Affiche les séparations en cours pour l'utilisateur |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Clé API non valide |
Pour obtenir des informations de base sur l'historique de séparation de l'utilisateur, vous devez effectuer un appel GET à l'URL suivante :
https://mvsep.com/api/app/separation_history
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
| start | Entier | (facultatif) Décalage du point de départ, par défaut 0 (c'est-à-dire démarrer à partir du plus récent) |
| limit | Entier | (facultatif) Quantité maximale de résultats renvoyés, la valeur par défaut est 10, le maximum est 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Votre jeton API>&start=1&limit=2'
| Clé | Valeur |
|---|---|
| success |
|
| data | Contient un tableau d'informations de base sur les séparations précédentes |
| data -> hash | Ыomme de hachage de séparation |
| data -> job_exists | Contient un tableau d'informations de base sur les séparations précédentes |
| data -> credits | Combien de crédits ont été utilisés pour le travail, nul si la séparation n'existe pas |
| data -> time_left | Temps approximatif restant avant la suppression du travail |
| data -> algorithm | Contient des informations de base sur le type de séparation utilisé (reportez-vous à l'onglet OBTENIR LES TYPES DE SÉPARATION pour plus d'informations sur les paramètres renvoyés) |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Clé API non valide |
Pour activer l'utilisation premium pour l'utilisateur, vous devez effectuer un appel POST vers l'URL suivante :
https://mvsep.com/api/app/enable_premium
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Votre jeton API>"'
| Clé | Valeur |
|---|---|
| success |
|
| message | Informe sur l'état de l'opération |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Clé API non valide |
Pour désactiver l'utilisation premium pour l'utilisateur, vous devez effectuer un appel POST vers l'URL suivante :
https://mvsep.com/api/app/disable_premium
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Votre jeton API>"'
| Clé | Valeur |
|---|---|
| success |
|
| message | Informe sur l'état de l'opération |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Clé API non valide |
Pour activer les noms de fichiers longs pour l'utilisateur, vous devez effectuer un appel POST vers l'URL suivante :
https://mvsep.com/api/app/enable_long_filenames
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Votre jeton API>"'
| Clé | Valeur |
|---|---|
| success |
|
| message | Informe sur l'état de l'opération |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Clé API non valide |
Pour désactiver les noms de fichiers longs pour l'utilisateur, vous devez effectuer un appel POST vers l'URL suivante :
https://mvsep.com/api/app/disable_long_filenames
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | Clé API de l'utilisateur |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Votre jeton API>"'
| Clé | Valeur |
|---|---|
| success |
|
| message | Informe sur l'état de l'opération |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Clé API non valide |
Pour obtenir des informations sur les entrées de la file d'attente de Quality Checker, vous devez effectuer une requête GET vers l'URL suivante :
https://mvsep.com/api/quality_checker/queue
| Champ | Type | Description |
|---|---|---|
| start | Entier | (facultatif) Décalage du point de départ, par défaut 0 (c'est-à-dire démarrer à partir du plus récent) |
| limit | Entier | (facultatif) Quantité maximale de résultats renvoyés, la valeur par défaut est 10, le maximum est 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Renvoie les données sous forme de tableau:
| Clé | Valeur |
|---|---|
| id | Numéro d'identification de l'entrée |
| dataset_type | Type de jeu de données sélectionné lors de l'ajout de l'entrée / type de classement
|
| date | Date de création de l'entrée |
| algo_name | Nom du type de séparation/de l'algorithme utilisé |
| main_text | Description du type/algorithme de séparation utilisé |
| proc | État d'avancement du traitement
|
| proc_remote_date | Horodatage de la date de traitement |
| msg | Renvoie « OK » en cas de réussite, sinon affiche un message d'erreur |
| metrics | Informations sur les indicateurs d'entrée |
| sdr_* (wildcard) | SDR des tiges correspondantes |
| dataset_name | Nom de l'ensemble de données |
Pour obtenir des informations sur les classements de Quality Checker, vous devez effectuer une requête GET vers l'URL suivante :
https://mvsep.com/api/quality_checker/leaderboard
| Champ | Type | Description |
|---|---|---|
| dataset_type | Chaîne | Type de jeu de données ; la valeur par défaut est 0 si elle n'est pas spécifiée.
|
| start | Entier | (facultatif) Décalage du point de départ, par défaut 0 (c'est-à-dire démarrer à partir du plus récent) |
| limit | Entier | (facultatif) Quantité maximale de résultats renvoyés, la valeur par défaut est 10, le maximum est 20. |
| algo_name_filter | Chaîne | Filtre les noms de types de séparation ou d'algorithmes en fonction du texte saisi |
| sort | Chaîne | Trier en fonction du SDR attribué à la tige. Vous pouvez obtenir la liste des valeurs triables pour un type de jeu de données donné à partir de la clé sortables dans la réponse. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Clé | Valeur |
|---|---|
| data | Contient un tableau d'entrées du Quality Checker. Pour plus d'informations, consultez la section « Réponse GET QUEUE du Quality Checker ». |
| dataset_type | Clé de type d'ensemble de données utilisé |
| sortables | Clés permettant de trier les types de jeux de données utilisés par radical donné, dans l'ordre séquentiel. |
| sort | Clé de tri utilisée à partir de `sortable`. |
Pour créer une entrée dans Quality Checker, vous devez effectuer un appel POST vers l'URL suivante :
https://mvsep.com/api/quality_checker/add
| Champ | Type | Description |
|---|---|---|
| api_token | Chaîne | (obligatoire) Votre clé API |
| zipfile | Binaire | (obligatoire) Fichier ZIP à traiter |
| algo_name | Chaîne | (obligatoire) Nom de l'algorithme |
| main_text | Chaîne | (obligatoire) Description de l'algorithme |
| dataset_type | Chaîne | Type de jeu de données. La valeur par défaut est 0.
|
| password | Chaîne | (obligatoire) Algorithme de suppression du mot de passe |
| ensemble | Entier | 0 - L'algorithme n'est pas un ensemble. 1 - L'algorithme est un 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"'
| Clé | Valeur |
|---|---|
| success |
|
| data | Contient des informations sur l'entrée |
| data -> id | Identifiant de l'entrée |
| data -> link | Lien vers l'article |
MVSEP API utilise les codes d'erreur suivants :
| Code d'erreur | Signification |
|---|---|
| 400 | Le formulaire n'est pas valide |
| 401 |
api_token est inconnu ou non valide. Cette erreur se produit si l'on utilise une clé API inconnue
|
Pour obtenir des informations sur une entrée de la file d'attente de Quality Checker à l'aide de son identifiant, vous devez effectuer une requête GET vers l'URL suivante :
https://mvsep.com/api/quality_checker/entry
| Champ | Type | Description |
|---|---|---|
| id | Entier | (obligatoire) Identifiant de l'entrée |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Pour supprimer une entrée de la file d'attente de Quality Checker à l'aide de son identifiant et de son mot de passe, vous devez effectuer une requête GET vers l'URL suivante :
https://mvsep.com/api/quality_checker/delete
| Champ | Type | Description |
|---|---|---|
| id | Entier | (obligatoire) Identifiant de l'entrée |
| password | Chaîne | (obligatoire) Mot de passe utilisé pour la connexion |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Clé | Valeur |
|---|---|
| success |
|
| data->message | Indique si l'entrée a été supprimée |
turbo@mvsep.com