turbo@mvsep.com
Информация за сайта
Често задавани въпроси
Проверка на качеството
Алгоритми
Пълна документация на API
MVSEP API предоставя програмно достъп до създаване на разделяне, връщане на резултати, получаване на информация за сайта и управление на потребителски способности.
За да използвате този API, се нуждаете от API ключ. Не сте влезли, моля, влезте, за да получите вашия API токен.
Примери на Python: https://github.com/ZFTurbo/MVSep-API-Examples
Неофициално приложение MacVSep за Mac OS: https://github.com/septcoco/macvsep
Уеб кукички могат да се настроят тук: Страница с уебкукички
Спецификация на OpenAPI: mvsep-openapi-spec.json
Обърнете внимание, че потребителите с Premium могат да заявяват неограничен брой едновременни задачи, докато потребителите без Premium могат да заявят само 1 едновременна задача.
MVSEP runs regional API endpoints. All regions share one account database, so the same account, API key and job hashes work everywhere:
https://de.mvsep.com/apihttps://hk.mvsep.com/apiRequests to https://mvsep.com/api are geo-steered to the region nearest to the caller. For API integrations we recommend calling a regional endpoint explicitly — it keeps the whole job lifecycle on one host regardless of where your requests originate from.
Every separation is processed and stored in the region where it was created, and the download URLs returned in responses always point to that region's host. For best performance, choose the endpoint closest to your servers and use the same host for the whole job lifecycle — create, status polling and file downloads.
You can query the status of any job from any region (the database is shared), but the output files themselves are always served by the region that owns the job.
За да създадете разделяне е необходимо да последвате следния линк:
https://mvsep.com/api/separation/create
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | Вашият API ключ |
| audiofile | Двоичен | Аудиофайл за обработка. Не е необходимо, ако е зададен параметърът url или моделът не използва файлов вход. За съпоставяне на модели използвайте target_audiofile и reference_audiofile за вход вместо audiofile. |
| url | String | Връзка към аудиофайла. Не е задължително, ако е зададен параметърът audiofile. |
| remote_type | String | (по избор) Отдалечен тип на аудиофайла. По подразбиране е direct. Не е задължително, ако е зададен параметърът audiofile. Поддържаните типове са direct (Директно изтегляне), mega (MEGA), drive (Google Диск), dropbox (Dropbox). |
| sep_type | Цяло число | (optional) Вид на разделянето, 11 по подразбиране (Demucs3 Model B (вокали, барабани, бас, други)) |
| add_opt1 | String | (optional) Разделителен Вид първо допълнително поле |
| add_opt2 | String | (optional) Разделителен Вид второ допълнително поле |
| add_opt3 | String | (по избор) Тип разделяне на трето допълнително поле |
| output_format | Цяло число | (optional) изходен формат, по подразбиране 0 (mp3 (320kbps)) |
| is_demo | Булев | (optional) да се публикува ли разделеният проект на демо страницата, изключено по подразбиране |
| Име | Стойност | Допълнителни полета |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Ключ: add_opt1 Име: Output files Опции:
Ключ: add_opt2 Име: Model Type Опции:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Ключ: add_opt1 Име: Output files Опции:
Ключ: add_opt2 Име: Model Type Опции:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Ключ: add_opt1 Име: Output files Опции:
Ключ: add_opt2 Име: Model Type Опции:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Ключ: add_opt1 Име: Model type Опции:
|
| BS Roformer (vocals, instrumental) | 40 | Ключ: add_opt1 Име: Vocal model type Опции:
Ключ: add_opt2 Име: Overlap Опции:
|
| BS PolarFormer (vocals, instrumental) | 123 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: Overlap Опции:
|
| MelBand Roformer (vocals, instrumental) | 48 | Ключ: add_opt1 Име: Vocal model type Опции:
Ключ: add_opt2 Име: Overlap Опции:
|
| MDX23C (vocals, instrumental) | 25 | Ключ: add_opt1 Име: Vocal model type Опции:
|
| SCNet (vocals, instrumental) | 46 | Ключ: add_opt1 Име: Vocal model type Опции:
|
| MDX B (vocals, instrumental) | 23 | Ключ: add_opt1 Име: Vocal model type Опции:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Ключ: add_opt1 Име: Model Type Опции:
Ключ: add_opt2 Име: Agressiveness Опции:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Ключ: add_opt1 Име: Karaoke model type Опции:
Ключ: add_opt2 Име: Extraction type Опции:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Ключ: add_opt1 Име: Karaoke model type Опции:
|
| MVSep Crowd removal (crowd, other) | 34 | Ключ: add_opt1 Име: Model type Опции:
|
| Medley Vox (Multi-singer separation) | 53 | Ключ: add_opt1 Име: Model type Опции:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Ключ: add_opt1 Име: Model Type Опции:
Ключ: add_opt2 Име: Processing Mode Опции:
|
| MVSep Male/Female separation | 57 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Choir (choir, other) | 112 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Drums (drums, other) | 44 | Ключ: add_opt1 Име: Drums model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
Ключ: add_opt3 Име: Output files Опции:
|
| MVSep Bass (bass, other) | 41 | Ключ: add_opt1 Име: Bass model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
Ключ: add_opt3 Име: Output files Опции:
|
| MVSep Synth (synth, other) | 88 | Ключ: add_opt1 Име: How to extract Опции:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Ключ: add_opt1 Име: Model Type Опции:
Ключ: add_opt2 Име: Preprocess Опции:
|
| MVSep Piano (piano, other) | 29 | Ключ: add_opt1 Име: Piano model type Опции:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Ключ: add_opt1 Име: Organ model type Опции:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| MVSep Guitar (guitar, other) | 31 | Ключ: add_opt1 Име: Guitar model type Опции:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Ключ: add_opt1 Име: Model type Опции:
|
| 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 | Ключ: add_opt1 Име: String model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Cello (cello, other) | 70 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Double Bass (double-bass, other) | 73 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Wind (wind, other) | 54 | Ключ: add_opt1 Име: Wind model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
Ключ: add_opt3 Име: Output files Опции:
|
| MVSep Brass (brass, other) | 107 | Ключ: add_opt1 Име: How to extract Опции:
|
| MVSep Woodwind (woodwind, other) | 108 | Ключ: add_opt1 Име: How to extract Опции:
|
| MVSep Saxophone (saxophone, other) | 61 | Ключ: add_opt1 Име: Model type Опции:
|
| MVSep Flute (flute, other) | 67 | Ключ: add_opt1 Име: Flute model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Trumpet (trumpet, other) | 71 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Trombone (trombone, other) | 75 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Oboe (oboe, other) | 77 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Clarinet (clarinet, other) | 78 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep French Horn (french-horn, other) | 82 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Harmonica (harmonica, other) | 87 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Ключ: add_opt2 Име: How to extract Опции:
|
| 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 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Celesta (celesta, other) | 110 | Ключ: add_opt2 Име: How to extract Опции:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Ключ: add_opt1 Име: Model type Опции:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Ключ: add_opt1 Име: Model Type Опции:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: How to extract Опции:
Ключ: add_opt3 Име: Output files Опции:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: Cutoff (Hz) Опции:
|
| Reverb Removal (noreverb) | 22 | Ключ: add_opt1 Име: Model Type Опции:
Ключ: add_opt2 Име: Preprocess Опции:
|
| DeNoise by aufr33 and gabox | 47 | Ключ: add_opt1 Име: Model type Опции:
|
| AudioSR (Super Resolution) | 59 | Ключ: add_opt1 Име: Cutoff (Hz) Опции:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Ключ: add_opt1 Име: Text prompt Опции: Ключ: add_opt2 Име: Length (in seconds) Опции:
|
| Whisper (extract text from audio) | 39 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: Transcription type Опции:
|
| Parakeet (extract text from audio) | 64 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: Version Опции:
|
| VibeVoice (Voice Cloning) | 103 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: Text prompt Опции: Ключ: add_opt3 Име: Extract vocals first Опции:
|
| VibeVoice (TTS) | 104 | Ключ: add_opt1 Име: Model type Опции:
Ключ: add_opt2 Име: Text prompt Опции: |
| Qwen3-TTS (Custom Voice) | 118 | Ключ: add_opt1 Име: Text prompt Опции: Ключ: add_opt2 Име: Speaker Опции:
Ключ: add_opt3 Име: Language Опции:
Ключ: add_opt4 Име: Voice description Опции: |
| Qwen3-TTS (Voice Design) | 119 | Ключ: add_opt1 Име: Text prompt Опции: Ключ: add_opt2 Име: Voice description Опции: Ключ: add_opt3 Име: Language Опции:
|
| Qwen3-TTS (Voice Cloning) | 120 | Ключ: add_opt1 Име: Text prompt Опции: Ключ: add_opt2 Име: Reference text in audio (optional) Опции: Ключ: add_opt3 Име: Language Опции:
Ключ: add_opt4 Име: Extract vocals first Опции:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | Ключ: add_opt1 Име: Text prompt Опции: Ключ: add_opt2 Име: Speaker Опции:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Ключ: add_opt1 Име: Model Type Опции:
|
| Aspiration (by Sucial) | 50 | Ключ: add_opt1 Име: Model type Опции:
|
| Phantom Centre extraction | 55 | Ключ: add_opt1 Име: Model type Опции:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Ключ: add_opt1 Име: How to use Опции:
|
| Transkun (Piano -> MIDI) | 113 | Ключ: add_opt1 Име: How to extract Опции:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Ключ: add_opt1 Име: How to extract Опции:
|
| HeartMuLa (Song Gen) | 121 | Ключ: add_opt1 Име: Lyrics Опции: Ключ: add_opt10 Име: Topic Опции:
Ключ: add_opt2 Име: Tags (optional) Опции: Ключ: add_opt3 Име: Genre Опции:
Ключ: add_opt4 Име: Timbre Опции:
Ключ: add_opt5 Име: Gender Опции:
Ключ: add_opt6 Име: Mood Опции:
Ключ: add_opt7 Име: Instrument Опции:
Ключ: add_opt8 Име: Scene Опции:
Ключ: add_opt9 Име: Region Опции:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Ключ: add_opt1 Име: Model type Опции:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Ключ: add_opt1 Име: Vocal model type Опции:
|
| Vit Large 23 (vocals, instrum) | 33 | Ключ: add_opt1 Име: Model type Опции:
|
| UVRv5 Demucs (vocals, music) | 17 | Ключ: add_opt1 Име: Model Type Опции:
|
| 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 | Ключ: add_opt1 Име: Model type Опции:
|
| UnMix | 3 | Ключ: add_opt1 Име: Model type Опции:
|
| Zero Shot (Query Based) (Low quality) | 14 | Ключ: add_opt1 Име: Model Type Опции:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Ключ: add_opt1 Име: Model type Опции:
|
| Име | Стойност |
|---|---|
| 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="<Вашият API токен>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Ключ | Стойност |
|---|---|
| success |
|
| data | Съхранява допълнителна информация в зависимост от ключа „success“. |
| data -> link | Показва връзка към URL адреса „GET RESULT“ на създадената задача (показва се само когато success is true) |
| data -> hash | Displays the created job hash (показва се само когато success is true) |
| data -> message | Показва описанието на дадена грешка (показва се само когато success is false) |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Някои параметри липсват или са невалидни. Тази грешка се появява, когато не подадете всички задължителни параметри или подадените параметри са невалидни. |
| 401 |
Неизвестен или невалиден api_token. Тази грешка се появява ако сте използвали неизвестен API ключ
|
За да получите своя резултат е необходимо да последвате следния линк:
https://mvsep.com/api/separation/get
| Неуспешен опит | Вид | Описание |
|---|---|---|
| hash | String | Хеш за разделяне |
| mirror | Цяло число | (по избор) Използва друго огледало, ако е зададено на 1, по подразбиране е 0. Изисква api_token и 1 кредит, ако е зададено на 1. |
| api_token | String | (по избор) API ключ на потребителя. Задължително, ако параметърът mirror е зададен на 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Ключ | Стойност |
|---|---|
| success |
|
| status |
|
| data | Съдържа допълнителна информация в зависимост от ключа status |
| data -> queue_count | Показва броя на необработените задачи в приоритета на потребителя (показва се само когато status е waiting или distributing) |
| data -> current_order | Показва реда на задачата на потребителя (показва се само когато status е waiting или distributing) |
| data -> message | Показва описанието на статуса (показва се при всички статуси, показва причината за грешка, когато status е failed) |
| data -> algorithm | Показва използвания алгоритъм за задачата (показва се само когато status е done) |
| data -> algorithm_description | Показва детайли за използвания алгоритъм за задачата (показва се само когато status е done) |
| data -> output_format | Показва изходния формат на задачата (показва се само когато status е done) |
| data -> tags | Показва мета таговете на аудиото (показва се само когато status е done) |
| data -> input_file | Показва детайли за изтегляне на входното аудио (показва се само когато status е done) |
| data -> files | Показва детайли за изтегляне на изходните аудиофайлове (показва се само когато status е done) |
| data -> date | Показва датата на обработка на задачата (показва се само когато status е done) |
| data -> finished_chunks | Показва броя на завършените части от голямата задача (показва се само когато status е distributing) |
| data -> all_chunks | Показва броя на всички части от голямата задача (показва се само когато status е distributing) |
За да получите резултата от отдалечена задача, трябва да направите GET повикване към следния URL адрес:
https://mvsep.com/api/separation/get-remote
| Неуспешен опит | Вид | Описание |
|---|---|---|
| hash | String | Хеш за разделяне |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Ключ | Стойност |
|---|---|
| success |
|
| status |
|
| data | Съдържа допълнителна информация в зависимост от ключа status |
| data -> queue_count | Показва броя на необработените задачи в приоритета на потребителя (показва се само когато status е waiting). |
| data -> current_order | Показва реда на задачата на потребителя (показва се само когато статус е изчакване). |
| data -> message | Показва описанието на състоянието (само когато състоянието е неуспешно). |
| data -> link | Показва връзка към URL адреса „ПОЛУЧИ РЕЗУЛТАТ“ на създадената задача (показва се само когато статусът е готово). |
| data -> hash | Хеш на разделянето (показва се само когато status е done). |
За да отмените разделянето и да възстановите използваните кредити (ако разделянето все още не се обработва), трябва да направите POST повикване към следния URL адрес:
https://mvsep.com/api/separation/cancel
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
| hash | String | Хеш за разделяне |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Вашият API токен>"' --form 'hash="<hash>"'
| Ключ | Стойност |
|---|---|
| success |
|
За да получите подробни данни за типове разделяне, трябва да извършите GET заявка към следния URL:
https://mvsep.com/api/app/algorithms
| Неуспешен опит | Вид | Описание |
|---|---|---|
| scopes | String | Дали да се включат модели, които използват различни форми на въвеждане.
single_upload, ако не е предоставено. За да получите всички модели, задайте scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Връща данни като масив:
| Ключ | Стойност |
|---|---|
| render_id | Стойност на типа разделяне (ID) |
| name | Името на типа разделяне |
| algorithm_group_id | Групата, към която принадлежи типът разделяне: |
| algorithm_group | Съдържа информация за групата алгоритми, към която принадлежи алгоритъмът. |
| algorithm_group -> name | Име на групата алгоритми. |
| audio_widget |
Типът аудио уиджет, който да се използва за алгоритъма. Това може да се използва за определяне как да се показва аудио плейърът за алгоритъма във фронтенда. Възможните стойности са:
|
| orientation |
За кого е предназначен този тип разделяне:
|
| order_id | Редът на типа разделяне |
| price_coefficient |
Използва се за изчисляване на колко кредити ще отнеме задачата от премиум потребителя. Използва следната формула : floor(<продължителност на аудиофайла в секунди> * price_coefficient / 60)?:1
|
| usage | Показва месечния брой на използваните видове разделяне |
| rating | Показва месечната оценка за използване на типа разделяне като масив:
|
| algorithm_fields | Ще трябва да изпратите разделяне с това име, за да изберете правилното допълнително поле. |
| algorithm_fields -> name |
Показва кое допълнително поле на типа разделяне:
|
| algorithm_fields -> text | Показване на името на допълнителното поле на типа разделяне. |
| algorithm_fields -> options | JSON кодирани ключ-стойност вериги на допълнителното поле |
| algorithm_fields -> default_key | По подразбиране стойност на допълнителното поле. Една от ключовете на <code>algorithm_fields -> options</code> |
| algorithm_descriptions | Съдържа информация за описанията на типа разделяне |
| algorithm_descriptions -> short_description | Кратко описание на типа разделяне, което не използва HTML. |
| algorithm_descriptions -> long_description | Подробно описание на типа разделяне, което използва HTML. |
| algorithm_descriptions -> lang | Специфициран езиков код на описанието. |
За да получите информация за последните новини за MVSEP, трябва да извършите GET заявка към следния URL:
https://mvsep.com/api/app/news
| Неуспешен опит | Вид | Описание |
|---|---|---|
| lang | String | (по избор) 2-символен езиков код (en, ru) |
| start | Цяло число | (по избор) Начален офсет, по подразбиране е 0 (т.е. започва от последните новини) |
| limit | Цяло число | (по избор) Максимален брой резултати, по подразбиране 10, максимален брой 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Връща данни като масив:
| Ключ | Стойност |
|---|---|
| title | Заглавие на новината. |
| lang | Заглавие на новината. |
| text | Пълно описание на новината |
| created_at | Дата на новината |
За да получите информация за опашката на сайта, трябва да направите GET повикване към следния URL адрес:
https://mvsep.com/api/app/queue
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | (по избор) API ключ на потребителя |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Ключ | Стойност |
|---|---|
| queue |
Съдържа масив от текущи опашки за различни планове:
|
| plan |
Съдържа текущата опашка за текущия план (добавете api_token към заявката за регистриран/премиум план):
|
За да получите информация за демо разделянията, трябва да направите "GET" повикване на следния URL адрес:
https://mvsep.com/api/app/demo
| Неуспешен опит | Вид | Описание |
|---|---|---|
| start | Цяло число | (по избор) Начален офсет, по подразбиране е 0 (т.е. започва от последните новини) |
| limit | Цяло число | (по избор) Максимален брой резултати, по подразбиране 10, максимален брой 20. |
| algorithm_id | Цяло число | Незадължителен идентификатор на типа разделяне. Използвайте това, за да върнете демо разделяния, създадени само от един алгоритъм. Стойностите съответстват на render_id от крайната точка GET SEPARATION TYPES. |
| options[FIELD] | Низ / Цяло число | Незадължителен филтър за стойности на опции за алгоритъм. Заменете FIELD с допълнителен ключ на поле от algorithm_fields -> name в отговора GET SEPARATION TYPES, след което предайте един от ключовете options на това поле като стойност. Пример: options[vocals]=1. |
| additional_options | String | Незадължителният суров файл съдържа филтър спрямо съхранените данни за опции за работа. Предпочитайте options[FIELD] за нови интеграции, защото е изричен и по-лесен за съставяне. |
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'
За да създадете филтри за опции, първо извикайте https://mvsep.com/api/app/algorithms и проверете списъка algorithm_fields на всеки алгоритъм. Използвайте полето name вътре в options[FIELD] и използвайте един от JSON ключовете за опции като стойност.
Връща данни като масив:
| Ключ | Стойност |
|---|---|
| hash | Хеш за разделяне |
| date | Дата на раздялата. |
| input_audio | URL адресът на входното аудио |
| size | Размерът на входното аудио. |
| algorithm | Съдържа основна информация за използвания тип разделяне (за информация относно върнатите параметри вижте раздела GET SEPARATION TYPES). |
За да удостоверите потребителя и да получите API ключ на потребителя, трябва да направите "POST" извикване на следния URL адрес:
https://mvsep.com/api/app/login
| Неуспешен опит | Вид | Описание |
|---|---|---|
| String | Имейл адрес на потребителя | |
| password | String | Парола на потребителя |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Имейл адрес на потребителя>"' --form 'password="<Парола на потребителя>"'
| Ключ | Стойност |
|---|---|
| success |
|
| data | Съдържа информация, когато пълномощията са валидни |
| data -> name | Име на потребителя |
| data -> email | Имейл адрес на потребителя |
| data -> api_token | API ключ на потребителя. Уверете се, че го съхранявате в сигурно място и го използвате за последващи операции. |
| data -> premium_minutes | Кредити, останали за потребителя |
| data -> premium_enabled |
Дали потребителят разрешава разходването на кредити.
|
| data -> long_filenames_enabled |
Дали потребителят иска допълнителна информация в имената на файловете:
|
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалидни данни за удостоверяване |
За да регистрирате потребител в сайта MVSEP, трябва да извършите POST заявка към следния URL:
https://mvsep.com/api/app/register
| Неуспешен опит | Вид | Описание |
|---|---|---|
| name | String | Име на потребителя |
| String | Имейл адрес на потребителя | |
| password | String | Парола на потребителя |
| password_confirmation | String | Повторете паролата на потребителя |
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"'
| Ключ | Стойност |
|---|---|
| success |
|
| message | Настъпва, когато формата е валидна |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Формата е невалидна |
За да получите информация за потребителя, трябва да извършите GET заявка към следния URL:
https://mvsep.com/api/app/user
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Вашият API токен>'
| Ключ | Стойност |
|---|---|
| success |
|
| data | Съдържа информация, когато пълномощията са валидни |
| data -> name | Име на потребителя |
| data -> email | Имейл адрес на потребителя |
| data -> api_token | API ключ на потребителя. Уверете се, че го съхранявате в сигурно място и го използвате за последващи операции. |
| data -> premium_minutes | Кредити, останали за потребителя |
| data -> premium_enabled |
Дали потребителят разрешава разходването на кредити.
|
| data -> long_filenames_enabled |
Дали потребителят иска допълнителна информация в имената на файловете:
|
| data -> current_queue | Показва текущи разделяния за потребителя |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалиден API ключ |
За да получите основна информация за историята на разделяне на потребителя, трябва да извършите GET заявка към следния URL:
https://mvsep.com/api/app/separation_history
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
| start | Цяло число | (по избор) Начален офсет, по подразбиране е 0 (т.е. започва от последните новини) |
| limit | Цяло число | (по избор) Максимален брой резултати, по подразбиране 10, максимален брой 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Вашият API токен>&start=1&limit=2'
| Ключ | Стойност |
|---|---|
| success |
|
| data | Съдържа основна информация в масив за предишни разделяния |
| data -> hash | Хеш за разделяне |
| data -> job_exists | Съдържа основна информация в масив за предишни разделяния |
| data -> credits | Колко кредити са използвани за задачата, null ако разделянето не съществува |
| data -> time_left | Приблизително време до изтриването на задачата |
| data -> algorithm | Съдържа основна информация за използвания тип разделяне (за информация относно върнатите параметри вижте раздела GET SEPARATION TYPES). |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалиден API ключ |
За да активирате премиум използването за потребителя, трябва да извършите POST заявка към следния URL:
https://mvsep.com/api/app/enable_premium
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Вашият API токен>"'
| Ключ | Стойност |
|---|---|
| success |
|
| message | Информира за статуса на операцията |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалиден API ключ |
За да деактивирате използването на Premium за потребителя, трябва да направите POST повикване към следния url адрес:
https://mvsep.com/api/app/disable_premium
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Вашият API токен>"'
| Ключ | Стойност |
|---|---|
| success |
|
| message | Информира за статуса на операцията |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалиден API ключ |
За да активирате дългите имена на файлове за потребителя, трябва да направите POST повикване към следния url адрес:
https://mvsep.com/api/app/enable_long_filenames
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Вашият API токен>"'
| Ключ | Стойност |
|---|---|
| success |
|
| message | Информира за статуса на операцията |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалиден API ключ |
За да забраните дългите имена на файлове за потребителя, трябва да направите POST повикване към следния url адрес:
https://mvsep.com/api/app/disable_long_filenames
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | API ключ на потребителя |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Вашият API токен>"'
| Ключ | Стойност |
|---|---|
| success |
|
| message | Информира за статуса на операцията |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Невалиден API ключ |
За да получите информация за записите в опашката на Quality Checker, трябва да направите GET повикване към следния URL адрес:
https://mvsep.com/api/quality_checker/queue
| Неуспешен опит | Вид | Описание |
|---|---|---|
| start | Цяло число | (по избор) Начален офсет, по подразбиране е 0 (т.е. започва от последните новини) |
| limit | Цяло число | (по избор) Максимален брой резултати, по подразбиране 10, максимален брой 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Връща данни като масив:
| Ключ | Стойност |
|---|---|
| id | Идентификационен номер на записа |
| dataset_type | Типът набор от данни, избран при добавяне на записа / типа класация
|
| date | Дата на създаване на записа |
| algo_name | Име на използвания тип/алгоритъм за разделяне |
| main_text | Описание на използвания тип/алгоритъм за разделяне |
| proc | Статус на обработката
|
| proc_remote_date | Временна маркировка на датата на обработка |
| msg | Връща „OK“ при успех, в противен случай показва съобщение за грешка |
| metrics | Информация за показателите за влизане |
| sdr_* (wildcard) | SDR на съответните стъбла |
| dataset_name | Име на набора от данни |
За да получите информация за класациите на Quality Checker, трябва да направите GET повикване към следния URL адрес:
https://mvsep.com/api/quality_checker/leaderboard
| Неуспешен опит | Вид | Описание |
|---|---|---|
| dataset_type | String | Тип на набора от данни, по подразбиране е 0, ако не е зададен.
|
| start | Цяло число | (по избор) Начален офсет, по подразбиране е 0 (т.е. започва от последните новини) |
| limit | Цяло число | (по избор) Максимален брой резултати, по подразбиране 10, максимален брой 20. |
| algo_name_filter | String | Филтрира имената на типа/алгоритъма за разделяне по даден текст |
| sort | String | Сортиране по даден SDR на ствола. Можете да получите списък с сортируеми стойности за даден тип набор от данни от ключа sortables в отговора. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Ключ | Стойност |
|---|---|
| data | Съдържа масив от записи за проверка на качеството. Вижте раздела „GET QUEUE отговор от проверката на качеството“ за повече информация. |
| dataset_type | Използван ключ за тип набор от данни |
| sortables | Ключове, които могат да се използват за сортиране на използвания тип набор от данни по даден stem в последователен ред. |
| sort | Използван е ключ за сортиране от сортируемо. |
За да създадете запис в Quality Checker, трябва да направите POST повикване към следния URL адрес:
https://mvsep.com/api/quality_checker/add
| Неуспешен опит | Вид | Описание |
|---|---|---|
| api_token | String | (задължително) Вашият API ключ |
| zipfile | Двоичен | (задължително) Zip файл за обработка |
| algo_name | String | (задължително) Име на алгоритъма |
| main_text | String | (задължително) Описание на алгоритъма |
| dataset_type | String | Тип набор от данни. По подразбиране е 0.
|
| password | String | (задължително) Парола за изтриване на алгоритъм |
| ensemble | Цяло число | 0 - алгоритъмът не е ансамбъл. 1 - алгоритъмът е ансамбъл |
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"'
| Ключ | Стойност |
|---|---|
| success |
|
| data | Съдържа информация за записа |
| data -> id | Идентификационен номер на записа |
| data -> link | Връзка към публикацията |
MVSEP API използва следният код за наизправност:
| Код за неизправност | Значение |
|---|---|
| 400 | Формата е невалидна |
| 401 |
Неизвестен или невалиден api_token. Тази грешка се появява ако сте използвали неизвестен API ключ
|
За да получите информация за запис в опашката на Quality Checker по идентификатор, трябва да направите GET повикване към следния URL адрес:
https://mvsep.com/api/quality_checker/entry
| Неуспешен опит | Вид | Описание |
|---|---|---|
| id | Цяло число | (задължително) Идентификационен номер на записа |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
За да изтриете запис от опашката на Quality Checker чрез идентификатор и парола, трябва да направите GET повикване към следния URL адрес:
https://mvsep.com/api/quality_checker/delete
| Неуспешен опит | Вид | Описание |
|---|---|---|
| id | Цяло число | (задължително) Идентификационен номер на записа |
| password | String | (задължително) Използвана е парола за входа |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Ключ | Стойност |
|---|---|
| success |
|
| data->message | Показва дали записът е бил изтрит |
turbo@mvsep.com
Често задавани въпроси
Проверка на качеството
Алгоритми
Пълна документация на API