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.
Python'da örnekler: https://github.com/ZFTurbo/MVSep-API-Examples
Mac OS için resmi olmayan MacVSep uygulaması: https://github.com/septcoco/macvsep
Webhook'lar buradan ayarlanabilir: Webhook Sayfası
OpenAPI Spesifikasyonu: mvsep-openapi-spec.json
Premium kullanıcılar sınırsız sayıda eşzamanlı iş talep edebilirken, Premium olmayan kullanıcılar yalnızca 1 eşzamanlı iş talep edebilir.
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 | Dize | API anahtarın |
| audiofile | İkili | İşlenecek ses dosyası. url parametresi ayarlanmışsa veya model dosya girişi kullanmıyorsa bu parametre gerekli değildir. Eşleştirme modelleri için, audiofile yerine target_audiofile ve reference_audiofile parametrelerini giriş olarak kullanın. |
| url | Dize | Ses dosyasının bağlantısı. audiofile parametresi ayarlanmışsa gerekli değildir. |
| remote_type | Dize | (isteğe bağlı) Ses dosyasının uzaktan erişim türü. Varsayılan değer direct'dir. audiofile parametresi ayarlanmışsa bu parametre gerekli değildir. Desteklenen türler şunlardır: direct (Doğrudan İndirme), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Tamsayı | (isteğe bağlı) Ayırma Türü, varsayılan olarak 11'dir (Demucs3 Model B (vocals, drums, bass, other)) |
| add_opt1 | Dize | (isteğe bağlı) Ayırma Türü ilk ek alan |
| add_opt2 | Dize | (isteğe bağlı) Ayırma Türü ikinci ek alan |
| add_opt3 | Dize | (isteğe bağlı) Ayırma Türü üçüncü ek alan |
| output_format | Tamsayı | (isteğe bağlı) sonuç formatı, varsayılan olarak 0 (MP3 (320kbps)) |
| is_demo | Boole | (isteğe bağlı) ayırmanın demo sayfasında yayınlanması durumunda varsayılan değer false olur |
| isim | Değer | Ek alanlar |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Anahtar: add_opt1 isim: Output files Seçenekler:
Anahtar: add_opt2 isim: Model Type Seçenekler:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Anahtar: add_opt1 isim: Output files Seçenekler:
Anahtar: add_opt2 isim: Model Type Seçenekler:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Anahtar: add_opt1 isim: Output files Seçenekler:
Anahtar: add_opt2 isim: Model Type Seçenekler:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| BS Roformer (vocals, instrumental) | 40 | Anahtar: add_opt1 isim: Vocal model type Seçenekler:
|
| BS PolarFormer (vocals, instrumental) | 123 | Anahtar: add_opt1 isim: Overlap Seçenekler:
|
| MelBand Roformer (vocals, instrumental) | 48 | Anahtar: add_opt1 isim: Vocal model type Seçenekler:
|
| MDX23C (vocals, instrumental) | 25 | Anahtar: add_opt1 isim: Vocal model type Seçenekler:
|
| SCNet (vocals, instrumental) | 46 | Anahtar: add_opt1 isim: Vocal model type Seçenekler:
|
| MDX B (vocals, instrumental) | 23 | Anahtar: add_opt1 isim: Vocal model type Seçenekler:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Anahtar: add_opt1 isim: Model Type Seçenekler:
Anahtar: add_opt2 isim: Agressiveness Seçenekler:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Anahtar: add_opt1 isim: Karaoke model type Seçenekler:
Anahtar: add_opt2 isim: Extraction type Seçenekler:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Anahtar: add_opt1 isim: Karaoke model type Seçenekler:
|
| MVSep Crowd removal (crowd, other) | 34 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| Medley Vox (Multi-singer separation) | 53 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Anahtar: add_opt1 isim: Model Type Seçenekler:
|
| MVSep Male/Female separation | 57 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Choir (choir, other) | 112 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Drums (drums, other) | 44 | Anahtar: add_opt1 isim: Drums model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
Anahtar: add_opt3 isim: Output files Seçenekler:
|
| MVSep Bass (bass, other) | 41 | Anahtar: add_opt1 isim: Bass model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
Anahtar: add_opt3 isim: Output files Seçenekler:
|
| MVSep Synth (synth, other) | 88 | Anahtar: add_opt1 isim: How to extract Seçenekler:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Anahtar: add_opt1 isim: Model Type Seçenekler:
Anahtar: add_opt2 isim: Preprocess Seçenekler:
|
| MVSep Piano (piano, other) | 29 | Anahtar: add_opt1 isim: Piano model type Seçenekler:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Anahtar: add_opt1 isim: Organ model type Seçenekler:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Anahtar: add_opt1 isim: Guitar model type Seçenekler:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| 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 | Anahtar: add_opt1 isim: String model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Cello (cello, other) | 70 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Double Bass (double-bass, other) | 73 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Wind (wind, other) | 54 | Anahtar: add_opt1 isim: Wind model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
Anahtar: add_opt3 isim: Output files Seçenekler:
|
| MVSep Brass (brass, other) | 107 | Anahtar: add_opt1 isim: How to extract Seçenekler:
|
| MVSep Woodwind (woodwind, other) | 108 | Anahtar: add_opt1 isim: How to extract Seçenekler:
|
| MVSep Saxophone (saxophone, other) | 61 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| MVSep Flute (flute, other) | 67 | Anahtar: add_opt1 isim: Flute model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Trumpet (trumpet, other) | 71 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Trombone (trombone, other) | 75 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Oboe (oboe, other) | 77 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Clarinet (clarinet, other) | 78 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep French Horn (french-horn, other) | 82 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Harmonica (harmonica, other) | 87 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| 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 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Celesta (celesta, other) | 110 | Anahtar: add_opt2 isim: How to extract Seçenekler:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Anahtar: add_opt1 isim: Model Type Seçenekler:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: How to extract Seçenekler:
Anahtar: add_opt3 isim: Output files Seçenekler:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: Cutoff (Hz) Seçenekler:
|
| Reverb Removal (noreverb) | 22 | Anahtar: add_opt1 isim: Model Type Seçenekler:
Anahtar: add_opt2 isim: Preprocess Seçenekler:
|
| DeNoise by aufr33 and gabox | 47 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| AudioSR (Super Resolution) | 59 | Anahtar: add_opt1 isim: Cutoff (Hz) Seçenekler:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Anahtar: add_opt1 isim: Text prompt Seçenekler: Anahtar: add_opt2 isim: Length (in seconds) Seçenekler:
|
| Whisper (extract text from audio) | 39 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: Transcription type Seçenekler:
|
| Parakeet (extract text from audio) | 64 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: Version Seçenekler:
|
| VibeVoice (Voice Cloning) | 103 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: Text prompt Seçenekler: Anahtar: add_opt3 isim: Extract vocals first Seçenekler:
|
| VibeVoice (TTS) | 104 | Anahtar: add_opt1 isim: Model type Seçenekler:
Anahtar: add_opt2 isim: Text prompt Seçenekler: |
| Qwen3-TTS (Custom Voice) | 118 | Anahtar: add_opt1 isim: Text prompt Seçenekler: Anahtar: add_opt2 isim: Speaker Seçenekler:
Anahtar: add_opt3 isim: Language Seçenekler:
Anahtar: add_opt4 isim: Voice description Seçenekler: |
| Qwen3-TTS (Voice Design) | 119 | Anahtar: add_opt1 isim: Text prompt Seçenekler: Anahtar: add_opt2 isim: Voice description Seçenekler: Anahtar: add_opt3 isim: Language Seçenekler:
|
| Qwen3-TTS (Voice Cloning) | 120 | Anahtar: add_opt1 isim: Text prompt Seçenekler: Anahtar: add_opt2 isim: Reference text in audio (optional) Seçenekler: Anahtar: add_opt3 isim: Language Seçenekler:
Anahtar: add_opt4 isim: Extract vocals first Seçenekler:
|
| Bark (Speech Gen) | 115 | Anahtar: add_opt1 isim: Text prompt Seçenekler: Anahtar: add_opt2 isim: Speaker Seçenekler:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Anahtar: add_opt1 isim: Model Type Seçenekler:
|
| Aspiration (by Sucial) | 50 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| Phantom Centre extraction | 55 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Anahtar: add_opt1 isim: How to use Seçenekler:
|
| Transkun (piano -> midi) | 113 | Anahtar: add_opt1 isim: How to extract Seçenekler:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Anahtar: add_opt1 isim: Lyrics Seçenekler: Anahtar: add_opt10 isim: Topic Seçenekler:
Anahtar: add_opt2 isim: Tags (optional) Seçenekler: Anahtar: add_opt3 isim: Genre Seçenekler:
Anahtar: add_opt4 isim: Timbre Seçenekler:
Anahtar: add_opt5 isim: Gender Seçenekler:
Anahtar: add_opt6 isim: Mood Seçenekler:
Anahtar: add_opt7 isim: Instrument Seçenekler:
Anahtar: add_opt8 isim: Scene Seçenekler:
Anahtar: add_opt9 isim: Region Seçenekler:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Anahtar: add_opt1 isim: Vocal model type Seçenekler:
|
| Vit Large 23 (vocals, instrum) | 33 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| UVRv5 Demucs (vocals, music) | 17 | Anahtar: add_opt1 isim: Model Type Seçenekler:
|
| 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 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| UnMix | 3 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| Zero Shot (Query Based) (Low quality) | 14 | Anahtar: add_opt1 isim: Model Type Seçenekler:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Anahtar: add_opt1 isim: Model type Seçenekler:
|
| 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 | Dize | Ayırma Hash |
| mirror | Tamsayı | (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 | Dize | (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) |
Uzak bir işin sonucunu almak için aşağıdaki URL'ye bir GET isteği göndermeniz gerekir:
https://mvsep.com/api/separation/get-remote
| Saha | Tip | Açıklama |
|---|---|---|
| hash | Dize | 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 | Kullanıcının öncelik listesindeki işlenmemiş işlerin sayısını gösterir (yalnızca status değeri waiting olduğunda görüntülenir). |
| data -> current_order | Kullanıcının işinin sırasını gösterir (yalnızca status değeri waiting olduğunda görüntülenir). |
| data -> message | Durum açıklamasını gösterir (yalnızca status değeri failed olduğunda). |
| data -> link | Oluşturulan işin "SONUÇ AL" URL'sine bağlantı gösterir (yalnızca status değeri done olduğunda görüntülenir). |
| data -> hash | Ayırma işleminin hash değeri (yalnızca status değeri done olduğunda gösterilir). |
Ayrılma işlemini iptal etmek ve kullanılan kredileri iade etmek için (eğer ayrılma işlemi henüz işleme alınmamışsa), aşağıdaki URL'ye bir POST isteği göndermeniz gerekir:
https://mvsep.com/api/separation/cancel
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | Dize | Kullanıcının API anahtarı |
| hash | Dize | 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
| Saha | Tip | Açıklama |
|---|---|---|
| scopes | Dize | Farklı girdi biçimleri kullanan modellerin dahil edilip edilmeyeceği.
single_upload olur. Tüm modelleri almak için scopes=single_upload,no_upload,matchering_upload ayarını yapın.
|
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: |
| algorithm_group | Algoritmanın ait olduğu algoritma grubu hakkında bilgiler içerir. |
| algorithm_group -> name | Algoritma grubunun adı. |
| audio_widget |
Algoritma için kullanılacak ses widget'ının türü. Bu, algoritmaya ait ses oynatıcının ön uçta nasıl görüntüleneceğini belirlemek için kullanılabilir. Olası değerler şunlardır:
|
| 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 | Aylık kullanım sayısını gösterir (ayrıştırma türü) |
| rating | Ayrıştırma türünün aylık kullanım oranını dizi olarak gösterir:
|
| 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 | Dize | (isteğe bağlı) 2 harfli dil kodu (en, ru) |
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Tamsayı | (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 |
Site kuyruğu bilgilerini almak için aşağıdaki URL'ye bir GET isteği göndermeniz gerekir:
https://mvsep.com/api/app/queue
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | Dize | (isteğe bağlı) Kullanıcının API anahtarı |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Anahtar | Değer |
|---|---|
| queue |
Farklı planlara ait mevcut kuyrukların listesini içerir:
|
| plan |
Mevcut plan için güncel kuyruğu içerir (kayıtlı/premium plan için istekte api_token ekleyin):
|
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 | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Tamsayı | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
| algorithm_id | Tamsayı | İsteğe bağlı ayrıştırma türü kimliği. Yalnızca tek bir algoritma tarafından oluşturulan demo ayrıştırmalarını döndürmek için bunu kullanın. Değerler, GET SEPARATION TYPES uç noktasındaki render_id ile eşleşir. |
| options[FIELD] | Dize / Tamsayı | Algoritma seçenek değerleri için isteğe bağlı filtre. FIELD ifadesini, GET SEPARATION TYPES yanıtındaki algorithm_fields -> name öğesinden alınan ek bir alan anahtarıyla değiştirin, ardından bu alanın options anahtarlarından birini değer olarak girin. Örnek: options[vocals]=1. |
| additional_options | Dize | Optional raw, depolanmış iş seçenek verilerine karşı bir filtre içerir. Yeni entegrasyonlar için options[FIELD] biçimini tercih edin; çünkü bu biçim daha açık ve oluşturması daha kolaydır. |
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'
Seçenek filtreleri oluşturmak için önce https://mvsep.com/api/app/algorithms komutunu çağırın ve her algoritmanın algorithm_fields listesini inceleyin. options[FIELD] içindeki name alanını kullanın ve değer olarak JSON seçenek anahtarlarından birini seçin.
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 |
|---|---|---|
| Dize | Kullanıcının e-postası | |
| password | Dize | 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 | Dize | Kullanıcının adı |
| Dize | Kullanıcının e-postası | |
| password | Dize | Kullanıcının şifresi |
| password_confirmation | Dize | 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 | Dize | 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 | Dize | Kullanıcının API anahtarı |
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Tamsayı | (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 | Dize | 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 | Dize | 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 | Dize | 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 | Dize | 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ı |
Quality Checker kuyruğundaki girişler hakkında bilgi almak için aşağıdaki URL'ye bir GET isteği göndermeniz gerekir:
https://mvsep.com/api/quality_checker/queue
| Saha | Tip | Açıklama |
|---|---|---|
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Tamsayı | (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 | Kayıt numarası |
| dataset_type | Giriş eklenirken seçilen veri kümesi türü / liderlik tablosu türü
|
| date | Girişin oluşturulma tarihi |
| algo_name | Kullanılan ayırma türü/algoritmasının adı |
| main_text | Kullanılan ayırma türünün/algoritmasının açıklaması |
| proc | İşlemin durumu
|
| proc_remote_date | İşleme tarihinin zaman damgası |
| msg | Başarılı olursa "OK" değerini döndürür, aksi takdirde hata mesajı gösterir |
| metrics | Giriş metrikleri hakkında bilgiler |
| sdr_* (wildcard) | İlgili köklerin SDR'si |
| dataset_name | Veri kümesinin adı |
Quality Checker sıralamaları hakkında bilgi almak için aşağıdaki URL'ye bir GET isteği göndermeniz gerekir:
https://mvsep.com/api/quality_checker/leaderboard
| Saha | Tip | Açıklama |
|---|---|---|
| dataset_type | Dize | Veri kümesi türü; belirtilmezse varsayılan olarak 0 değerine ayarlanır.
|
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan olarak 0'dır (yani en sondan başlar) |
| limit | Tamsayı | (isteğe bağlı) Döndürülen maksimum sonuç miktarı, varsayılanı 10'dur, maksimum 20'dir. |
| algo_name_filter | Dize | Verilen metne göre filtrelerin ayırma türlerini/algoritma adlarını sıralar |
| sort | Dize | Kökün belirtilen SDR değerine göre sıralayın. Belirtilen veri kümesi türü için sıralanabilir değerlerin listesini, yanıt içindeki sortables anahtarından alabilirsiniz. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Anahtar | Değer |
|---|---|
| data | Kalite Denetleyicisi girişlerinden oluşan bir dizi içerir. Daha fazla bilgi için “Kalite Denetleyicisi’nden GET QUEUE yanıtı” bölümüne bakın. |
| dataset_type | Kullanılmış veri kümesi türü anahtarı |
| sortables | Kullanılan veri kümesi türlerini, belirtilen kök kelimeye göre sırayla sıralamak için kullanılabilecek anahtarlar. |
| sort | `sortable` modülünden bir sıralama anahtarı kullanıldı. |
Quality Checker girişi oluşturmak için aşağıdaki URL'ye bir POST isteği göndermeniz gerekir:
https://mvsep.com/api/quality_checker/add
| Saha | Tip | Açıklama |
|---|---|---|
| api_token | Dize | (zorunlu) API anahtarın |
| zipfile | İkili | (zorunlu) İşlenecek sıkıştırılmış dosya |
| algo_name | Dize | (zorunlu) Algoritmanın adı |
| main_text | Dize | (zorunlu) Algoritmanın açıklaması |
| dataset_type | Dize | Veri kümesi türü. Varsayılan değer 0'dir.
|
| password | Dize | (zorunlu) Silme algoritması şifresi |
| ensemble | Tamsayı | 0 - Algoritma bir topluluk değildir. 1 - Algoritma bir topluluk'tur. |
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 | Girişle ilgili bilgiler içerir |
| data -> id | Girişin kimliği |
| data -> link | Girişe bağlantı |
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
|
Quality Checker kuyruğundaki bir giriş hakkında kimlik numarasına göre bilgi almak için, aşağıdaki URL'ye bir GET isteği göndermeniz gerekir:
https://mvsep.com/api/quality_checker/entry
| Saha | Tip | Açıklama |
|---|---|---|
| id | Tamsayı | (zorunlu) Girişin kimliği |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Quality Checker kuyruk girişini kimlik numarası ve şifre ile silmek için aşağıdaki URL'ye bir GET isteği göndermeniz gerekir:
https://mvsep.com/api/quality_checker/delete
| Saha | Tip | Açıklama |
|---|---|---|
| id | Tamsayı | (zorunlu) Girişin kimliği |
| password | Dize | (zorunlu) Giriş için kullanılan şifre |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Anahtar | Değer |
|---|---|
| success |
|
| data->message | Girişin silinip silinmediğini gösterir |
turbo@mvsep.com