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>.
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.
MVSEP dispone de puntos finales de API regionales. Todas las regiones comparten una única base de datos de cuentas, por lo que la misma cuenta, la misma clave API y los mismos hashes de trabajo funcionan en todas ellas:
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://hk.mvsep.com/apiLas solicitudes a https://mvsep.com/api se enrutan por geolocalización: quienes llaman desde Europa se dirigen a de, quienes llaman desde el norte de Asia a hk y el resto a de2. Para las integraciones de API recomendamos llamar explícitamente a un punto final regional: así todo el ciclo de vida del trabajo se mantiene en un único host, sea cual sea el origen de tus solicitudes.
Cada separación se procesa y se almacena en la región donde se creó, y las URL de descarga que devuelven las respuestas siempre apuntan al host de esa región. Para obtener el mejor rendimiento, elige el punto final más cercano a tus servidores y utiliza el mismo host durante todo el ciclo de vida del trabajo: creación, consulta del estado y descarga de archivos.
Puedes consultar el estado de cualquier trabajo desde cualquier región (la base de datos es compartida), pero los archivos de salida siempre los sirve la región propietaria del trabajo.
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 matchering, 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 20. Este es el ID del tipo de separación; consulte la sección OBTENER TIPOS DE SEPARACIÓN para obtener más información. Se ignora cuando se indica <code class="higlighted">preset_id</code>. |
| preset_id | Entero | (opcional) Ejecute uno de sus preajustes guardados sobre el archivo en lugar de un solo algoritmo. Proporcione sep_type o preset_id: un preajuste define sus propios algoritmos, opciones y formatos de salida, por lo que sep_type, los campos add_opt y output_format se ignoran junto con él. La respuesta devuelve un hash que consulta exactamente como una separación; el resultado contiene una entrada por nodo de salida del preajuste. Consulte la tabla de preajustes a continuación para obtener sus ID. |
| 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> |
| webhook_url | Cadena | (optional) A URL we will POST the finished result to, so you do not have to keep polling. The body is the same JSON as GET SEPARATION. This overrides the account-wide address set on the webhooks page, which is useful when several of your own users share one API token. Must be a publicly reachable http or https address. |
| Nombre | Valor | Campos adicionales |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Clave: add_opt1 Nombre: Output files Opciones:
Clave: add_opt2 Nombre: Model Type Opciones:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Clave: add_opt1 Nombre: Output files Opciones:
Clave: add_opt2 Nombre: Model Type Opciones:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Clave: add_opt1 Nombre: Output files Opciones:
Clave: add_opt2 Nombre: Model Type Opciones:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Clave: add_opt1 Nombre: Model type Opciones:
|
| BS Roformer (vocals, instrumental) | 40 | Clave: add_opt1 Nombre: Vocal model type Opciones:
Clave: add_opt2 Nombre: Overlap Opciones:
Clave: add_opt3 Nombre: Set of stems Opciones:
|
| BS PolarFormer (vocals, instrumental) | 123 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: Overlap Opciones:
|
| MelBand Roformer (vocals, instrumental) | 48 | Clave: add_opt1 Nombre: Vocal model type Opciones:
Clave: add_opt2 Nombre: Overlap Opciones:
|
| MDX23C (vocals, instrumental) | 25 | Clave: add_opt1 Nombre: Vocal model type Opciones:
|
| SCNet (vocals, instrumental) | 46 | Clave: add_opt1 Nombre: Vocal model type Opciones:
|
| MDX B (vocals, instrumental) | 23 | Clave: add_opt1 Nombre: Vocal model type Opciones:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Clave: add_opt1 Nombre: Model Type Opciones:
Clave: add_opt2 Nombre: Agressiveness Opciones:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Clave: add_opt1 Nombre: Karaoke model type Opciones:
Clave: add_opt2 Nombre: Extraction type Opciones:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Clave: add_opt1 Nombre: Karaoke model type Opciones:
|
| MVSep Crowd removal (crowd, other) | 34 | Clave: add_opt1 Nombre: Model type Opciones:
|
| Medley Vox (Multi-singer separation) | 53 | Clave: add_opt1 Nombre: Model type Opciones:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Clave: add_opt1 Nombre: Model Type Opciones:
Clave: add_opt2 Nombre: Processing Mode Opciones:
|
| MVSep Male/Female separation | 57 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Choir (choir, other) | 112 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Drums (drums, other) | 44 | Clave: add_opt1 Nombre: Drums model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
Clave: add_opt3 Nombre: Output files Opciones:
|
| MVSep Bass (bass, other) | 41 | Clave: add_opt1 Nombre: Bass model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
Clave: add_opt3 Nombre: Output files Opciones:
|
| MVSep Synth (synth, other) | 88 | Clave: add_opt1 Nombre: How to extract Opciones:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Clave: add_opt1 Nombre: Model Type Opciones:
Clave: add_opt2 Nombre: Preprocess Opciones:
|
| MVSep Piano (piano, other) | 29 | Clave: add_opt1 Nombre: Piano model type Opciones:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Clave: add_opt1 Nombre: Organ model type Opciones:
|
| 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 | Clave: add_opt1 Nombre: Guitar model type Opciones:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Clave: add_opt1 Nombre: 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 Nombre: String model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Cello (cello, other) | 70 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Double Bass (double-bass, other) | 73 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Wind (wind, other) | 54 | Clave: add_opt1 Nombre: Wind model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
Clave: add_opt3 Nombre: Output files Opciones:
|
| MVSep Brass (brass, other) | 107 | Clave: add_opt1 Nombre: How to extract Opciones:
|
| MVSep Woodwind (woodwind, other) | 108 | Clave: add_opt1 Nombre: How to extract Opciones:
|
| MVSep Saxophone (saxophone, other) | 61 | Clave: add_opt1 Nombre: Model type Opciones:
|
| MVSep Flute (flute, other) | 67 | Clave: add_opt1 Nombre: Flute model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Trumpet (trumpet, other) | 71 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Trombone (trombone, other) | 75 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Oboe (oboe, other) | 77 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Clarinet (clarinet, other) | 78 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep French Horn (french-horn, other) | 82 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Harmonica (harmonica, other) | 87 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| 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 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Celesta (celesta, other) | 110 | Clave: add_opt2 Nombre: How to extract Opciones:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Clave: add_opt1 Nombre: Model type Opciones:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Clave: add_opt1 Nombre: Model Type Opciones:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: How to extract Opciones:
Clave: add_opt3 Nombre: Output files Opciones:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: Cutoff (Hz) Opciones:
|
| Reverb Removal (noreverb) | 22 | Clave: add_opt1 Nombre: Model Type Opciones:
Clave: add_opt2 Nombre: Preprocess Opciones:
|
| DeNoise by aufr33 and gabox | 47 | Clave: add_opt1 Nombre: Model type Opciones:
|
| AudioSR (Super Resolution) | 59 | Clave: add_opt1 Nombre: Cutoff (Hz) Opciones:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Clave: add_opt1 Nombre: Text prompt Opciones: Clave: add_opt2 Nombre: Length (in seconds) Opciones:
|
| Whisper (extract text from audio) | 39 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: Transcription type Opciones:
|
| Parakeet (extract text from audio) | 64 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: Version Opciones:
|
| VibeVoice (Voice Cloning) | 103 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: Text prompt Opciones: Clave: add_opt3 Nombre: Extract vocals first Opciones:
|
| VibeVoice (TTS) | 104 | Clave: add_opt1 Nombre: Model type Opciones:
Clave: add_opt2 Nombre: Text prompt Opciones: |
| Qwen3-TTS (Custom Voice) | 118 | Clave: add_opt1 Nombre: Text prompt Opciones: Clave: add_opt2 Nombre: Speaker Opciones:
Clave: add_opt3 Nombre: Language Opciones:
Clave: add_opt4 Nombre: Voice description Opciones: |
| Qwen3-TTS (Voice Design) | 119 | Clave: add_opt1 Nombre: Text prompt Opciones: Clave: add_opt2 Nombre: Voice description Opciones: Clave: add_opt3 Nombre: Language Opciones:
|
| Qwen3-TTS (Voice Cloning) | 120 | Clave: add_opt1 Nombre: Text prompt Opciones: Clave: add_opt2 Nombre: Reference text in audio (optional) Opciones: Clave: add_opt3 Nombre: Language Opciones:
Clave: add_opt4 Nombre: Extract vocals first Opciones:
|
| Mega 53-stem Model | 126 | |
| Upmixing by Jazzpear | 137 | |
| DeEffect vocals by gilliaan | 138 | |
| Bark (Speech Gen) | 115 | Clave: add_opt1 Nombre: Text prompt Opciones: Clave: add_opt2 Nombre: Speaker Opciones:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Clave: add_opt1 Nombre: Model Type Opciones:
|
| Aspiration (by Sucial) | 50 | Clave: add_opt1 Nombre: Model type Opciones:
|
| Phantom Centre extraction | 55 | Clave: add_opt1 Nombre: Model type Opciones:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Clave: add_opt1 Nombre: How to use Opciones:
|
| Transkun (Piano -> MIDI) | 113 | Clave: add_opt1 Nombre: How to extract Opciones:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Clave: add_opt1 Nombre: How to extract Opciones:
|
| HeartMuLa (Song Gen) | 121 | Clave: add_opt1 Nombre: Lyrics Opciones: Clave: add_opt10 Nombre: Topic Opciones:
Clave: add_opt2 Nombre: Tags (optional) Opciones: Clave: add_opt3 Nombre: Genre Opciones:
Clave: add_opt4 Nombre: Timbre Opciones:
Clave: add_opt5 Nombre: Gender Opciones:
Clave: add_opt6 Nombre: Mood Opciones:
Clave: add_opt7 Nombre: Instrument Opciones:
Clave: add_opt8 Nombre: Scene Opciones:
Clave: add_opt9 Nombre: Region Opciones:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Clave: add_opt1 Nombre: Model type Opciones:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Clave: add_opt1 Nombre: Vocal model type Opciones:
|
| Vit Large 23 (vocals, instrum) | 33 | Clave: add_opt1 Nombre: Model type Opciones:
|
| UVRv5 Demucs (vocals, music) | 17 | Clave: add_opt1 Nombre: 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 Nombre: Model type Opciones:
|
| UnMix | 3 | Clave: add_opt1 Nombre: Model type Opciones:
|
| Zero Shot (Query Based) (Low quality) | 14 | Clave: add_opt1 Nombre: Model Type Opciones:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Clave: add_opt1 Nombre: Model type Opciones:
|
Los preajustes son privados para la cuenta que los creó, por lo que esta tabla muestra tus preajustes más los seleccionados. Créalos y edítalos en el editor de preajustes.
Aún no tienes preajustes. Inicia sesión y crea uno en el editor de preajustes, y su ID aparecerá aquí.
| Nombre | 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 de error | 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
El mismo endpoint devuelve las ejecuciones de preajustes: consulta el hash que recibiste de preset_id exactamente igual que el de una separación. La estructura de la respuesta es idéntica: status pasa por waiting y processing hasta done, y data.type es preset_run. Cada entrada de data.files es un nodo de salida del preajuste, identificado por su etiqueta y no por una pista. Una ejecución solo es visible para la cuenta que la creó.
| Campo | Tipo | Descripción |
|---|---|---|
| hash | Cadena | Hash de separación |
| mirror | Entero | (opcional) Utiliza otro servidor espejo 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. Obligatoria si el parámetro <code>mirror</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 es waiting o distributing) |
| data -> current_order | Muestra el orden del trabajo del usuario (solo se muestra cuando el estado es waiting o 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 es done) |
| data -> tags | Muestra las etiquetas de metadatos de audio (solo se muestra cuando el estado es done) |
| data -> input_file | Muestra los detalles de descarga de audio de entrada (solo se muestra cuando el estado es done) |
| data -> files | Muestra los detalles de descarga de los audios de salida (solo se muestra cuando el estado es done) |
| data -> date | Muestra la fecha de procesamiento del trabajo (solo se muestra cuando el estado es done) |
| data -> finished_chunks | Muestra el número de piezas terminadas de un trabajo grande (solo se muestra cuando el estado es distributing) |
| data -> all_chunks | Muestra el número de todas las partes de un trabajo grande (solo se muestra cuando el estado es distributing) |
Elimina una de tus propias separaciones: un trabajo normal o una ejecución de preajuste. Esto elimina el registro y sus archivos de salida. Una separación que todavía se está procesando debe cancelarse primero. La eliminación no reembolsa los créditos, ya que el trabajo ya se ha ejecutado.
POST https://mvsep.com/api/separation/delete
Puedes consultar el estado de cualquier trabajo desde cualquier región (la base de datos es compartida), pero los archivos de salida siempre los sirve la región propietaria del trabajo.
| Campo | Tipo | Descripción |
|---|---|---|
| hash | Cadena | Hash de separación |
| api_token | Cadena | Clave API del usuario. Obligatorio. |
curl --location --request POST 'https://mvsep.com/api/separation/delete'
--form 'api_token="<Su token API>"'
--form 'hash="20230327071601-0e3e5c6c85-13-dimensions.mp3"'
| Clave | Valor |
|---|---|
| success |
|
| data -> message | Muestra la descripción del estado (se muestra en todos los estados, muestra el motivo del error cuando el estado es failed) |
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 separación y reembolsar los créditos utilizados (siempre que la separación aún no se esté procesando), 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 fórmula : 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>algorithm_fields -> options</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 idioma de 2 letras (en, ru) |
| 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 | Filtro opcional de coincidencia en bruto sobre los datos de opciones guardados del trabajo. Para las nuevas integraciones, se recomienda utilizar options[FIELD], ya que es más explícito y fácil de componer. |
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 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 de error | Significado |
|---|---|
| 400 | Formulario no válido |
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 de error | Significado |
|---|---|
| 400 | Se especificaron credenciales incorrectas |
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 de error | 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 consumió el trabajo; nulo si la separación ya no existe |
| 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 de error | Significado |
|---|---|
| 400 | Clave API no válida |
Para obtener las compras de créditos de esta cuenta (de más recientes a más antiguas), realiza una llamada GET a la siguiente url:
https://mvsep.com/api/purchases
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
| limit | Entero | (opcional) Número de compras a devolver, de 1 a 100. Por defecto es 20. |
| offset | Entero | (opcional) Cantidad de compras a omitir para navegar por el historial. El valor predeterminado es 0. |
| status | Cadena | (opcional) Devuelve solo las compras en este estado, por ejemplo succeeded. Omítelo (o pasa all) para obtener todo lo que muestra la página de historial del sitio web, que incluye los pagos que se iniciaron y nunca se completaron; estos tienen el estado unpaid y no se les otorgaron créditos. |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<Su token API>&status=succeeded&limit=20'
| Clave | Valor |
|---|---|
| purchases | Una entrada por compra: payment_id, status, amount, credits otorgados, payment_method (stripe, paddle, yookassa, google_play o app_store) y date. |
| total | Cuántas compras coinciden en total, sin tener en cuenta el límite ni el desplazamiento; úsalo para paginar. |
| credits | El saldo de créditos actual de la cuenta. |
MVSEP te envía un correo electrónico cuando tu saldo de crédito cae por debajo del umbral que elijas, para que una integración en ejecución no se detenga inesperadamente. GET devuelve la configuración actual; POST la modifica. La alerta se envía una sola vez y no se repite hasta que el saldo vuelva a superar el umbral.
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| Campo | Tipo | Descripción |
|---|---|---|
| api_token | Cadena | Clave API del usuario |
| credit_threshold | Entero | (Solo POST, obligatorio) Enviar la alerta cuando el saldo sea igual o inferior a esta cantidad de créditos. 0 desactiva la alerta. Cambiar el umbral reactiva una alerta que ya se ha enviado. |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<Su token API>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<Su token API>' --form 'credit_threshold=100'
| Clave | Valor |
|---|---|
| credit_threshold | El umbral actualmente establecido, en créditos. |
| enabled | <code>true</code> cuando se establece un umbral superior a cero, de lo contrario <code>false</code>. |
| credits | Saldo de créditos actual de la cuenta |
| notified | <code>true</code> una vez que se ha enviado la alerta para la caída actual; se borra automáticamente cuando el saldo vuelve a subir por encima del umbral. |
| La dirección a la que se envía la alerta. |
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 de error | 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 de error | 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 de error | 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 de error | 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 procesamiento
|
| 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 las métricas de la entrada |
| 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 de error | 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 la entrada |
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 |
Bibliotecas, aplicaciones e integraciones creadas con esta API. Salvo que se indique lo contrario, se trata de proyectos de la comunidad: MVSEP no les da mantenimiento y no podemos garantizar su calidad.
Este se distribuye en PyPI con el nombre mvsep-cli y menciona a MVSEP como su autor, lo que puede darle una apariencia oficial. Sin embargo, lo publica y mantiene un tercero, no MVSEP, y el repositorio de código fuente al que enlaza no existe. Solicita tu token de API, así que revisa su código fuente antes de pegar ningún token en él.
mvsep-cli: pypi.org/project/mvsep-cli
