turbo@mvsep.com
MVSEP API, ayırma oluşturmak, sonuçları döndürmek, site bilgilerini almak ve kullanıcı yeteneklerini kontrol etmek için programlı erişim sağlar.
Bu API'yi kullanmak için bir API anahtarına ihtiyacınız vardır. Giriş yapmadınız, lütfen API token'ınızı almak için giriş yapın.
Examples in Python: https://github.com/ZFTurbo/MVSep-API-Examples
Unofficial application MacVSep for Mac OS: https://github.com/septcoco/macvsep
Webhooks can be setup here: Webhooks Page
Premium kullanıcılarının 10'a kadar eşzamanlı iş talep edebileceğini, Premium olmayan kullanıcıların ise yalnızca 1 eşzamanlı iş talep edebileceğini unutmayın.
Ayırma oluşturmak için aşağıdaki URL'ye bir POST çağrısı yapmanız gerekir:
https://mvsep.com/api/separation/create
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | API anahtarın |
| audiofile | Binary | İşlenecek ses dosyası. Not required if url parameter is set |
| url | String | Link to the audiofile. Not required if audiofile parameter is set |
| remote_type | String | (optional) Remote type of the audiofile. Defaults to direct. Not required if audiofile parameter is set. Supported types are direct (Direct Download), mega (MEGA), drive (Google Drive), dropbox (Dropbox) |
| sep_type | Integer | (isteğe bağlı) Ayırma Türü, varsayılan olarak 11'dir (Demucs3 Model B (vocals, drums, bass, other)) |
| add_opt1 | String | (isteğe bağlı) Ayırma Türü ilk ek alan |
| add_opt2 | String | (isteğe bağlı) Ayırma Türü ikinci ek alan |
| add_opt3 | String | (isteğe bağlı) Ayırma Türü üçüncü ek alan |
| output_format | Integer | (isteğe bağlı) sonuç formatı, varsayılan olarak 0 (MP3 (320kbps)) |
| is_demo | Boolean | (isteğe bağlı) ayırmanın demo sayfasında yayınlanması durumunda varsayılan değer false olur |
| isim | Değer | Additional fields |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Key: add_opt1 Name: Output files Options:
Key: add_opt2 Name: Model Type Options:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Key: add_opt1 Name: Output files Options:
Key: add_opt2 Name: Model Type Options:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Key: add_opt1 Name: Output files Options:
Key: add_opt2 Name: Model Type Options:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| BS Roformer (vocals, instrumental) | 40 | Key: add_opt1 Name: Vocal model type Options:
|
| MelBand Roformer (vocals, instrumental) | 48 | Key: add_opt1 Name: Vocal model type Options:
|
| MDX23C (vocals, instrumental) | 25 | Key: add_opt1 Name: Vocal model type Options:
|
| SCNet (vocals, instrumental) | 46 | Key: add_opt1 Name: Vocal model type Options:
|
| Demucs4 HT (vocals, drums, bass, other) | 20 | Key: add_opt1 Name: Model type Options:
|
| MDX B (vocals, instrumental) | 23 | Key: add_opt1 Name: Vocal model type Options:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Key: add_opt1 Name: Model Type Options:
Key: add_opt2 Name: Agressiveness Options:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MelBand Karaoke (lead/back vocals) | 49 | Key: add_opt1 Name: Karaoke model type Options:
Key: add_opt2 Name: Extraction type Options:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Key: add_opt1 Name: Karaoke model type Options:
|
| MVSep Piano (piano, other) | 29 | Key: add_opt1 Name: Piano model type Options:
|
| MVSep Guitar (guitar, other) | 31 | Key: add_opt1 Name: Guitar model type Options:
|
| MVSep Bass (bass, other) | 41 | Key: add_opt1 Name: Bass model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| MVSep Drums (drums, other) | 44 | Key: add_opt1 Name: Drums model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| MVSep Strings (strings, other) | 52 | |
| MVSep Wind (wind, other) | 54 | Key: add_opt1 Name: Wind model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| MVSep Organ (organ, other) | 58 | Key: add_opt1 Name: Organ model type Options:
|
| MVSep Saxophone (saxophone, other) | 61 | Key: add_opt1 Name: Model type Options:
|
| MVSep Violin (violin, other) | 65 | |
| Apollo Enhancers (by JusperLee and Lew) | 51 | Key: add_opt1 Name: Model type Options:
|
| Reverb Removal (noreverb) | 22 | Key: add_opt1 Name: Model Type Options:
Key: add_opt2 Name: Preprocess Options:
|
| MVSep Crowd removal (crowd, other) | 34 | Key: add_opt1 Name: Model type Options:
|
| MVSep Demucs4HT DNR (dialog, sfx, music) | 24 | Key: add_opt1 Name: Model type Options:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Key: add_opt1 Name: Model Type Options:
|
| MVSep DnR v3 (speech, music, sfx) | 56 | Key: add_opt1 Name: Model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Key: add_opt1 Name: Model Type Options:
Key: add_opt2 Name: Preprocess Options:
|
| DeNoise by aufr33 | 47 | Key: add_opt1 Name: Model type Options:
|
| Whisper (extract text from audio) | 39 | Key: add_opt1 Name: Model type Options:
Key: add_opt2 Name: Transcription type Options:
|
| Parakeet (extract text from audio) | 64 | Key: add_opt1 Name: Model type Options:
|
| Medley Vox (Multi-singer separation) | 53 | Key: add_opt1 Name: Model type Options:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Key: add_opt1 Name: Model Type Options:
|
| MVSep Male/Female separation | 57 | Key: add_opt1 Name: Model type Options:
Key: add_opt2 Name: How to extract Options:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Key: add_opt1 Name: Vocal model type Options:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Key: add_opt1 Name: Model type Options:
|
| Vit Large 23 (vocals, instrum) | 33 | Key: add_opt1 Name: Model type Options:
|
| UVRv5 Demucs (vocals, music) | 17 | Key: add_opt1 Name: Model Type Options:
|
| MVSep DNR (music, sfx, speech) | 18 | |
| MVSep 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 | Key: add_opt1 Name: Model type Options:
|
| UnMix | 3 | Key: add_opt1 Name: Model type Options:
|
| Zero Shot (Query Based) (Low quality) | 14 | Key: add_opt1 Name: Model Type Options:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Key: add_opt1 Name: Model type Options:
|
| Stable Audio Open Gen | 62 | Key: add_opt1 Name: Text prompt Options: Key: add_opt2 Name: Length (in seconds) Options:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Key: add_opt1 Name: Model Type Options:
|
| Aspiration (by Sucial) | 50 | Key: add_opt1 Name: Model type Options:
|
| AudioSR (Super Resolution) | 59 | Key: add_opt1 Name: Cutoff (Hz) Options:
|
| Phantom Centre extraction (by wesleyr36) | 55 | |
| FlashSR (Super Resolution) | 60 |
| isim | Değer |
|---|---|
| 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 Tokeniniz>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Anahtar | Değer |
|---|---|
| success |
|
| data | Başarı anahtarına bağlı olarak ek bilgi tutar |
| data -> link | Oluşturulan işin "GET RESULT" URL'sine bağlantıyı gösterir (sadece success true olduğunda gösterilir) |
| data -> hash | Oluşturulan iş karmasını gösterir (sadece success true olduğunda gösterilir) |
| data -> message | Bir hatanın açıklamasını gösterir (sadece success false olduğunda gösterilir) |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Bazı parametreler eksik veya geçersiz. Bu hata, tüm zorunlu parametreleri geçmediğinizde veya geçersiz parametreleri geçirmediğinizde ortaya çıkar. |
| 401 |
Bilinmeyen veya geçersiz api_token. Bilinmeyen bir API anahtarı kullanırsanız bu hata görünür
|
Ayırma sonucunu almak için aşağıdaki URL'ye bir GET çağrısı yapmanız gerekir:
https://mvsep.com/api/separation/get
| Saha | Tip | Açıklama |
|---|---|---|
| hash | String | Ayırma Hash |
| mirror | Integer | (isteğe bağlı) 1 olarak ayarlanırsa başka bir ayna kullanır, varsayılanı 0'dır. 1 olarak ayarlanırsa api_token ve 1 kredi gerektirir. |
| api_token | string | (isteğe bağlı) Kullanıcının API anahtarı. Mirror parametresi 1 olarak ayarlandığında gereklidir. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Anahtar | Değer |
|---|---|
| success |
|
| status |
|
| data | Durum anahtarına bağlı olarak ek bilgi tutar |
| data -> queue_count | Kullanıcının önceliğindeki işlenmemiş iş sayısını gösterir (sadece durum bekliyor veya dağıtılıyor olduğunda gösterilir) |
| data -> current_order | Kullanıcının işinin sırasını gösterir (sadece durum bekliyor veya dağıtılıyor olduğunda gösterilir) |
| data -> message | Durumun açıklamasını gösterir (tüm durumlarda gösterilir, durum başarısız olduğunda bunun yerine hata nedenini gösterir) |
| data -> algorithm | İş üzerinde kullanılan algoritmayı gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> algorithm_description | İş üzerinde kullanılan algoritma ayrıntılarını gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> output_format | İşin çıktı biçimini gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> tags | Ses meta etiketlerini gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> input_file | Giriş ses indirme ayrıntılarını gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> files | Çıkış seslerinin indirme ayrıntılarını gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> date | İş işleme tarihini gösterir (sadece durum tamamlandı olduğunda gösterilir) |
| data -> finished_chunks | Büyük bir işin tamamlanmış parça sayısını gösterir (sadece durum dağıtılıyor olduğunda gösterilir) |
| data -> all_chunks | Büyük bir işin tüm parçalarının sayısını gösterir (sadece durum dağıtılıyor olduğunda gösterilir) |
To get the result of remote job, you need to make a GET call to the following url:
https://mvsep.com/api/separation/get-remote
| Saha | Tip | Açıklama |
|---|---|---|
| hash | String | Ayırma Hash |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Anahtar | Değer |
|---|---|
| success |
|
| status |
|
| data | Durum anahtarına bağlı olarak ek bilgi tutar |
| data -> queue_count | Shows unprocessed jobs count in user's priority (only shown when status is waiting) |
| data -> current_order | Shows the order of user's job (only shown when status is waiting) |
| data -> message | Shows the description of status (only when status is failed) |
| data -> link | Shows link to "GET RESULT" URL of created job (only shown when status is done) |
| data -> hash | Hash of the separation (only shown when status is done) |
To cancel the separation and refund used credits (if the separation is not being processed yet), you need to make a POST call to the following url:
https://mvsep.com/api/separation/cancel
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | string | Kullanıcının API anahtarı |
| hash | string | Ayırma Hash |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<API Tokeniniz>"' --form 'hash="<hash>"'
| Anahtar | Değer |
|---|---|
| success |
|
Ayrım türleri hakkında detaylı veri almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/algorithms
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Verileri bir dizi olarak döndürür:
| Anahtar | Değer |
|---|---|
| render_id | Ayırma türü değeri (ID) |
| name | Ayırma türünün adı |
| algorithm_group_id |
Ayrım türünün ait olduğu grup:
|
| orientation |
Bu ayrılık türü kimler için tasarlanmıştır:
|
| order_id | Ayırma türünün sırası |
| price_coefficient |
İşin premium kullanıcıdan ne kadar kredi aldığını hesaplamak için kullanılır. Özet: Bu formülü kullanır : floor(<Ses dosyasının saniye cinsinden süresi> * price_coefficient / 60)?:1
|
| usage | Shows monthly usage count of separation type |
| rating | Shows monthly usage rating of separation type as array:
|
| algorithm_fields | Ayrım türünün ek alanları hakkında bilgi içerir |
| algorithm_fields -> name |
Ayrım türünün hangi ek alanını gösterir:
|
| algorithm_fields -> text | Ayırma türünün ek alanının görünen adı. |
| algorithm_fields -> options | Ek alanın JSON kodlu anahtar-değer zincirleri |
| algorithm_fields -> default_key | Ek alanın varsayılan değeri. <code>algorithm_fields -> options</code> anahtarlarından biri |
| algorithm_descriptions | Ayırma türünün açıklamaları hakkında bilgi içerir |
| algorithm_descriptions -> short_description | HTML kullanmayan ayırma türünün kısa açıklaması. |
| algorithm_descriptions -> long_description | HTML kullanan ayırma türünün detaylı açıklaması. |
| algorithm_descriptions -> lang | Açıklamanın belirtilen dil kodu. |
MVSEP ile ilgili son haberler hakkında bilgi almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/news
| Saha | Tip | Açıklama |
|---|---|---|
| lang | String | (isteğe bağlı) 2 harfli dil kodu (en, ru) |
| start | Integer | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Integer | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Verileri bir dizi olarak döndürür:
| Anahtar | Değer |
|---|---|
| title | Haberin başlığı |
| lang | Haberin başlığı |
| text | Haberlerin tam açıklaması |
| created_at | Haberin tarihi |
To get site queue information, you need to make a GET call to the following url:
https://mvsep.com/api/app/queue
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | (optional) Kullanıcının API anahtarı |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Anahtar | Değer |
|---|---|
| queue |
Contains array of current queues for different plans:
|
| plan |
Contains current queue for current plan (add api_token to request for registered/premium plan):
|
Demo ayrımları hakkında bilgi almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/demo
| Saha | Tip | Açıklama |
|---|---|---|
| start | Integer | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Integer | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
curl --location --request GET 'https://mvsep.com/api/app/demo?start=0&limit=2'
Verileri bir dizi olarak döndürür:
| Anahtar | Değer |
|---|---|
| hash | Ayırma Hash |
| date | Ayrılık tarihi |
| input_audio | Ses URL'sini girin |
| size | Giriş ses boyutu |
| algorithm | Kullanılan ayırma türü hakkında temel bilgileri içerir (dönen parametreler hakkında bilgi için GET SEPARATION TYPES sekmesine bakın) |
Kullanıcı doğrulamak ve kullanıcının API anahtarını almak için aşağıdaki URL'ye bir POST çağrısı yapmanız gerekir:
https://mvsep.com/api/app/login
| Saha | Tip | Açıklama |
|---|---|---|
| String | Kullanıcının e-postası | |
| password | String | Kullanıcının şifresi |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Kullanıcının e-postası>"' --form 'password="<Kullanıcının şifresi>"'
| Anahtar | Değer |
|---|---|
| success |
|
| data | Kimlik bilgilerinin geçerli olduğu durumlarda bilgi içerir |
| data -> name | Kullanıcının adı |
| data -> email | Kullanıcının e-postası |
| data -> api_token | Kullanıcının API anahtarı. Bunu güvenli bir yerde sakladığınızdan ve sonraki işlemler için kullandığınızdan emin olun. |
| data -> premium_minutes | Kullanıcıya bırakılan krediler |
| data -> premium_enabled |
Kullanıcının kredilerin harcanmasına izin verip vermediği.
|
| data -> long_filenames_enabled |
Kullanıcının dosya adlarında ekstra bilgi isteyip istemediği:
|
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Hatalı kimlik bilgileri belirtildi |
MVSEP sitesine kullanıcı kaydetmek için aşağıdaki URL'ye bir POST çağrısı yapmanız gerekiyor :
https://mvsep.com/api/app/register
| Saha | Tip | Açıklama |
|---|---|---|
| name | String | Kullanıcının adı |
| String | Kullanıcının e-postası | |
| password | String | Kullanıcının şifresi |
| password_confirmation | String | Kullanıcının şifresini tekrarlayın |
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"'
| Anahtar | Değer |
|---|---|
| success |
|
| message | Form geçerli olduğunda oluşur |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Form geçersiz |
Kullanıcı bilgilerini almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/user
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | Kullanıcının API anahtarı |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<API Tokeniniz>'
| Anahtar | Değer |
|---|---|
| success |
|
| data | Kimlik bilgilerinin geçerli olduğu durumlarda bilgi içerir |
| data -> name | Kullanıcının adı |
| data -> email | Kullanıcının e-postası |
| data -> api_token | Kullanıcının API anahtarı. Bunu güvenli bir yerde sakladığınızdan ve sonraki işlemler için kullandığınızdan emin olun. |
| data -> premium_minutes | Kullanıcıya bırakılan krediler |
| data -> premium_enabled |
Kullanıcının kredilerin harcanmasına izin verip vermediği.
|
| data -> long_filenames_enabled |
Kullanıcının dosya adlarında ekstra bilgi isteyip istemediği:
|
| data -> current_queue | Kullanıcı için devam eden ayrılıkları gösterir |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
Kullanıcının temel bilgi ayırma geçmişini almak için, aşağıdaki URL'ye bir GET çağrısı yapmanız gerekir
https://mvsep.com/api/app/separation_history
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | Kullanıcının API anahtarı |
| start | Integer | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Integer | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<API Tokeniniz>&start=1&limit=2'
| Anahtar | Değer |
|---|---|
| success |
|
| data | Önceki ayrılıklara ilişkin temel bilgi dizisini içerir |
| data -> hash | Ayırma Hash |
| data -> job_exists | Önceki ayrılıklara ilişkin temel bilgi dizisini içerir |
| data -> credits | İş için kaç kredi kullanıldı, ayrım yoksa boş |
| data -> time_left | İşin silinmesine kadar kalan yaklaşık süre |
| data -> algorithm | Kullanılan ayırma türü hakkında temel bilgileri içerir (dönen parametreler hakkında bilgi için GET SEPARATION TYPES sekmesine bakın) |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
Kullanıcının premium kullanımını etkinleştirmek için aşağıdaki url'ye bir POST çağrısı yapmanız gerekiyor
https://mvsep.com/api/app/enable_premium
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | Kullanıcının API anahtarı |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<API Tokeniniz>"'
| Anahtar | Değer |
|---|---|
| success |
|
| message | İşlemin durumu hakkında bilgi verir |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
Kullanıcının premium kullanımını devre dışı bırakmak için aşağıdaki URL'ye bir POST çağrısı yapmanız gerekir
https://mvsep.com/api/app/disable_premium
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | Kullanıcının API anahtarı |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<API Tokeniniz>"'
| Anahtar | Değer |
|---|---|
| success |
|
| message | İşlemin durumu hakkında bilgi verir |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
Kullanıcı için uzun dosya adlarını etkinleştirmek için, aşağıdaki URL'ye bir POST çağrısı yapmanız gerekir:
https://mvsep.com/api/app/enable_long_filenames
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | Kullanıcının API anahtarı |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<API Tokeniniz>"'
| Anahtar | Değer |
|---|---|
| success |
|
| message | İşlemin durumu hakkında bilgi verir |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
Kullanıcı için uzun dosya adlarını devre dışı bırakmak için, aşağıdaki URL'ye bir POST çağrısı yapmanız gerekir:
https://mvsep.com/api/app/disable_long_filenames
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | Kullanıcının API anahtarı |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<API Tokeniniz>"'
| Anahtar | Değer |
|---|---|
| success |
|
| message | İşlemin durumu hakkında bilgi verir |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
To get information about Quality Checker queue entries, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/queue
| Saha | Tip | Açıklama |
|---|---|---|
| start | Integer | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Integer | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Verileri bir dizi olarak döndürür:
| Anahtar | Değer |
|---|---|
| id | Identification number of entry |
| dataset_type | Dataset Type chosen when adding the entry / Leaderboard type
|
| date | Created date of the entry |
| algo_name | Name of the used separation type/algorithm |
| main_text | Description of the used separation type/algorithm |
| proc | Status of the processing
|
| proc_remote_date | Timestamp of processing date |
| msg | Returns "OK" if successful, otherwise shows error message |
| metrics | Information about entry metrics |
| sdr_* (wildcard) | SDR of the corresponding stems |
| dataset_name | Name of the dataset |
To get information about Quality Checker leaderboards, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/leaderboard
| Saha | Tip | Açıklama |
|---|---|---|
| dataset_type | String | Dataset Type, defaults to 0 if not given
|
| start | Integer | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Integer | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
| algo_name_filter | String | Filters Separation Type/Algorithm names by given text |
| sort | String | Sort by given SDR of the stem. You can get list of sortable values for given dataset type from sortables key in response |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Anahtar | Değer |
|---|---|
| data | Contains array of Quality Checker entries. Refer to GET QUEUE response from Quality Checker Section for more information |
| dataset_type | Used dataset type key |
| sortables | Keys that can be used to sort used dataset type by given stem in sequential order. |
| sort | Used sorting key from sortable. |
To create Quality Checker entry, you need to make a POST call to the following url:
https://mvsep.com/api/quality_checker/add
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | String | (required) API anahtarın |
| zipfile | Binary | (required) Zip file to be processed |
| algo_name | String | (required) Name of the algorithm |
| main_text | String | (required) Description of the algorithm |
| dataset_type | String | Dataset type. Defaults to 0.
|
| password | String | (required) Password to delete algorithm |
| ensemble | integer | 0 - algorithm is not ensemble. 1 - algorithm is 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"'
| Anahtar | Değer |
|---|---|
| success |
|
| data | Contains information about entry |
| data -> id | ID of the entry. |
| data -> link | Link to the entry. |
MVSEP API aşağıdaki hata kodlarını kullanır:
| hata kodu | anlamı |
|---|---|
| 400 | Form geçersiz |
| 401 |
Bilinmeyen veya geçersiz api_token. Bilinmeyen bir API anahtarı kullanırsanız bu hata görünür
|
To get information about Quality Checker queue entry by id, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/entry
| Saha | Tip | Açıklama |
|---|---|---|
| id | Integer | (required) ID of the entry |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
To delete Quality Checker queue entry by id and password, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/delete
| Saha | Tip | Açıklama |
|---|---|---|
| id | Integer | (required) ID of the entry |
| password | String | (required) Used password for the entry |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Anahtar | Değer |
|---|---|
| success |
|
| data->message | Shows whether entry was deleted |
turbo@mvsep.com