turbo@mvsep.com
La API de MVSEP proporciona acceso programático para crear una separación, devolver los resultados, obtener información del sitio y controlar las capacidades del usuario.
Para utilizar esta API, necesita una clave API. No ha iniciado sesión, inicie sesión para obtener su clave API <code>(api_token)<code>.
Ejemplos en Python: https://github.com/ZFTurbo/MVSep-API-Examples
Aplicación no oficial MacVSep para Mac OS: https://github.com/septcoco/macvsep
Aquí se pueden configurar los webhooks: Página de webhooks
Especificación OpenAPI: mvsep-openapi-spec.json
Ten en cuenta que los usuarios Premium pueden solicitar un número ilimitado de trabajos simultáneos, mientras que los usuarios que no son Premium solo pueden solicitar 1 trabajo simultáneo.
Para crear la separación es necesario hacer una petición POST a la siguiente URL:
https://mvsep.com/api/separation/create
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Tu clave API |
| audiofile | Binario | Archivo de audio que se va a procesar. No es necesario si se ha establecido el parámetro url o si el modelo no utiliza entrada de archivo. Para los modelos de emparejamiento, utilice target_audiofile y reference_audiofile como entrada en lugar de audiofile. |
| url | Cadena | Enlace al archivo de audio. No es necesario si se ha establecido el parámetro audiofile. |
| remote_type | Cadena | (opcional) Tipo de acceso remoto del archivo de audio. El valor predeterminado es direct. No es necesario si se ha establecido el parámetro audiofile. Los tipos admitidos son direct (descarga directa), mega (MEGA), drive (Google Drive) y dropbox (Dropbox). |
| sep_type | Entero | (opcional) Tipo de separación, por defecto 11 [Demucs3 Modelo B (voz, batería, bajo, otros)] |
| add_opt1 | Cadena | (opcional) Tipo de separación, primer campo adicional |
| add_opt2 | Cadena | (opcional) Tipo de separación, segundo campo adicional |
| add_opt3 | Cadena | (opcional) Tipo de Separación, tercer campo adicional |
| output_format | Entero | (opcional) Formato de salida, por defecto 0 [mp3 (320kbps)] |
| is_demo | Booleano | (opcional) Si la separación debe publicarse en la página de demostración. Por defecto es <code>false<code> |
| Formato | Valor | Campos adicionales |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Clave: add_opt1 Formato: Output files Opciones:
Clave: add_opt2 Formato: Model Type Opciones:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Clave: add_opt1 Formato: Output files Opciones:
Clave: add_opt2 Formato: Model Type Opciones:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Clave: add_opt1 Formato: Output files Opciones:
Clave: add_opt2 Formato: Model Type Opciones:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Clave: add_opt1 Formato: Model type Opciones:
|
| BS Roformer (vocals, instrumental) | 40 | Clave: add_opt1 Formato: Vocal model type Opciones:
|
| BS PolarFormer (vocals, instrumental) | 123 | Clave: add_opt1 Formato: Overlap Opciones:
|
| MelBand Roformer (vocals, instrumental) | 48 | Clave: add_opt1 Formato: Vocal model type Opciones:
|
| MDX23C (vocals, instrumental) | 25 | Clave: add_opt1 Formato: Vocal model type Opciones:
|
| SCNet (vocals, instrumental) | 46 | Clave: add_opt1 Formato: Vocal model type Opciones:
|
| MDX B (vocals, instrumental) | 23 | Clave: add_opt1 Formato: Vocal model type Opciones:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Clave: add_opt1 Formato: Model Type Opciones:
Clave: add_opt2 Formato: Agressiveness Opciones:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Clave: add_opt1 Formato: Karaoke model type Opciones:
Clave: add_opt2 Formato: Extraction type Opciones:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Clave: add_opt1 Formato: Karaoke model type Opciones:
|
| MVSep Crowd removal (crowd, other) | 34 | Clave: add_opt1 Formato: Model type Opciones:
|
| Medley Vox (Multi-singer separation) | 53 | Clave: add_opt1 Formato: Model type Opciones:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Clave: add_opt1 Formato: Model Type Opciones:
|
| MVSep Male/Female separation | 57 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Choir (choir, other) | 112 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Drums (drums, other) | 44 | Clave: add_opt1 Formato: Drums model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
Clave: add_opt3 Formato: Output files Opciones:
|
| MVSep Bass (bass, other) | 41 | Clave: add_opt1 Formato: Bass model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
Clave: add_opt3 Formato: Output files Opciones:
|
| MVSep Synth (synth, other) | 88 | Clave: add_opt1 Formato: How to extract Opciones:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Clave: add_opt1 Formato: Model Type Opciones:
Clave: add_opt2 Formato: Preprocess Opciones:
|
| MVSep Piano (piano, other) | 29 | Clave: add_opt1 Formato: Piano model type Opciones:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Clave: add_opt1 Formato: Organ model type Opciones:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Clave: add_opt1 Formato: Guitar model type Opciones:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Clave: add_opt1 Formato: Model type Opciones:
|
| 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 | Clave: add_opt1 Formato: String model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Cello (cello, other) | 70 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Double Bass (double-bass, other) | 73 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Wind (wind, other) | 54 | Clave: add_opt1 Formato: Wind model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
Clave: add_opt3 Formato: Output files Opciones:
|
| MVSep Brass (brass, other) | 107 | Clave: add_opt1 Formato: How to extract Opciones:
|
| MVSep Woodwind (woodwind, other) | 108 | Clave: add_opt1 Formato: How to extract Opciones:
|
| MVSep Saxophone (saxophone, other) | 61 | Clave: add_opt1 Formato: Model type Opciones:
|
| MVSep Flute (flute, other) | 67 | Clave: add_opt1 Formato: Flute model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Trumpet (trumpet, other) | 71 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Trombone (trombone, other) | 75 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Oboe (oboe, other) | 77 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Clarinet (clarinet, other) | 78 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep French Horn (french-horn, other) | 82 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Harmonica (harmonica, other) | 87 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Clave: add_opt2 Formato: How to extract Opciones:
|
| 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 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Celesta (celesta, other) | 110 | Clave: add_opt2 Formato: How to extract Opciones:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Clave: add_opt1 Formato: Model type Opciones:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Clave: add_opt1 Formato: Model Type Opciones:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: How to extract Opciones:
Clave: add_opt3 Formato: Output files Opciones:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: Cutoff (Hz) Opciones:
|
| Reverb Removal (noreverb) | 22 | Clave: add_opt1 Formato: Model Type Opciones:
Clave: add_opt2 Formato: Preprocess Opciones:
|
| DeNoise by aufr33 and gabox | 47 | Clave: add_opt1 Formato: Model type Opciones:
|
| AudioSR (Super Resolution) | 59 | Clave: add_opt1 Formato: Cutoff (Hz) Opciones:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Clave: add_opt1 Formato: Text prompt Opciones: Clave: add_opt2 Formato: Length (in seconds) Opciones:
|
| Whisper (extract text from audio) | 39 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: Transcription type Opciones:
|
| Parakeet (extract text from audio) | 64 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: Version Opciones:
|
| VibeVoice (Voice Cloning) | 103 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: Text prompt Opciones: Clave: add_opt3 Formato: Extract vocals first Opciones:
|
| VibeVoice (TTS) | 104 | Clave: add_opt1 Formato: Model type Opciones:
Clave: add_opt2 Formato: Text prompt Opciones: |
| Qwen3-TTS (Custom Voice) | 118 | Clave: add_opt1 Formato: Text prompt Opciones: Clave: add_opt2 Formato: Speaker Opciones:
Clave: add_opt3 Formato: Language Opciones:
Clave: add_opt4 Formato: Voice description Opciones: |
| Qwen3-TTS (Voice Design) | 119 | Clave: add_opt1 Formato: Text prompt Opciones: Clave: add_opt2 Formato: Voice description Opciones: Clave: add_opt3 Formato: Language Opciones:
|
| Qwen3-TTS (Voice Cloning) | 120 | Clave: add_opt1 Formato: Text prompt Opciones: Clave: add_opt2 Formato: Reference text in audio (optional) Opciones: Clave: add_opt3 Formato: Language Opciones:
Clave: add_opt4 Formato: Extract vocals first Opciones:
|
| Bark (Speech Gen) | 115 | Clave: add_opt1 Formato: Text prompt Opciones: Clave: add_opt2 Formato: Speaker Opciones:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Clave: add_opt1 Formato: Model Type Opciones:
|
| Aspiration (by Sucial) | 50 | Clave: add_opt1 Formato: Model type Opciones:
|
| Phantom Centre extraction | 55 | Clave: add_opt1 Formato: Model type Opciones:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Clave: add_opt1 Formato: How to use Opciones:
|
| Transkun (piano -> midi) | 113 | Clave: add_opt1 Formato: How to extract Opciones:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Clave: add_opt1 Formato: Lyrics Opciones: Clave: add_opt10 Formato: Topic Opciones:
Clave: add_opt2 Formato: Tags (optional) Opciones: Clave: add_opt3 Formato: Genre Opciones:
Clave: add_opt4 Formato: Timbre Opciones:
Clave: add_opt5 Formato: Gender Opciones:
Clave: add_opt6 Formato: Mood Opciones:
Clave: add_opt7 Formato: Instrument Opciones:
Clave: add_opt8 Formato: Scene Opciones:
Clave: add_opt9 Formato: Region Opciones:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Clave: add_opt1 Formato: Model type Opciones:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Clave: add_opt1 Formato: Vocal model type Opciones:
|
| Vit Large 23 (vocals, instrum) | 33 | Clave: add_opt1 Formato: Model type Opciones:
|
| UVRv5 Demucs (vocals, music) | 17 | Clave: add_opt1 Formato: Model Type Opciones:
|
| 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 | Clave: add_opt1 Formato: Model type Opciones:
|
| UnMix | 3 | Clave: add_opt1 Formato: Model type Opciones:
|
| Zero Shot (Query Based) (Low quality) | 14 | Clave: add_opt1 Formato: Model Type Opciones:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Clave: add_opt1 Formato: Model type Opciones:
|
| Formato | Valor |
|---|---|
| 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="<Su token API>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Clave | Valor |
|---|---|
| success |
|
| data | Contiene información adicional dependiendo de la clave success |
| data -> link | Muestra el enlace a la URL "OBTENER RESULTADO" del trabajo creado (solo se muestra cuando success es true) |
| data -> hash | Muestra el hash del trabajo creado (solo se muestra cuando success es true) |
| data -> message | Muestra la descripción de un error (solo se muestra cuando success es false) |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Parámetros faltantes o inválidos. Este error aparece cuando no se pasan todos los parámetros obligatorios o se pasan parámetros no válidos. |
| 401 |
api_token desconocido o inválido. Este error aparece si utiliza una clave API desconocida
|
Para obtener el resultado de la separación, debe realizar una petición GET a la siguiente URL:
https://mvsep.com/api/separation/get
| Campo | Tipo | Descripción |
|---|---|---|
| hash | Cadena | Hash de separación |
| mirror | Entero | (opcional) Utiliza otra ventana si se establece en 1, el valor predeterminado es 0. Requiere <code>api_token<code> y 1 crédito si se establece en 1. |
| api_token | Cadena | (opcional) Clave API del usuario. Requerido si el parámetro <code>ventana<code> está establecido en 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Clave | Valor |
|---|---|
| success |
|
| status |
|
| data | Contiene información adicional, dependiendo de la clave de estado |
| data -> queue_count | Muestra el recuento de trabajos sin procesar de acuerdo a la prioridad del usuario (solo se muestra cuando el estado está en waiting o en distributing) |
| data -> current_order | Muestra el orden del trabajo del usuario (solo se muestra cuando el estado está en waiting o en distributing) |
| data -> message | Muestra la descripción del estado (se muestra en todos los estados, muestra el motivo del error cuando el estado es failed) |
| data -> algorithm | Muestra el algoritmo utilizado en el trabajo (solo se muestra cuando el estado es done) |
| data -> algorithm_description | Muestra los detalles del algoritmo utilizado en el trabajo (solo se muestra cuando el estado es done) |
| data -> output_format | Muestra el formato de salida del trabajo (solo se muestra cuando el estado está terminado) |
| data -> tags | Muestra las etiquetas de metadatos de audio (solo se muestra cuando el estado está terminado) |
| data -> input_file | Muestra los detalles de descarga de audio de entrada (solo se muestra cuando el estado está terminado) |
| data -> files | Muestra los detalles de descarga de los audios de salida (solo se muestra cuando el estado está terminado) |
| data -> date | Muestra la fecha de procesamiento del trabajo (solo se muestra cuando el estado está terminado) |
| data -> finished_chunks | Muestra el número de piezas terminadas de un trabajo grande (solo se muestra cuando el estado está en distribución) |
| data -> all_chunks | Muestra el número de todas las partes de un trabajo grande (solo se muestra cuando el estado está en distribución) |
Para obtener el resultado de un trabajo remoto, debes realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/separation/get-remote
| Campo | Tipo | Descripción |
|---|---|---|
| hash | Cadena | Hash de separación |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Clave | Valor |
|---|---|
| success |
|
| status |
|
| data | Contiene información adicional, dependiendo de la clave de estado |
| data -> queue_count | Muestra el número de trabajos sin procesar en la cola de prioridad del usuario (solo se muestra cuando el estado de status es waiting). |
| data -> current_order | Muestra el orden del trabajo del usuario (solo se muestra cuando status es waiting). |
| data -> message | Muestra la descripción del estado (solo cuando status es failed). |
| data -> link | Muestra el enlace a la URL "GET RESULT" del trabajo creado (solo se muestra cuando status es done). |
| data -> hash | Hash de la separación (solo se muestra cuando status es done) |
Para cancelar la baja y reembolsar los créditos utilizados (si la baja aún no se ha tramitado), debes realizar una llamada POST a la siguiente URL:
https://mvsep.com/api/separation/cancel
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
| hash | Cadena | Hash de separación |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Su token API>"' --form 'hash="<hash>"'
| Clave | Valor |
|---|---|
| success |
|
Para obtener datos detallados sobre los tipos de separación, debe realizar una petición GET a la siguiente URL:
https://mvsep.com/api/app/algorithms
| Campo | Tipo | Descripción |
|---|---|---|
| scopes | Cadena | Si se deben incluir modelos que utilicen diferentes tipos de datos de entrada.
single_upload. Para obtener todos los modelos, establece scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Devuelve los datos como un arreglo (matriz):
| Clave | Valor |
|---|---|
| render_id | Valor del tipo de separación (ID) |
| name | El nombre del tipo de separación |
| algorithm_group_id | El grupo al que pertenece el tipo de separación: |
| algorithm_group | Contiene información sobre el grupo de algoritmos al que pertenece el algoritmo. |
| algorithm_group -> name | Nombre del grupo de algoritmos. |
| audio_widget |
El tipo de widget de audio que se utilizará para el algoritmo. Esto permite determinar cómo se mostrará el reproductor de audio del algoritmo en la interfaz de usuario. Los valores posibles son:
|
| orientation |
Qué usuarios pueden disponer de este tipo de separación:
|
| order_id | El orden del tipo de separación |
| price_coefficient |
Se utiliza para calcular cuántos créditos consume el trabajo al usuario premium. Usa esta formula : floor(<duración del archivo de audio en segundos> * price_coefficient / 60)?:1
|
| usage | Muestra el recuento mensual de uso por tipo de separación |
| rating | Muestra la clasificación de uso mensual por tipo de separación en forma de matriz:
|
| algorithm_fields | Contiene información sobre campos adicionales del tipo de separación |
| algorithm_fields -> name |
Muestra cuál campo adicional del tipo de separación:
|
| algorithm_fields -> text | Nombre con el que se muestra el campo adicional del tipo de separación. |
| algorithm_fields -> options | Cadenas clave-valor codificadas en JSON del campo adicional |
| algorithm_fields -> default_key | Valor predeterminado del campo adicional. Una de las claves de <code>campos_algoritmo -> opciones<code> |
| algorithm_descriptions | Contiene información sobre descripciones del tipo de separación. |
| algorithm_descriptions -> short_description | Pequeña descripción del tipo de separación que no utiliza HTML. |
| algorithm_descriptions -> long_description | Descripción detallada del tipo de separación que utiliza HTML. |
| algorithm_descriptions -> lang | Código específico de idioma, de la descripción. |
Para obtener información sobre las últimas noticias sobre MVSEP, debe realizar una petición GET a la siguiente URL:
https://mvsep.com/api/app/news
| Campo | Tipo | Descripción |
|---|---|---|
| lang | Cadena | (opcional) Código de 2 letras del idioma(en, es) |
| start | Entero | (opcional) Desplazamiento desde el punto inicial, el valor predeterminado es 0 (es decir, se comienza por el último) |
| limit | Entero | (opcional) Cantidad máxima de resultados devueltos, el valor predeterminado es 10, el máximo es 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Devuelve los datos como un arreglo (matriz):
| Clave | Valor |
|---|---|
| title | Título de las noticias |
| lang | Título de las noticias |
| text | Descripción completa de las noticias |
| created_at | Fecha de las noticias |
Para obtener información sobre la cola del sitio, debes realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/app/queue
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | (opcional) Clave API del usuario |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Clave | Valor |
|---|---|
| queue |
Contiene una matriz con las colas actuales de los distintos planes:
|
| plan |
Contiene la cola actual del plan actual (añade api_token a la solicitud para el plan registrado/premium):
|
Para obtener información sobre las separaciones de la página de demostración, debe realizar una petición GET a la siguiente URL:
https://mvsep.com/api/app/demo
| Campo | Tipo | Descripción |
|---|---|---|
| start | Entero | (opcional) Desplazamiento desde el punto inicial, el valor predeterminado es 0 (es decir, se comienza por el último) |
| limit | Entero | (opcional) Cantidad máxima de resultados devueltos, el valor predeterminado es 10, el máximo es 20. |
| algorithm_id | Entero | ID de tipo de separación opcional. Utilícelo para obtener solo las separaciones de demostración creadas por un algoritmo concreto. Los valores coinciden con render_id del punto final GET SEPARATION TYPES. |
| options[FIELD] | Cadena / Entero | Filtro opcional para los valores de las opciones del algoritmo. Sustituye FIELD por una clave de campo adicional de algorithm_fields -> name en la respuesta de GET SEPARATION TYPES y, a continuación, pasa una de las claves options de ese campo como valor. Ejemplo: options[vocals]=1. |
| additional_options | Cadena | La sintaxis "raw opcional" incluye un filtro sobre los datos de opciones de los trabajos almacenados. Para las nuevas integraciones, se recomienda utilizar options[FIELD], ya que es más explícita y fácil de escribir. |
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'
Para crear filtros de opciones, primero llama a https://mvsep.com/api/app/algorithms y revisa la lista algorithm_fields de cada algoritmo. Utiliza el campo name dentro de options[FIELD] y asigna como valor una de las claves de opciones JSON.
Devuelve los datos como un arreglo (matriz):
| Clave | Valor |
|---|---|
| hash | Hash de separación |
| date | Fecha de la separación |
| input_audio | URL del audio de entrada |
| size | Tamaño del audio de entrada |
| algorithm | Contiene información básica sobre el tipo de separación utilizado (consulte la pestaña OBTENER TIPOS DE SEPARACIÓN para obtener información sobre los parámetros devueltos) |
Para autenticar al usuario y obtener su clave API, debe realizar una petición POST a la siguiente URL:
https://mvsep.com/api/app/login
| Campo | Tipo | Descripción |
|---|---|---|
| Cadena | Correo electrónico del usuario | |
| password | Cadena | Contraseña del usuario |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Correo electrónico del usuario>"' --form 'password="<Contraseña del usuario>"'
| Clave | Valor |
|---|---|
| success |
|
| data | Contiene información cuando las credenciales son válidas. |
| data -> name | Nombre del usuario |
| data -> email | Correo electrónico del usuario |
| data -> api_token | La clave API del usuario. Asegúrese de guardarlo en un lugar seguro y utilizarlo para operaciones posteriores. |
| data -> premium_minutes | Créditos restantes del usuario |
| data -> premium_enabled |
Si el usuario permitió gastar créditos.
|
| data -> long_filenames_enabled |
Si el usuario desea información adicional en los nombres de los archivos:
|
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Se especificaron credenciales incorrectas |
Para registrar un usuario en el sitio MVSEP, debe realizar una petición POST a la siguiente URL:
https://mvsep.com/api/app/register
| Campo | Tipo | Descripción |
|---|---|---|
| name | Cadena | Nombre del usuario |
| Cadena | Correo electrónico del usuario | |
| password | Cadena | Contraseña del usuario |
| password_confirmation | Cadena | Repetir la contraseña del usuario |
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"'
| Clave | Valor |
|---|---|
| success |
|
| message | Ocurre cuando el formulario es válido. |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Formulario no válido |
Para obtener información del usuario, debe realizar una petición GET a la siguiente URL:
https://mvsep.com/api/app/user
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Su token API>'
| Clave | Valor |
|---|---|
| success |
|
| data | Contiene información cuando las credenciales son válidas. |
| data -> name | Nombre del usuario |
| data -> email | Correo electrónico del usuario |
| data -> api_token | La clave API del usuario. Asegúrese de guardarlo en un lugar seguro y utilizarlo para operaciones posteriores. |
| data -> premium_minutes | Créditos restantes del usuario |
| data -> premium_enabled |
Si el usuario permitió gastar créditos.
|
| data -> long_filenames_enabled |
Si el usuario desea información adicional en los nombres de los archivos:
|
| data -> current_queue | Muestra separaciones en curso del usuario. |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Clave API no válida |
Para obtener información básica del historial de separación del usuario, debe realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/app/separation_history
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
| start | Entero | (opcional) Desplazamiento desde el punto inicial, el valor predeterminado es 0 (es decir, se comienza por el último) |
| limit | Entero | (opcional) Cantidad máxima de resultados devueltos, el valor predeterminado es 10, el máximo es 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Su token API>&start=1&limit=2'
| Clave | Valor |
|---|---|
| success |
|
| data | Contiene una matriz de información básica sobre separaciones anteriores. |
| data -> hash | Hash de separación |
| data -> job_exists | Contiene una matriz de información básica sobre separaciones anteriores. |
| data -> credits | Cuántos créditos se consumierom para el trabajo, nulo si no existe separación |
| data -> time_left | Tiempo aproximado restante hasta que se elimine el trabajo |
| data -> algorithm | Contiene información básica sobre el tipo de separación utilizado (consulte la pestaña OBTENER TIPOS DE SEPARACIÓN para obtener información sobre los parámetros devueltos) |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Clave API no válida |
Para habilitar el uso premium para el usuario, debe realizar una petición POST a la siguiente URL:
https://mvsep.com/api/app/enable_premium
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Su token API>"'
| Clave | Valor |
|---|---|
| success |
|
| message | Informa sobre el estado de la operación |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Clave API no válida |
Para deshabilitar el uso premium para el usuario, debe realizar una petición POST a la siguiente URL:
https://mvsep.com/api/app/disable_premium
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Su token API>"'
| Clave | Valor |
|---|---|
| success |
|
| message | Informa sobre el estado de la operación |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Clave API no válida |
Para habilitar los nombres extensos de archivos para el usuario, debe realizar una petición POST a la siguiente URL:
https://mvsep.com/api/app/enable_long_filenames
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Su token API>"'
| Clave | Valor |
|---|---|
| success |
|
| message | Informa sobre el estado de la operación |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Clave API no válida |
Para deshabilitar los nombres extensos de archivos para el usuario, debe realizar una petición POST a la siguiente URL:
https://mvsep.com/api/app/disable_long_filenames
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Su token API>"'
| Clave | Valor |
|---|---|
| success |
|
| message | Informa sobre el estado de la operación |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Clave API no válida |
Para obtener información sobre las entradas de la cola de Quality Checker, debes realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/quality_checker/queue
| Campo | Tipo | Descripción |
|---|---|---|
| start | Entero | (opcional) Desplazamiento desde el punto inicial, el valor predeterminado es 0 (es decir, se comienza por el último) |
| limit | Entero | (opcional) Cantidad máxima de resultados devueltos, el valor predeterminado es 10, el máximo es 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Devuelve los datos como un arreglo (matriz):
| Clave | Valor |
|---|---|
| id | Número de identificación de la entrada |
| dataset_type | Tipo de conjunto de datos seleccionado al añadir la entrada / tipo de clasificación
|
| date | Fecha de creación de la entrada |
| algo_name | Nombre del tipo de separación o algoritmo utilizado |
| main_text | Descripción del tipo de separación o algoritmo utilizado |
| proc | Estado del tratamiento
|
| proc_remote_date | Fecha y hora de procesamiento |
| msg | Devuelve "OK" si se realiza correctamente; de lo contrario, muestra un mensaje de error |
| metrics | Información sobre los indicadores de acceso |
| sdr_* (wildcard) | SDR de las pistas correspondientes |
| dataset_name | Nombre del conjunto de datos |
Para obtener información sobre las tablas de clasificación de Quality Checker, debes realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/quality_checker/leaderboard
| Campo | Tipo | Descripción |
|---|---|---|
| dataset_type | Cadena | Tipo de conjunto de datos; si no se especifica, el valor predeterminado es 0.
|
| start | Entero | (opcional) Desplazamiento desde el punto inicial, el valor predeterminado es 0 (es decir, se comienza por el último) |
| limit | Entero | (opcional) Cantidad máxima de resultados devueltos, el valor predeterminado es 10, el máximo es 20. |
| algo_name_filter | Cadena | Filtra los nombres de los tipos de separación o algoritmos según el texto introducido |
| sort | Cadena | Ordena por el SDR de la pista. Puedes obtener la lista de valores ordenables para un tipo de conjunto de datos determinado a través de la clave sortables de la respuesta. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Clave | Valor |
|---|---|
| data | Contiene una serie de entradas de Quality Checker. Consulte la sección respuesta de GET QUEUE del Quality Checker para obtener más información. |
| dataset_type | Clave del tipo de conjunto de datos utilizado |
| sortables | Claves que se pueden utilizar para ordenar los tipos de conjuntos de datos utilizados por una pista determinada en orden secuencial. |
| sort | Clave de ordenación utilizada de "sortable". |
Para crear una entrada en Quality Checker, debes realizar una solicitud POST a la siguiente URL:
https://mvsep.com/api/quality_checker/add
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | (obligatorio) Tu clave API |
| zipfile | Binario | (obligatorio) Archivo ZIP que se va a procesar |
| algo_name | Cadena | (obligatorio) Nombre del algoritmo |
| main_text | Cadena | (obligatorio) Descripción del algoritmo |
| dataset_type | Cadena | Tipo de conjunto de datos. El valor predeterminado es 0.
|
| password | Cadena | (obligatorio) Contraseña para eliminar el algoritmo |
| ensemble | Entero | 0 - el algoritmo no es un conjunto. 1 - el algoritmo es un conjunto. |
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"'
| Clave | Valor |
|---|---|
| success |
|
| data | Contiene información sobre la entrada |
| data -> id | ID de la entrada |
| data -> link | Enlace a la entrada |
La API de MVSEP utiliza los siguientes códigos de error:
| Código | Significado |
|---|---|
| 400 | Formulario no válido |
| 401 |
api_token desconocido o inválido. Este error aparece si utiliza una clave API desconocida
|
Para obtener información sobre una entrada de la cola de Quality Checker por su ID, debes realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/quality_checker/entry
| Campo | Tipo | Descripción |
|---|---|---|
| id | Entero | (obligatorio) ID de la entrada |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Para eliminar una entrada de la cola de Quality Checker por ID y contraseña, debes realizar una llamada GET a la siguiente URL:
https://mvsep.com/api/quality_checker/delete
| Campo | Tipo | Descripción |
|---|---|---|
| id | Entero | (obligatorio) ID de la entrada |
| password | Cadena | (obligatorio) Contraseña utilizada para el acceso |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Clave | Valor |
|---|---|
| success |
|
| data->message | Indica si se ha eliminado la entrada |
turbo@mvsep.com