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.
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.
MVSEP, bölgesel API uç noktalarını işletmektedir. Tüm bölgeler tek bir hesap veritabanını paylaşır; bu nedenle aynı hesap, API anahtarı ve iş hash’leri her yerde geçerlidir:
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://hk.mvsep.com/apihttps://mvsep.com/api adresine gönderilen istekler coğrafi olarak yönlendirilir: Avrupa'daki istemciler de bölgesine, Kuzey Asya'dakiler hk bölgesine, diğer herkes ise de2 bölgesine yönlendirilir. API entegrasyonları için bölgesel bir uç noktayı açıkça çağırmanızı öneririz; bu sayede isteklerinizin nereden geldiğine bakılmaksızın işin tüm yaşam döngüsü tek bir sunucuda kalır.
Her bir ayrıştırma işlemi, oluşturulduğu bölgede işlenir ve depolanır; yanıtlarda döndürülen indirme URL’leri her zaman o bölgenin ana sunucusuna yönlendirilir. En iyi performans için, sunucularınıza en yakın uç noktayı seçin ve işin tüm yaşam döngüsü boyunca — oluşturma, durum sorgulama ve dosya indirme — aynı ana sunucuyu kullanın.
Herhangi bir bölgeden herhangi bir işin durumunu sorgulayabilirsiniz (veritabanı ortaktır), ancak çıktı dosyaları her zaman işin sahibi olan bölge tarafından sunulur.
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
| Alan | 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 değeri 20'dir. Bu, ayırma türünün kimlik numarasıdır; daha fazla bilgi için GET SEPARATION TYPES bölümüne bakın. <code class="higlighted">preset_id</code> verildiğinde göz ardı edilir. |
| preset_id | Tamsayı | (isteğe bağlı) Dosyaya tek bir algoritma yerine kayıtlı ön ayarlarınızdan birini uygulayın. sep_type ya da preset_id parametrelerinden yalnızca birini gönderin — bir ön ayar kendi algoritmalarını, seçeneklerini ve çıktı biçimlerini kendisi tanımlar; bu nedenle ön ayarla birlikte gönderilen sep_type, add_opt alanları ve output_format göz ardı edilir. Yanıt, tıpkı bir ayırma işleminde olduğu gibi sorgulayacağınız bir hash döndürür; sonuçta ön ayarın her Çıktı düğümü için bir girdi bulunur. Kendi kimlik numaralarınız için aşağıdaki ön ayar tablosuna bakın. |
| 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ınlanıp yayınlanmayacağı, varsayılan değer false'tur |
| webhook_url | Dize | (optional) A URL we will POST the finished result to, so you do not have to keep polling. The body is the same JSON as GET SEPARATION. This overrides the account-wide address set on the webhooks page, which is useful when several of your own users share one API token. Must be a publicly reachable http or https address. |
| Ad | Değer | Ek alanlar |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Anahtar: add_opt1 Ad: Output files Seçenekler:
Anahtar: add_opt2 Ad: Model Type Seçenekler:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Anahtar: add_opt1 Ad: Output files Seçenekler:
Anahtar: add_opt2 Ad: Model Type Seçenekler:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Anahtar: add_opt1 Ad: Output files Seçenekler:
Anahtar: add_opt2 Ad: Model Type Seçenekler:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| BS Roformer (vocals, instrumental) | 40 | Anahtar: add_opt1 Ad: Vocal model type Seçenekler:
Anahtar: add_opt2 Ad: Overlap Seçenekler:
Anahtar: add_opt3 Ad: Set of stems Seçenekler:
|
| BS PolarFormer (vocals, instrumental) | 123 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: Overlap Seçenekler:
|
| MelBand Roformer (vocals, instrumental) | 48 | Anahtar: add_opt1 Ad: Vocal model type Seçenekler:
Anahtar: add_opt2 Ad: Overlap Seçenekler:
|
| MDX23C (vocals, instrumental) | 25 | Anahtar: add_opt1 Ad: Vocal model type Seçenekler:
|
| SCNet (vocals, instrumental) | 46 | Anahtar: add_opt1 Ad: Vocal model type Seçenekler:
|
| MDX B (vocals, instrumental) | 23 | Anahtar: add_opt1 Ad: Vocal model type Seçenekler:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
Anahtar: add_opt2 Ad: Agressiveness Seçenekler:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Anahtar: add_opt1 Ad: Karaoke model type Seçenekler:
Anahtar: add_opt2 Ad: Extraction type Seçenekler:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Anahtar: add_opt1 Ad: Karaoke model type Seçenekler:
|
| MVSep Crowd removal (crowd, other) | 34 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| Medley Vox (Multi-singer separation) | 53 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
Anahtar: add_opt2 Ad: Processing Mode Seçenekler:
|
| MVSep Male/Female separation | 57 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Choir (choir, other) | 112 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Drums (drums, other) | 44 | Anahtar: add_opt1 Ad: Drums model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
Anahtar: add_opt3 Ad: Output files Seçenekler:
|
| MVSep Bass (bass, other) | 41 | Anahtar: add_opt1 Ad: Bass model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
Anahtar: add_opt3 Ad: Output files Seçenekler:
|
| MVSep Synth (synth, other) | 88 | Anahtar: add_opt1 Ad: How to extract Seçenekler:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
Anahtar: add_opt2 Ad: Preprocess Seçenekler:
|
| MVSep Piano (piano, other) | 29 | Anahtar: add_opt1 Ad: Piano model type Seçenekler:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Anahtar: add_opt1 Ad: Organ model type Seçenekler:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| MVSep Clavinet | 135 | |
| MVSep Mellotron | 136 | |
| MVSep Guitar (guitar, other) | 31 | Anahtar: add_opt1 Ad: Guitar model type Seçenekler:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| 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 | Anahtar: add_opt1 Ad: String model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Cello (cello, other) | 70 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Double Bass (double-bass, other) | 73 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Wind (wind, other) | 54 | Anahtar: add_opt1 Ad: Wind model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
Anahtar: add_opt3 Ad: Output files Seçenekler:
|
| MVSep Brass (brass, other) | 107 | Anahtar: add_opt1 Ad: How to extract Seçenekler:
|
| MVSep Woodwind (woodwind, other) | 108 | Anahtar: add_opt1 Ad: How to extract Seçenekler:
|
| MVSep Saxophone (saxophone, other) | 61 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| MVSep Flute (flute, other) | 67 | Anahtar: add_opt1 Ad: Flute model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Trumpet (trumpet, other) | 71 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Trombone (trombone, other) | 75 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Oboe (oboe, other) | 77 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Clarinet (clarinet, other) | 78 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep French Horn (french-horn, other) | 82 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Harmonica (harmonica, other) | 87 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| 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 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Celesta (celesta, other) | 110 | Anahtar: add_opt2 Ad: How to extract Seçenekler:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: How to extract Seçenekler:
Anahtar: add_opt3 Ad: Output files Seçenekler:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: Cutoff (Hz) Seçenekler:
|
| Reverb Removal (noreverb) | 22 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
Anahtar: add_opt2 Ad: Preprocess Seçenekler:
|
| DeNoise by aufr33 and gabox | 47 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| AudioSR (Super Resolution) | 59 | Anahtar: add_opt1 Ad: Cutoff (Hz) Seçenekler:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Anahtar: add_opt1 Ad: Text prompt Seçenekler: Anahtar: add_opt2 Ad: Length (in seconds) Seçenekler:
|
| Whisper (extract text from audio) | 39 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: Transcription type Seçenekler:
|
| Parakeet (extract text from audio) | 64 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: Version Seçenekler:
|
| VibeVoice (Voice Cloning) | 103 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: Text prompt Seçenekler: Anahtar: add_opt3 Ad: Extract vocals first Seçenekler:
|
| VibeVoice (TTS) | 104 | Anahtar: add_opt1 Ad: Model type Seçenekler:
Anahtar: add_opt2 Ad: Text prompt Seçenekler: |
| Qwen3-TTS (Custom Voice) | 118 | Anahtar: add_opt1 Ad: Text prompt Seçenekler: Anahtar: add_opt2 Ad: Speaker Seçenekler:
Anahtar: add_opt3 Ad: Language Seçenekler:
Anahtar: add_opt4 Ad: Voice description Seçenekler: |
| Qwen3-TTS (Voice Design) | 119 | Anahtar: add_opt1 Ad: Text prompt Seçenekler: Anahtar: add_opt2 Ad: Voice description Seçenekler: Anahtar: add_opt3 Ad: Language Seçenekler:
|
| Qwen3-TTS (Voice Cloning) | 120 | Anahtar: add_opt1 Ad: Text prompt Seçenekler: Anahtar: add_opt2 Ad: Reference text in audio (optional) Seçenekler: Anahtar: add_opt3 Ad: Language Seçenekler:
Anahtar: add_opt4 Ad: Extract vocals first Seçenekler:
|
| Mega 53-stem Model | 126 | |
| Upmixing by Jazzpear | 137 | |
| DeEffect vocals by gilliaan | 138 | |
| Bark (Speech Gen) | 115 | Anahtar: add_opt1 Ad: Text prompt Seçenekler: Anahtar: add_opt2 Ad: Speaker Seçenekler:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
|
| Aspiration (by Sucial) | 50 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| Phantom Centre extraction | 55 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Anahtar: add_opt1 Ad: How to use Seçenekler:
|
| Transkun (Piano -> MIDI) | 113 | Anahtar: add_opt1 Ad: How to extract Seçenekler:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Anahtar: add_opt1 Ad: How to extract Seçenekler:
|
| HeartMuLa (Song Gen) | 121 | Anahtar: add_opt1 Ad: Lyrics Seçenekler: Anahtar: add_opt10 Ad: Topic Seçenekler:
Anahtar: add_opt2 Ad: Tags (optional) Seçenekler: Anahtar: add_opt3 Ad: Genre Seçenekler:
Anahtar: add_opt4 Ad: Timbre Seçenekler:
Anahtar: add_opt5 Ad: Gender Seçenekler:
Anahtar: add_opt6 Ad: Mood Seçenekler:
Anahtar: add_opt7 Ad: Instrument Seçenekler:
Anahtar: add_opt8 Ad: Scene Seçenekler:
Anahtar: add_opt9 Ad: Region Seçenekler:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Anahtar: add_opt1 Ad: Vocal model type Seçenekler:
|
| Vit Large 23 (vocals, instrum) | 33 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| UVRv5 Demucs (vocals, music) | 17 | Anahtar: add_opt1 Ad: 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 Ad: Model type Seçenekler:
|
| UnMix | 3 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
| Zero Shot (Query Based) (Low quality) | 14 | Anahtar: add_opt1 Ad: Model Type Seçenekler:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Anahtar: add_opt1 Ad: Model type Seçenekler:
|
Ön ayarlar yalnızca onları oluşturan hesaba özeldir; bu tabloda sizin ön ayarlarınız ve özenle seçilmiş hazır ön ayarlar görünür. Bunları ön ayar düzenleyicisinde oluşturup düzenleyebilirsiniz.
Henüz ön ayarınız yok. Giriş yapın ve ön ayar düzenleyicisinde bir tane oluşturun; kimlik numarası burada görünecektir.
| Ad | 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 | success 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, zorunlu parametrelerin tümünü göndermediğinizde ya da geçersiz parametreler gönderdiğ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
Aynı uç nokta ön ayar çalıştırmalarını da döndürür: preset_id ile aldığınız hash değerini, tıpkı bir ayırma işleminde olduğu gibi sorgulayın. Yanıt yapısı aynıdır — status alanı waiting ve processing değerlerinden geçerek done değerine ulaşır — ve data.type değeri preset_run olur. data.files içindeki her girdi ön ayarın bir Çıktı düğümüne karşılık gelir ve bir stem adıyla değil, kendi etiketiyle adlandırılır. Bir çalıştırma yalnızca onu oluşturan hesap tarafından görülebilir.
| Alan | 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 | status 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 status waiting veya distributing olduğunda gösterilir) |
| data -> current_order | Kullanıcının işinin sırasını gösterir (sadece status waiting veya distributing olduğunda gösterilir) |
| data -> message | Durumun açıklamasını gösterir (tüm durumlarda gösterilir, status failed olduğunda bunun yerine hata nedenini gösterir) |
| data -> algorithm | İş üzerinde kullanılan algoritmayı gösterir (sadece status done olduğunda gösterilir) |
| data -> algorithm_description | İş üzerinde kullanılan algoritma ayrıntılarını gösterir (sadece status done olduğunda gösterilir) |
| data -> output_format | İşin çıktı biçimini gösterir (sadece status done olduğunda gösterilir) |
| data -> tags | Ses meta etiketlerini gösterir (sadece status done olduğunda gösterilir) |
| data -> input_file | Giriş ses indirme ayrıntılarını gösterir (sadece status done olduğunda gösterilir) |
| data -> files | Çıkış seslerinin indirme ayrıntılarını gösterir (sadece status done olduğunda gösterilir) |
| data -> date | İş işleme tarihini gösterir (sadece status done olduğunda gösterilir) |
| data -> finished_chunks | Büyük bir işin tamamlanmış parça sayısını gösterir (sadece status distributing 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 status distributing olduğunda gösterilir) |
Kendi ayırma işlemlerinizden birini — normal bir işi ya da bir ön ayar çalıştırmasını — silin. Bu işlem kaydı ve çıktı dosyalarını kaldırır. Hâlâ işlenmekte olan bir ayırmanın önce iptal edilmesi gerekir. İş zaten çalıştırıldığı için silme işlemi kredileri iade etmez.
POST https://mvsep.com/api/separation/delete
Herhangi bir bölgeden herhangi bir işin durumunu sorgulayabilirsiniz (veritabanı ortaktır), ancak çıktı dosyaları her zaman işin sahibi olan bölge tarafından sunulur.
| Alan | Tip | Açıklama |
|---|---|---|
| hash | Dize | Ayırma Hash |
| api_token | Dize | Kullanıcının API anahtarı. Zorunlu. |
curl --location --request POST 'https://mvsep.com/api/separation/delete'
--form 'api_token="<API Tokeniniz>"'
--form 'hash="20230327071601-0e3e5c6c85-13-dimensions.mp3"'
| Anahtar | Değer |
|---|---|
| success |
|
| data -> message | Durumun açıklamasını gösterir (tüm durumlarda gösterilir, status failed olduğunda bunun yerine hata nedenini gösterir) |
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
| Alan | 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 | status 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). |
Ayırma işlemini iptal etmek ve kullanılan kredileri iade etmek için (ayırma 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
| Alan | 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 |
|
Ayırma türleri hakkında ayrıntılı veri almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/algorithms
| Alan | 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 | Ayırma 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 ayırma 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. Şu formülü kullanır : floor(<Ses dosyasının saniye cinsinden süresi> * price_coefficient / 60)?:1
|
| usage | Ayırma türünün aylık kullanım sayısını gösterir |
| rating | Ayırma türünün aylık kullanım puanını dizi olarak gösterir:
|
| algorithm_fields | Ayırma türünün ek alanları hakkında bilgi içerir |
| algorithm_fields -> name |
Ayırma türünün hangi ek alanı olduğunu 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
| Alan | 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 değeri 0'dır (yani en yeni kayıttan 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
| Alan | 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 ayırmaları hakkında bilgi almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/demo
| Alan | Tip | Açıklama |
|---|---|---|
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan değeri 0'dır (yani en yeni kayıttan 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ı ayırma türü kimliği. Yalnızca tek bir algoritma tarafından oluşturulan demo ayı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 | Kayıtlı iş seçeneği verileri üzerinde çalışan, isteğe bağlı ham "içerir" filtresi. Yeni entegrasyonlarda 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 uç noktasını ç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 | Ayırmanın tarihi |
| input_audio | Giriş sesinin URL'si |
| 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) |
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
| Alan | 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ı 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
| Alan | 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ının kalan kredileri |
| 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 |
Kullanıcı bilgilerini almak için aşağıdaki url'ye GET çağrısı yapmanız gerekiyor:
https://mvsep.com/api/app/user
| Alan | 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ının kalan kredileri |
| 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ının devam eden ayırma işlemlerini gösterir |
MVSEP API aşağıdaki hata kodlarını kullanır:
| Hata kodu | Anlamı |
|---|---|
| 400 | Geçersiz API anahtarı |
Kullanıcının ayırma geçmişine ilişkin temel bilgileri almak için aşağıdaki URL'ye bir GET çağrısı yapmanız gerekir:
https://mvsep.com/api/app/separation_history
| Alan | Tip | Açıklama |
|---|---|---|
| api_token | Dize | Kullanıcının API anahtarı |
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan değeri 0'dır (yani en yeni kayıttan 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 ayırmalara ilişkin temel bilgi dizisini içerir |
| data -> hash | Ayırma Hash |
| data -> job_exists | Önceki ayırmalara ilişkin temel bilgi dizisini içerir |
| data -> credits | İş için kaç kredi kullanıldığı; ayırma artık yoksa null |
| 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ı |
Bu hesabın kredi satın alımlarını, en yenisinden başlayarak almak için aşağıdaki URL'ye bir GET çağrısı yapın:
https://mvsep.com/api/purchases
| Alan | Tip | Açıklama |
|---|---|---|
| api_token | Dize | Kullanıcının API anahtarı |
| limit | Tamsayı | (isteğe bağlı) Döndürülecek satın alma sayısı, 1-100. Varsayılan değer 20. |
| offset | Tamsayı | (isteğe bağlı) Geçmişte sayfalar arasında gezinmek için atlanacak satın alma sayısı. Varsayılan değer 0. |
| status | Dize | (isteğe bağlı) Yalnızca bu durumdaki satın alımları döndürür, örn. succeeded. Sitenin kendi geçmiş sayfasında görünen her şeyi almak için bu parametreyi boş bırakın (veya all gönderin); buna başlatılıp hiç tamamlanmamış ödemeler de dahildir — onların durumu unpaid olur ve hiç kredi tanımlanmamıştır. |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<API Tokeniniz>&status=succeeded&limit=20'
| Anahtar | Değer |
|---|---|
| purchases | Satın alma başına bir girdi: payment_id, status, amount, tanımlanan credits, payment_method (stripe, paddle, yookassa, google_play veya app_store) ve date. |
| total | Limit ve ofset dikkate alınmadan eşleşen toplam satın alma sayısı — sayfalandırma için kullanın. |
| credits | Hesabın şu andaki kredi bakiyesi. |
Kredi bakiyeniz belirlediğiniz eşiğe düştüğünde MVSEP size e-posta gönderir; böylece çalışan bir entegrasyon beklenmedik biçimde durmaz. GET geçerli ayarı döndürür, POST ayarı değiştirir. Uyarı yalnızca bir kez gönderilir ve bakiye eşiğin üzerine çıkana kadar tekrarlanmaz.
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| Alan | Tip | Açıklama |
|---|---|---|
| api_token | Dize | Kullanıcının API anahtarı |
| credit_threshold | Tamsayı | (yalnızca POST, zorunlu) Bakiye bu kredi miktarına eşit ya da bunun altına indiğinde uyarıyı gönderir. 0 uyarıyı kapatır. Eşiği değiştirmek, daha önce gönderilmiş bir uyarıyı yeniden etkinleştirir. |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<API Tokeniniz>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<API Tokeniniz>' --form 'credit_threshold=100'
| Anahtar | Değer |
|---|---|
| credit_threshold | Şu anda ayarlı olan eşik (kredi cinsinden). |
| enabled | Sıfırdan büyük bir eşik ayarlandığında <code>true</code>, aksi takdirde <code>false</code>. |
| credits | Hesabın şu anki kredi bakiyesi. |
| notified | Geçerli düşüş için uyarı gönderildiğinde <code>true</code> olur; bakiye eşiğin üzerine geri çıktığında kendiliğinden temizlenir. |
| Uyarının gönderileceği adres. |
Kullanıcının premium kullanımını etkinleştirmek için aşağıdaki URL'ye bir POST çağrısı yapmanız gerekir:
https://mvsep.com/api/app/enable_premium
| Alan | 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
| Alan | 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
| Alan | 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
| Alan | 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ı |
Kalite Denetleyicisi 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
| Alan | Tip | Açıklama |
|---|---|---|
| start | Tamsayı | (isteğe bağlı) Başlangıç noktası ofseti, varsayılan değeri 0'dır (yani en yeni kayıttan 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 stemlerin SDR değeri |
| dataset_name | Veri kümesinin adı |
Kalite Denetleyicisi 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
| Alan | 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 değeri 0'dır (yani en yeni kayıttan 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 | Ayırma türü/algoritma adlarını verilen metne göre filtreler |
| sort | Dize | Stem'in belirtilen SDR değerine göre sıralar. 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ürünü, belirtilen stem'e göre sırayla sıralamak için kullanılabilecek anahtarlar. |
| sort | Sıralanabilir anahtarlar arasından kullanılan sıralama anahtarı. |
Kalite Denetleyicisi 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
| Alan | Tip | Açıklama |
|---|---|---|
| api_token | Dize | (zorunlu) API anahtarın |
| zipfile | İkili | (zorunlu) İşlenecek ZIP dosyası |
| 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) Algoritmayı silmek için kullanılacak şifre |
| 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
|
Kalite Denetleyicisi 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
| Alan | Tip | Açıklama |
|---|---|---|
| id | Tamsayı | (zorunlu) Girişin kimliği |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Kalite Denetleyicisi 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
| Alan | 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 |
Bu API üzerine kurulmuş kütüphaneler, uygulamalar ve entegrasyonlar. Aksi belirtilmedikçe bunlar topluluk projeleridir; MVSEP tarafından geliştirilmezler ve bu projeler için garanti veremeyiz.
Bu araç PyPI'da mvsep-cli adıyla dağıtılıyor ve yazar olarak MVSEP'i gösteriyor; bu da onu resmi gibi gösterebiliyor. Araç MVSEP tarafından değil, üçüncü bir taraf tarafından yayımlanıp sürdürülüyor ve bağlantı verdiği kaynak deposu mevcut değil. API token'ınızı istediği için, oraya bir token yapıştırmadan önce kaynak kodunu okuyun.
mvsep-cli olarak yayınlandı: pypi.org/project/mvsep-cli