turbo@mvsep.com
A API MVSEP fornece acesso programático para criar uma separação, retornar os resultados, obter informações do site e controlar as capacidades do usuário
Para usar essa API, você precisa de um API key. você não está conectado, conectar-se para obter seu token de api.
em Python: https://github.com/ZFTurbo/MVSep-API-Examples
Aplicativo não oficial MacVSep para Mac OS: https://github.com/septcoco/macvsep
Webhooks podem ser configurados aqui: Webhooks
Especificação OpenAPI: mvsep-openapi-spec.json
que os usuários Premium podem solicitar um número ilimitado de trabalhos simultâneos, enquanto os usuários não Premium podem solicitar apenas 1 trabalho simultâneo.
Para criar uma separação, você precisa criar uma chamada POST para a seguinte url:
https://mvsep.com/api/separation/create
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | Sua chave API |
| audiofile | Binário | de áudio a ser processado. Não é necessário se o parâmetro `url` estiver definido ou se o modelo não usar entrada de arquivo. Para modelos de correspondência, use `target_audiofile` e `reference_audiofile` como entrada em vez de `audiofile`. |
| url | String | áudio. Não é necessário se o parâmetro `audiofile` estiver definido. |
| remote_type | String | (opcional) Tipo remoto do arquivo de áudio. O padrão é direct. Não é necessário se o parâmetro audiofile estiver definido. Os tipos suportados são direct (Download Direto), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Inteiro | (opcional) Tipo de separação, o padrão é 11 (Demucs3 Modelo B (vocais, bateria, baixo, e outros)) |
| add_opt1 | String | (opcional) Tipo de separação, primeiro campo adicional |
| add_opt2 | String | (opcional) Tipo de separação, segundo campo adicional |
| add_opt3 | String | (opcional) Terceiro campo adicional do tipo de separação |
| output_format | Inteiro | (opcional) formato de saída, o padrão é 0 (mp3 (320kbps)) |
| is_demo | Booleano | (opcional) caso a separação seja publicada na página de demonstração, o padrão é falso |
| Nome | Valor | Campos |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Chave: add_opt1 Nome: Output files Opções:
Chave: add_opt2 Nome: Model Type Opções:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Chave: add_opt1 Nome: Output files Opções:
Chave: add_opt2 Nome: Model Type Opções:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Chave: add_opt1 Nome: Output files Opções:
Chave: add_opt2 Nome: Model Type Opções:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Chave: add_opt1 Nome: Model type Opções:
|
| BS Roformer (vocals, instrumental) | 40 | Chave: add_opt1 Nome: Vocal model type Opções:
|
| BS PolarFormer (vocals, instrumental) | 123 | Chave: add_opt1 Nome: Overlap Opções:
|
| MelBand Roformer (vocals, instrumental) | 48 | Chave: add_opt1 Nome: Vocal model type Opções:
|
| MDX23C (vocals, instrumental) | 25 | Chave: add_opt1 Nome: Vocal model type Opções:
|
| SCNet (vocals, instrumental) | 46 | Chave: add_opt1 Nome: Vocal model type Opções:
|
| MDX B (vocals, instrumental) | 23 | Chave: add_opt1 Nome: Vocal model type Opções:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Chave: add_opt1 Nome: Model Type Opções:
Chave: add_opt2 Nome: Agressiveness Opções:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Chave: add_opt1 Nome: Karaoke model type Opções:
Chave: add_opt2 Nome: Extraction type Opções:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Chave: add_opt1 Nome: Karaoke model type Opções:
|
| MVSep Crowd removal (crowd, other) | 34 | Chave: add_opt1 Nome: Model type Opções:
|
| Medley Vox (Multi-singer separation) | 53 | Chave: add_opt1 Nome: Model type Opções:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Chave: add_opt1 Nome: Model Type Opções:
|
| MVSep Male/Female separation | 57 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Choir (choir, other) | 112 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Drums (drums, other) | 44 | Chave: add_opt1 Nome: Drums model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
Chave: add_opt3 Nome: Output files Opções:
|
| MVSep Bass (bass, other) | 41 | Chave: add_opt1 Nome: Bass model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
Chave: add_opt3 Nome: Output files Opções:
|
| MVSep Synth (synth, other) | 88 | Chave: add_opt1 Nome: How to extract Opções:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Chave: add_opt1 Nome: Model Type Opções:
Chave: add_opt2 Nome: Preprocess Opções:
|
| MVSep Piano (piano, other) | 29 | Chave: add_opt1 Nome: Piano model type Opções:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Chave: add_opt1 Nome: Organ model type Opções:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Chave: add_opt1 Nome: Guitar model type Opções:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Chave: add_opt1 Nome: Model type Opções:
|
| 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 | Chave: add_opt1 Nome: String model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Cello (cello, other) | 70 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Double Bass (double-bass, other) | 73 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Wind (wind, other) | 54 | Chave: add_opt1 Nome: Wind model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
Chave: add_opt3 Nome: Output files Opções:
|
| MVSep Brass (brass, other) | 107 | Chave: add_opt1 Nome: How to extract Opções:
|
| MVSep Woodwind (woodwind, other) | 108 | Chave: add_opt1 Nome: How to extract Opções:
|
| MVSep Saxophone (saxophone, other) | 61 | Chave: add_opt1 Nome: Model type Opções:
|
| MVSep Flute (flute, other) | 67 | Chave: add_opt1 Nome: Flute model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Trumpet (trumpet, other) | 71 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Trombone (trombone, other) | 75 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Oboe (oboe, other) | 77 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Clarinet (clarinet, other) | 78 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep French Horn (french-horn, other) | 82 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Harmonica (harmonica, other) | 87 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Chave: add_opt2 Nome: How to extract Opções:
|
| 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 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Celesta (celesta, other) | 110 | Chave: add_opt2 Nome: How to extract Opções:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Chave: add_opt1 Nome: Model type Opções:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Chave: add_opt1 Nome: Model Type Opções:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: How to extract Opções:
Chave: add_opt3 Nome: Output files Opções:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: Cutoff (Hz) Opções:
|
| Reverb Removal (noreverb) | 22 | Chave: add_opt1 Nome: Model Type Opções:
Chave: add_opt2 Nome: Preprocess Opções:
|
| DeNoise by aufr33 and gabox | 47 | Chave: add_opt1 Nome: Model type Opções:
|
| AudioSR (Super Resolution) | 59 | Chave: add_opt1 Nome: Cutoff (Hz) Opções:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Chave: add_opt1 Nome: Text prompt Opções: Chave: add_opt2 Nome: Length (in seconds) Opções:
|
| Whisper (extract text from audio) | 39 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: Transcription type Opções:
|
| Parakeet (extract text from audio) | 64 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: Version Opções:
|
| VibeVoice (Voice Cloning) | 103 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: Text prompt Opções: Chave: add_opt3 Nome: Extract vocals first Opções:
|
| VibeVoice (TTS) | 104 | Chave: add_opt1 Nome: Model type Opções:
Chave: add_opt2 Nome: Text prompt Opções: |
| Qwen3-TTS (Custom Voice) | 118 | Chave: add_opt1 Nome: Text prompt Opções: Chave: add_opt2 Nome: Speaker Opções:
Chave: add_opt3 Nome: Language Opções:
Chave: add_opt4 Nome: Voice description Opções: |
| Qwen3-TTS (Voice Design) | 119 | Chave: add_opt1 Nome: Text prompt Opções: Chave: add_opt2 Nome: Voice description Opções: Chave: add_opt3 Nome: Language Opções:
|
| Qwen3-TTS (Voice Cloning) | 120 | Chave: add_opt1 Nome: Text prompt Opções: Chave: add_opt2 Nome: Reference text in audio (optional) Opções: Chave: add_opt3 Nome: Language Opções:
Chave: add_opt4 Nome: Extract vocals first Opções:
|
| Bark (Speech Gen) | 115 | Chave: add_opt1 Nome: Text prompt Opções: Chave: add_opt2 Nome: Speaker Opções:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Chave: add_opt1 Nome: Model Type Opções:
|
| Aspiration (by Sucial) | 50 | Chave: add_opt1 Nome: Model type Opções:
|
| Phantom Centre extraction | 55 | Chave: add_opt1 Nome: Model type Opções:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Chave: add_opt1 Nome: How to use Opções:
|
| Transkun (piano -> midi) | 113 | Chave: add_opt1 Nome: How to extract Opções:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Chave: add_opt1 Nome: Lyrics Opções: Chave: add_opt10 Nome: Topic Opções:
Chave: add_opt2 Nome: Tags (optional) Opções: Chave: add_opt3 Nome: Genre Opções:
Chave: add_opt4 Nome: Timbre Opções:
Chave: add_opt5 Nome: Gender Opções:
Chave: add_opt6 Nome: Mood Opções:
Chave: add_opt7 Nome: Instrument Opções:
Chave: add_opt8 Nome: Scene Opções:
Chave: add_opt9 Nome: Region Opções:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Chave: add_opt1 Nome: Model type Opções:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Chave: add_opt1 Nome: Vocal model type Opções:
|
| Vit Large 23 (vocals, instrum) | 33 | Chave: add_opt1 Nome: Model type Opções:
|
| UVRv5 Demucs (vocals, music) | 17 | Chave: add_opt1 Nome: Model Type Opções:
|
| 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 | Chave: add_opt1 Nome: Model type Opções:
|
| UnMix | 3 | Chave: add_opt1 Nome: Model type Opções:
|
| Zero Shot (Query Based) (Low quality) | 14 | Chave: add_opt1 Nome: Model Type Opções:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Chave: add_opt1 Nome: Model type Opções:
|
| Nome | 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="<Seu Token da API>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Chave | Valor |
|---|---|
| success |
|
| data | Contém informações adicionais dependendo da chave success |
| data -> link | Mostra o link para a URL "OBTER RESULTADO" do trabalho criado (apenas exibido quando success é true) |
| data -> hash | Mostra o hash do trabalho criado (apenas exibido quando success é true) |
| data -> message | Mostra a descrição de um erro (apenas exibido quando success é false) |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | Alguns parâmetros estão faltando ou estão inválidos. Este erro aparece quando você não passa todos os parâmetros obrigatórios ou passa parâmetros inválidos. |
| 401 |
Desconhecido ou inválido api_token. Esse erro aparece se você usa uma chave de API desconhecida.
|
Para ter o resultado, você precisa fazer uma chamada GET para a seguinte url:
https://mvsep.com/api/separation/get
| Campo | Tipo | Descrição |
|---|---|---|
| hash | String | Hash de separação |
| mirror | Inteiro | (opcional) Usa outro espelho se definido como 1, padrão é 0. Requer api_token e 1 crédito se definido como 1 |
| api_token | String | (opcional) Chave API do usuário. Necessária se o parâmetro de espelho for definido como 1 |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Chave | Valor |
|---|---|
| success |
|
| status |
|
| data | Contém informações adicionais dependendo da chave status |
| data -> queue_count | Mostra a contagem de trabalhos não processados na prioridade do usuário (apenas exibido quando status é waiting ou distributing) |
| data -> current_order | Mostra a ordem do trabalho do usuário (apenas exibido quando status é waiting ou distributing) |
| data -> message | Mostra a descrição do status (exibido em todos os status, mostra a razão do erro quando status é failed) |
| data -> algorithm | Mostra o algoritmo usado no trabalho (apenas exibido quando status é done) |
| data -> algorithm_description | Mostra os detalhes do algoritmo usado no trabalho (apenas exibido quando status é done) |
| data -> output_format | Mostra o formato de saída do trabalho (apenas exibido quando status é done) |
| data -> tags | Mostra as tags meta de áudio (apenas exibido quando status é done) |
| data -> input_file | Mostra os detalhes do download do áudio de entrada (apenas exibido quando status é done) |
| data -> files | Mostra os detalhes do download dos áudios de saída (apenas exibido quando status é done) |
| data -> date | Mostra a data de processamento do trabalho (apenas exibido quando status é done) |
| data -> finished_chunks | Mostra o número de partes concluídas de um grande trabalho (apenas exibido quando status é distributing) |
| data -> all_chunks | Mostra o número total de partes de um grande trabalho (apenas exibido quando status é distributing) |
Para obter o resultado de uma vaga remota, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/separation/get-remote
| Campo | Tipo | Descrição |
|---|---|---|
| hash | String | Hash de separação |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Chave | Valor |
|---|---|
| success |
|
| status |
|
| data | Contém informações adicionais dependendo da chave status |
| data -> queue_count | Mostra a contagem de tarefas não processadas na prioridade do usuário (exibido apenas quando o status é waiting). |
| data -> current_order | Mostra a ordem das tarefas do usuário (exibido apenas quando o status é waiting). |
| data -> message | Mostra a descrição do status (somente quando status é failed). |
| data -> link | Mostra o link para a URL "OBTER RESULTADO" da tarefa criada (exibido somente quando o status é concluído). |
| data -> hash | Hash da separação (exibido apenas quando status é done). |
cancelar a separação e reembolsar os créditos utilizados (caso a separação ainda não esteja em processamento), você precisa fazer uma requisição POST para a seguinte URL:
https://mvsep.com/api/separation/cancel
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
| hash | String | Hash de separação |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Seu Token da API>"' --form 'hash="<hash>"'
| Chave | Valor |
|---|---|
| success |
|
Para obter os dados detalhados sobre os tipos de separação, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/app/algorithms
| Campo | Tipo | Descrição |
|---|---|---|
| scopes | String | Se devem ser incluídos modelos que utilizam diferentes formas de entrada.
single_upload se não for fornecido. Para obter todos os modelos, defina scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Retorna os dados como um array:
| Chave | Valor |
|---|---|
| render_id | Valor do tipo de separação (ID) |
| name | o nome do tipo de separação |
| algorithm_group_id | o grupo ao qual pertence o tipo de separação: |
| algorithm_group | Contém informações sobre o grupo de algoritmos ao qual o algoritmo pertence. |
| algorithm_group -> name | Nome do grupo de algoritmos. |
| audio_widget |
O tipo de widget de áudio a ser usado para o algoritmo. Isso pode ser usado para determinar como exibir o reprodutor de áudio do algoritmo na interface. Os valores possíveis são:
|
| orientation |
a quem se destina esse tipo de separação:
|
| order_id | ordem do tipo de separação |
| price_coefficient |
usado para calcular quantos créditos a tarefa recebe do usuário premium. usa esta fórmula : floor(<duração do arquivo de áudio em segundos> * price_coefficient / 60)?:1
|
| usage | Mostra a contagem de uso mensal do tipo de separação |
| rating | Mostra a classificação de uso mensal do tipo de separação como uma matriz:
|
| algorithm_fields | contém informações sobre campos adicionais do tipo de separação |
| algorithm_fields -> name |
mostra qual campo adicional do tipo de separação:
|
| algorithm_fields -> text | nome de exibição do campo adicional do tipo de separação. |
| algorithm_fields -> options | Cadeias de chave-valor codificadas em JSON do campo adicional |
| algorithm_fields -> default_key | Valor padrão do campo adicional. Uma das chaves de <code>algorithm_fields -> options</code> |
| algorithm_descriptions | contém informações sobre as descrições do tipo de separação |
| algorithm_descriptions -> short_description | Pequena descrição do tipo de separação que não usa html. |
| algorithm_descriptions -> long_description | descrição detalhada do tipo de separação que usa html. |
| algorithm_descriptions -> lang | código de idioma especificado da descrição. |
Para obter informações sobre as últimas notícias sobre o MVSEP, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/app/news
| Campo | Tipo | Descrição |
|---|---|---|
| lang | String | (opcional) Código de idioma de 2 letras (en, ru) |
| start | Inteiro | (opcional) Ponto de partida de deslocamento, padrão é 0 (ou seja, começa a partir do mais recente) |
| limit | Inteiro | (opcional) Quantidade máxima de resultados retornados, padrão é 10, máximo é 20 |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Retorna os dados como um array:
| Chave | Valor |
|---|---|
| title | título da noticia |
| lang | título da noticia |
| text | descrição completa da notícia |
| created_at | data da noticia |
obter informações sobre a fila do site, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/app/queue
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | (opcional) chave de api do usuário |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Chave | Valor |
|---|---|
| queue |
Contém uma matriz de filas atuais para diferentes planos:
|
| plan |
Contém a fila atual para o plano atual (adicione api_token à solicitação para o plano registrado/premium):
|
Para obter informações sobre separações de demonstração, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/app/demo
| Campo | Tipo | Descrição |
|---|---|---|
| start | Inteiro | (opcional) Ponto de partida de deslocamento, padrão é 0 (ou seja, começa a partir do mais recente) |
| limit | Inteiro | (opcional) Quantidade máxima de resultados retornados, padrão é 10, máximo é 20 |
| algorithm_id | Inteiro | do tipo de separação. Use este campo para retornar separações de demonstração criadas por apenas um algoritmo. Os valores correspondem a `render_id` do endpoint GET SEPARATION TYPES. |
| options[FIELD] | String / Inteiro | para valores de opções de algoritmo. Substitua `FIELD` por uma chave de campo adicional de `algorithm_fields -> name` na resposta GET SEPARATION TYPES e, em seguida, passe uma das chaves `options` desse campo como valor. Exemplo: `options[vocals]=1`. |
| additional_options | String | O filtro opcional raw contém informações armazenadas sobre as opções de trabalho. Prefira `options[FIELD]` para novas integrações, pois é explícito e mais fácil de compor. |
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 construir filtros de opções, primeiro chame https://mvsep.com/api/app/algorithms e inspecione a lista algorithm_fields de cada algoritmo. Use o campo name dentro de options[FIELD] e use uma das chaves de opção JSON como valor.
Retorna os dados como um array:
| Chave | Valor |
|---|---|
| hash | Hash de separação |
| date | data da separação |
| input_audio | url do áudio de entrada |
| size | tamanho do áudio de entrada |
| algorithm | Contém informações básicas sobre o tipo de separação utilizado (consulte a aba GET SEPARATION TYPES para informações sobre os parâmetros retornados) |
Para autenticar o usuário e obter a chave API do usuário, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/app/login
| Campo | Tipo | Descrição |
|---|---|---|
| String | email do usuário | |
| password | String | senha do usuário |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<email do usuário>"' --form 'password="<senha do usuário>"'
| Chave | Valor |
|---|---|
| success |
|
| data | contém informações quando as credenciais são válidas |
| data -> name | Nome do usuário |
| data -> email | email do usuário |
| data -> api_token | chave de api do usuário. certifique-se de armazená-la em um local seguro e usá-la em operações subsequentes. |
| data -> premium_minutes | créditos deixados para o usuário |
| data -> premium_enabled |
caso o usuário tenha permitido que os créditos fosse gastos
|
| data -> long_filenames_enabled |
caso o usuário deseje informações adicionais nos nomes de arquivos:
|
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | credenciais incorretas especificadas |
Para registrar o usuário no site MVSEP, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/app/register
| Campo | Tipo | Descrição |
|---|---|---|
| name | String | Nome do usuário |
| String | email do usuário | |
| password | String | senha do usuário |
| password_confirmation | String | repita a senha do usuário |
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"'
| Chave | Valor |
|---|---|
| success |
|
| message | ocorre quando o formulário é inválido |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | o formulário é inválido |
Para obter informações do usuário, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/app/user
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Seu Token da API>'
| Chave | Valor |
|---|---|
| success |
|
| data | contém informações quando as credenciais são válidas |
| data -> name | Nome do usuário |
| data -> email | email do usuário |
| data -> api_token | chave de api do usuário. certifique-se de armazená-la em um local seguro e usá-la em operações subsequentes. |
| data -> premium_minutes | créditos deixados para o usuário |
| data -> premium_enabled |
caso o usuário tenha permitido que os créditos fosse gastos
|
| data -> long_filenames_enabled |
caso o usuário deseje informações adicionais nos nomes de arquivos:
|
| data -> current_queue | mostra as separações em andamento para o usuário |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | chave de api inválida |
Para obter informações básicas sobre o histórico de separações do usuário, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/app/separation_history
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
| start | Inteiro | (opcional) Ponto de partida de deslocamento, padrão é 0 (ou seja, começa a partir do mais recente) |
| limit | Inteiro | (opcional) Quantidade máxima de resultados retornados, padrão é 10, máximo é 20 |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Seu Token da API>&start=1&limit=2'
| Chave | Valor |
|---|---|
| success |
|
| data | contém uma matriz de informações básicas sobre separações anteriores |
| data -> hash | Hash de separação |
| data -> job_exists | contém uma matriz de informações básicas sobre separações anteriores |
| data -> credits | quantos créditos foram usados para a tarefa, nulo se não houver separação |
| data -> time_left | tempo restante estimado até que a tarefa seja deletada |
| data -> algorithm | Contém informações básicas sobre o tipo de separação utilizado (consulte a aba GET SEPARATION TYPES para informações sobre os parâmetros retornados) |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | chave de api inválida |
Para habilitar o uso premium para o usuário, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/app/enable_premium
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Seu Token da API>"'
| Chave | Valor |
|---|---|
| success |
|
| message | informa sobre o status da operação |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | chave de api inválida |
Para desabilitar o uso premium para o usuário, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/app/disable_premium
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Seu Token da API>"'
| Chave | Valor |
|---|---|
| success |
|
| message | informa sobre o status da operação |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | chave de api inválida |
Para habilitar nomes de arquivos longos para o usuário, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/app/enable_long_filenames
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Seu Token da API>"'
| Chave | Valor |
|---|---|
| success |
|
| message | informa sobre o status da operação |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | chave de api inválida |
Para desabilitar nomes de arquivos longos para o usuário, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/app/disable_long_filenames
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | chave de api do usuário |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Seu Token da API>"'
| Chave | Valor |
|---|---|
| success |
|
| message | informa sobre o status da operação |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | chave de api inválida |
obter informações sobre as entradas da fila do Verificador de Qualidade, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/quality_checker/queue
| Campo | Tipo | Descrição |
|---|---|---|
| start | Inteiro | (opcional) Ponto de partida de deslocamento, padrão é 0 (ou seja, começa a partir do mais recente) |
| limit | Inteiro | (opcional) Quantidade máxima de resultados retornados, padrão é 10, máximo é 20 |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Retorna os dados como um array:
| Chave | Valor |
|---|---|
| id | Número de identificação da entrada |
| dataset_type | Tipo de conjunto de dados escolhido ao adicionar a entrada / tipo de classificação
|
| date | Data de criação da entrada |
| algo_name | Nome do tipo/algoritmo de separação utilizado |
| main_text | do tipo/algoritmo de separação utilizado |
| proc | Estado do processamento
|
| proc_remote_date | Data e hora de processamento |
| msg | "OK" se a operação for bem-sucedida, caso contrário, exibe uma mensagem de erro. |
| metrics | sobre métricas de entrada |
| sdr_* (wildcard) | SDR dos caules correspondentes |
| dataset_name | Nome do conjunto de dados |
obter informações sobre os placares do Quality Checker, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/quality_checker/leaderboard
| Campo | Tipo | Descrição |
|---|---|---|
| dataset_type | String | Tipo de conjunto de dados, o padrão é 0 se não for fornecido.
|
| start | Inteiro | (opcional) Ponto de partida de deslocamento, padrão é 0 (ou seja, começa a partir do mais recente) |
| limit | Inteiro | (opcional) Quantidade máxima de resultados retornados, padrão é 10, máximo é 20 |
| algo_name_filter | String | Filtra nomes de tipo/algoritmo de separação por texto fornecido |
| sort | String | Classifique pelo SDR fornecido do stem. Você pode obter a lista de valores classificáveis para o tipo de conjunto de dados fornecido a partir da chave sortables na resposta. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Chave | Valor |
|---|---|
| data | Contém uma matriz de entradas do Verificador de Qualidade. Consulte a seção "Resposta GET QUEUE do Verificador de Qualidade" para obter mais informações |
| dataset_type | Chave de tipo de conjunto de dados usada |
| sortables | Chaves que podem ser usadas para classificar o tipo de conjunto de dados utilizado por um determinado radical em ordem sequencial |
| sort | Usada a chave de classificação do objeto classificável. |
criar uma entrada no verificador de qualidade, você precisa fazer uma chamada POST para a seguinte URL:
https://mvsep.com/api/quality_checker/add
| Campo | Tipo | Descrição |
|---|---|---|
| api_token | String | (obrigatório) Sua chave API |
| zipfile | Binário | (obrigatório) zip a ser processado |
| algo_name | String | (obrigatório) Nome do algoritmo |
| main_text | String | (obrigatório) do algoritmo |
| dataset_type | String | Tipo de conjunto de dados. O padrão é 0.
|
| password | String | (obrigatório) para excluir algoritmo |
| ensemble | Inteiro | 0 - o algoritmo não é um ensemble. 1 - o algoritmo é um 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"'
| Chave | Valor |
|---|---|
| success |
|
| data | Contém informações sobre a entrada |
| data -> id | ID da entrada |
| data -> link | Link para a entrada |
A API de MVSEP usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | o formulário é inválido |
| 401 |
Desconhecido ou inválido api_token. Esse erro aparece se você usa uma chave de API desconhecida.
|
obter informações sobre a entrada da fila do Verificador de Qualidade pelo ID, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/quality_checker/entry
| Campo | Tipo | Descrição |
|---|---|---|
| id | Inteiro | (obrigatório) ID da entrada |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
excluir uma entrada da fila do Verificador de Qualidade por ID e senha, você precisa fazer uma chamada GET para a seguinte URL:
https://mvsep.com/api/quality_checker/delete
| Campo | Tipo | Descrição |
|---|---|---|
| id | Inteiro | (obrigatório) ID da entrada |
| password | String | (obrigatório) usada para a entrada |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Chave | Valor |
|---|---|
| success |
|
| data->message | Mostra se a entrada foi excluída |
turbo@mvsep.com