turbo@mvsep.com
API MVSEP menyediakan akses terprogram untuk membuat pemisahan, mengembalikan hasil, mendapatkan informasi situs, dan mengontrol kemampuan pengguna.
Untuk menggunakan API ini, Anda memerlukan Kunci API. Anda belum login, silakan login untuk mendapatkan token API Anda.
Contoh dalam Python: https://github.com/ZFTurbo/MVSep-API-Examples
Aplikasi tidak resmi MacVSep untuk Mac OS: https://github.com/septcoco/macvsep
Webhook dapat diatur di sini: Halaman Webhook
Spesifikasi OpenAPI: mvsep-openapi-spec.json
Perlu dicatat bahwa pengguna Premium dapat meminta pekerjaan bersamaan tanpa batas, sementara pengguna non-Premium hanya dapat meminta 1 pekerjaan bersamaan.
Untuk membuat pemisahan, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/separation/create
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | Kunci API Anda |
| audiofile | Biner | File audio yang akan diproses. Tidak diperlukan jika parameter url diatur atau model tidak menggunakan input file. Untuk model matchering, gunakan target_audiofile dan reference_audiofile sebagai input, bukan audiofile. |
| url | String | Tautan ke file audio. Tidak diperlukan jika parameter audiofile diatur. |
| remote_type | String | (opsional) Tipe jarak jauh dari file audio. Default ke direct. Tidak diperlukan jika parameter audiofile diatur. Tipe yang didukung adalah direct (Unduh Langsung), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Integer (Bilangan Bulat) | (opsional) Jenis Pemisahan, default ke 11 (Demucs3 Model B (vokal, drum, bass, lainnya)) |
| add_opt1 | String | (opsional) Pemisahan Jenis bidang tambahan pertama |
| add_opt2 | String | (opsional) Pemisahan Jenis bidang tambahan kedua |
| add_opt3 | String | Jenis Pemisahan bidang tambahan ketiga |
| output_format | Integer (Bilangan Bulat) | (opsional) format output, default ke 0 (mp3 (320kbps)) |
| is_demo | Boolean | (opsional) jika pemisahan dipublikasikan ke halaman demo, defaultnya adalah false |
| Nama | Nilai | Kolom tambahan |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Kunci: add_opt1 Nama: Output files Opsi:
Kunci: add_opt2 Nama: Model Type Opsi:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Kunci: add_opt1 Nama: Output files Opsi:
Kunci: add_opt2 Nama: Model Type Opsi:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Kunci: add_opt1 Nama: Output files Opsi:
Kunci: add_opt2 Nama: Model Type Opsi:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Kunci: add_opt1 Nama: Model type Opsi:
|
| BS Roformer (vocals, instrumental) | 40 | Kunci: add_opt1 Nama: Vocal model type Opsi:
|
| BS PolarFormer (vocals, instrumental) | 123 | Kunci: add_opt1 Nama: Overlap Opsi:
|
| MelBand Roformer (vocals, instrumental) | 48 | Kunci: add_opt1 Nama: Vocal model type Opsi:
|
| MDX23C (vocals, instrumental) | 25 | Kunci: add_opt1 Nama: Vocal model type Opsi:
|
| SCNet (vocals, instrumental) | 46 | Kunci: add_opt1 Nama: Vocal model type Opsi:
|
| MDX B (vocals, instrumental) | 23 | Kunci: add_opt1 Nama: Vocal model type Opsi:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Kunci: add_opt1 Nama: Model Type Opsi:
Kunci: add_opt2 Nama: Agressiveness Opsi:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Kunci: add_opt1 Nama: Karaoke model type Opsi:
Kunci: add_opt2 Nama: Extraction type Opsi:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Kunci: add_opt1 Nama: Karaoke model type Opsi:
|
| MVSep Crowd removal (crowd, other) | 34 | Kunci: add_opt1 Nama: Model type Opsi:
|
| Medley Vox (Multi-singer separation) | 53 | Kunci: add_opt1 Nama: Model type Opsi:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Kunci: add_opt1 Nama: Model Type Opsi:
|
| MVSep Male/Female separation | 57 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Choir (choir, other) | 112 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Drums (drums, other) | 44 | Kunci: add_opt1 Nama: Drums model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
Kunci: add_opt3 Nama: Output files Opsi:
|
| MVSep Bass (bass, other) | 41 | Kunci: add_opt1 Nama: Bass model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
Kunci: add_opt3 Nama: Output files Opsi:
|
| MVSep Synth (synth, other) | 88 | Kunci: add_opt1 Nama: How to extract Opsi:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Kunci: add_opt1 Nama: Model Type Opsi:
Kunci: add_opt2 Nama: Preprocess Opsi:
|
| MVSep Piano (piano, other) | 29 | Kunci: add_opt1 Nama: Piano model type Opsi:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Kunci: add_opt1 Nama: Organ model type Opsi:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Guitar (guitar, other) | 31 | Kunci: add_opt1 Nama: Guitar model type Opsi:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Kunci: add_opt1 Nama: Model type Opsi:
|
| 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 | Kunci: add_opt1 Nama: String model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Cello (cello, other) | 70 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Double Bass (double-bass, other) | 73 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Wind (wind, other) | 54 | Kunci: add_opt1 Nama: Wind model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
Kunci: add_opt3 Nama: Output files Opsi:
|
| MVSep Brass (brass, other) | 107 | Kunci: add_opt1 Nama: How to extract Opsi:
|
| MVSep Woodwind (woodwind, other) | 108 | Kunci: add_opt1 Nama: How to extract Opsi:
|
| MVSep Saxophone (saxophone, other) | 61 | Kunci: add_opt1 Nama: Model type Opsi:
|
| MVSep Flute (flute, other) | 67 | Kunci: add_opt1 Nama: Flute model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Trumpet (trumpet, other) | 71 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Trombone (trombone, other) | 75 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Oboe (oboe, other) | 77 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Clarinet (clarinet, other) | 78 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep French Horn (french-horn, other) | 82 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Harmonica (harmonica, other) | 87 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| 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 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Celesta (celesta, other) | 110 | Kunci: add_opt2 Nama: How to extract Opsi:
|
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Kunci: add_opt1 Nama: Model type Opsi:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Kunci: add_opt1 Nama: Model Type Opsi:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: How to extract Opsi:
Kunci: add_opt3 Nama: Output files Opsi:
|
| MVSep Braam (braam , other) | 117 | |
| MVSep FX (fx, other) | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: Cutoff (Hz) Opsi:
|
| Reverb Removal (noreverb) | 22 | Kunci: add_opt1 Nama: Model Type Opsi:
Kunci: add_opt2 Nama: Preprocess Opsi:
|
| DeNoise by aufr33 and gabox | 47 | Kunci: add_opt1 Nama: Model type Opsi:
|
| AudioSR (Super Resolution) | 59 | Kunci: add_opt1 Nama: Cutoff (Hz) Opsi:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Kunci: add_opt1 Nama: Text prompt Opsi: Kunci: add_opt2 Nama: Length (in seconds) Opsi:
|
| Whisper (extract text from audio) | 39 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: Transcription type Opsi:
|
| Parakeet (extract text from audio) | 64 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: Version Opsi:
|
| VibeVoice (Voice Cloning) | 103 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: Text prompt Opsi: Kunci: add_opt3 Nama: Extract vocals first Opsi:
|
| VibeVoice (TTS) | 104 | Kunci: add_opt1 Nama: Model type Opsi:
Kunci: add_opt2 Nama: Text prompt Opsi: |
| Qwen3-TTS (Custom Voice) | 118 | Kunci: add_opt1 Nama: Text prompt Opsi: Kunci: add_opt2 Nama: Speaker Opsi:
Kunci: add_opt3 Nama: Language Opsi:
Kunci: add_opt4 Nama: Voice description Opsi: |
| Qwen3-TTS (Voice Design) | 119 | Kunci: add_opt1 Nama: Text prompt Opsi: Kunci: add_opt2 Nama: Voice description Opsi: Kunci: add_opt3 Nama: Language Opsi:
|
| Qwen3-TTS (Voice Cloning) | 120 | Kunci: add_opt1 Nama: Text prompt Opsi: Kunci: add_opt2 Nama: Reference text in audio (optional) Opsi: Kunci: add_opt3 Nama: Language Opsi:
Kunci: add_opt4 Nama: Extract vocals first Opsi:
|
| Bark (Speech Gen) | 115 | Kunci: add_opt1 Nama: Text prompt Opsi: Kunci: add_opt2 Nama: Speaker Opsi:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Kunci: add_opt1 Nama: Model Type Opsi:
|
| Aspiration (by Sucial) | 50 | Kunci: add_opt1 Nama: Model type Opsi:
|
| Phantom Centre extraction | 55 | Kunci: add_opt1 Nama: Model type Opsi:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Kunci: add_opt1 Nama: How to use Opsi:
|
| Transkun (piano -> midi) | 113 | Kunci: add_opt1 Nama: How to extract Opsi:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| HeartMuLa (Song Gen) | 121 | Kunci: add_opt1 Nama: Lyrics Opsi: Kunci: add_opt10 Nama: Topic Opsi:
Kunci: add_opt2 Nama: Tags (optional) Opsi: Kunci: add_opt3 Nama: Genre Opsi:
Kunci: add_opt4 Nama: Timbre Opsi:
Kunci: add_opt5 Nama: Gender Opsi:
Kunci: add_opt6 Nama: Mood Opsi:
Kunci: add_opt7 Nama: Instrument Opsi:
Kunci: add_opt8 Nama: Scene Opsi:
Kunci: add_opt9 Nama: Region Opsi:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Kunci: add_opt1 Nama: Model type Opsi:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Kunci: add_opt1 Nama: Vocal model type Opsi:
|
| Vit Large 23 (vocals, instrum) | 33 | Kunci: add_opt1 Nama: Model type Opsi:
|
| UVRv5 Demucs (vocals, music) | 17 | Kunci: add_opt1 Nama: Model Type Opsi:
|
| 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 | Kunci: add_opt1 Nama: Model type Opsi:
|
| UnMix | 3 | Kunci: add_opt1 Nama: Model type Opsi:
|
| Zero Shot (Query Based) (Low quality) | 14 | Kunci: add_opt1 Nama: Model Type Opsi:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Kunci: add_opt1 Nama: Model type Opsi:
|
| Nama | Nilai |
|---|---|
| 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 Token Anda>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Kunci | Nilai |
|---|---|
| success |
|
| data | Menyimpan informasi tambahan tergantung pada kunci sukses |
| data -> link | Menampilkan tautan ke URL "DAPATKAN HASIL" dari pekerjaan yang dibuat (hanya ditampilkan ketika success bernilai true) |
| data -> hash | Menampilkan hash pekerjaan yang dibuat (hanya ditampilkan ketika success bernilai true) |
| data -> message | Menampilkan deskripsi kesalahan (hanya ditampilkan ketika success bernilai true) |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | Beberapa parameter hilang atau tidak valid. Kesalahan ini muncul ketika Anda tidak mengirimkan setiap parameter wajib atau mengirimkan parameter yang tidak valid. |
| 401 |
api_token tidak dikenal atau tidak valid. Kesalahan ini muncul jika Anda menggunakan kunci API yang tidak dikenal.
|
Untuk mendapatkan hasil pemisahan, Anda perlu membuat panggilan GET ke url berikut:
https://mvsep.com/api/separation/get
| Bidang | Jenis | Deskripsi |
|---|---|---|
| hash | String | Hash Pemisahan |
| mirror | Integer (Bilangan Bulat) | (opsional) Menggunakan cermin lain jika disetel ke 1, default ke 0. Memerlukan api_token dan 1 kredit jika disetel ke 1. |
| api_token | String | (opsional) Kunci API pengguna. Diperlukan jika parameter mirror ditetapkan ke 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Kunci | Nilai |
|---|---|
| success |
|
| status |
|
| data | Menyimpan informasi tambahan tergantung pada kunci status |
| data -> queue_count | Menampilkan jumlah pekerjaan yang belum diproses berdasarkan prioritas pengguna (hanya ditampilkan saat status adalah menunggu atau mendistribusikan) |
| data -> current_order | Menunjukkan urutan pekerjaan pengguna (hanya ditampilkan ketika status adalah menunggu atau mendistribusikan) |
| data -> message | Menampilkan deskripsi status (ditampilkan pada semua status, menampilkan alasan kesalahan sebagai gantinya ketika status adalah gagal) |
| data -> algorithm | Menunjukkan algoritma yang digunakan pada pekerjaan (hanya ditampilkan ketika status adalah selesai) |
| data -> algorithm_description | Menampilkan detail algoritma yang digunakan pada pekerjaan (hanya ditampilkan saat status adalah selesai) |
| data -> output_format | Menampilkan format keluaran pekerjaan (hanya ditampilkan saat status adalah selesai) |
| data -> tags | Menampilkan tag meta audio (hanya ditampilkan saat status adalah done) |
| data -> input_file | Menampilkan detail unduhan audio input (hanya ditampilkan saat status adalah selesai) |
| data -> files | Menampilkan detail unduhan audio keluaran (hanya ditampilkan saat status adalah selesai) |
| data -> date | Menunjukkan tanggal pemrosesan pekerjaan (hanya ditampilkan saat status adalah selesai) |
| data -> finished_chunks | Menunjukkan jumlah bagian yang telah selesai dari suatu pekerjaan besar (hanya ditampilkan ketika status adalah distributing) |
| data -> all_chunks | Menunjukkan jumlah semua bagian dari pekerjaan besar (hanya ditampilkan ketika status adalah distributing) |
Untuk mendapatkan hasil dari pekerjaan jarak jauh, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/separation/get-remote
| Bidang | Jenis | Deskripsi |
|---|---|---|
| hash | String | Hash Pemisahan |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Kunci | Nilai |
|---|---|
| success |
|
| status |
|
| data | Menyimpan informasi tambahan tergantung pada kunci status |
| data -> queue_count | Menampilkan jumlah pekerjaan yang belum diproses dalam prioritas pengguna (hanya ditampilkan saat status adalah waiting). |
| data -> current_order | Menampilkan urutan pekerjaan pengguna (hanya ditampilkan saat status adalah waiting). |
| data -> message | Menampilkan deskripsi status (hanya ketika status adalah failed). |
| data -> link | Menampilkan tautan ke URL "GET RESULT" dari pekerjaan yang dibuat (hanya ditampilkan saat status adalah done). |
| data -> hash | Hash dari pemisahan (hanya ditampilkan saat status adalah done). |
Untuk membatalkan pemisahan dan mengembalikan kredit yang digunakan (jika pemisahan belum diproses), Anda perlu melakukan panggilan POST ke url berikut:
https://mvsep.com/api/separation/cancel
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
| hash | String | Hash Pemisahan |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<API Token Anda>"' --form 'hash="<hash>"'
| Kunci | Nilai |
|---|---|
| success |
|
Untuk mendapatkan data terperinci tentang jenis pemisahan, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/app/algorithms
| Bidang | Jenis | Deskripsi |
|---|---|---|
| scopes | String | Apakah akan menyertakan model yang menggunakan bentuk input berbeda.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Mengembalikan data sebagai array:
| Kunci | Nilai |
|---|---|
| render_id | Nilai tipe pemisahan (ID) |
| name | Nama jenis pemisahan |
| algorithm_group_id | Kelompok tempat tipe pemisahan berada: |
| algorithm_group | Berisi informasi tentang grup algoritma tempat algoritma tersebut bernaung. |
| algorithm_group -> name | Nama grup algoritma. |
| audio_widget |
Tipe widget audio yang akan digunakan untuk algoritma. Ini dapat digunakan untuk menentukan bagaimana menampilkan pemutar audio untuk algoritma di frontend. Nilai yang mungkin adalah:
|
| orientation |
Untuk siapa jenis pemisahan ini ditujukan:
|
| order_id | Urutan jenis pemisahan |
| price_coefficient |
Digunakan untuk menghitung berapa banyak kredit yang diambil pekerjaan dari pengguna premium. Menggunakan rumus ini : floor(<durasi file audio dalam detik> * price_coefficient / 60)?:1
|
| usage | Menampilkan jumlah penggunaan bulanan dari tipe pemisahan |
| rating | Menampilkan peringkat penggunaan bulanan dari tipe pemisahan dalam bentuk array:
|
| algorithm_fields | Berisi informasi tentang bidang tambahan dari jenis pemisahan |
| algorithm_fields -> name |
Menunjukkan bidang tambahan jenis pemisahan:
|
| algorithm_fields -> text | Menampilkan nama bidang tambahan dari jenis pemisahan. |
| algorithm_fields -> options | Rantai kunci-nilai yang dikodekan JSON dari bidang tambahan |
| algorithm_fields -> default_key | Nilai default dari bidang tambahan. Salah satu kunci <code>algorithm_fields -> options</code> |
| algorithm_descriptions | Berisi informasi tentang deskripsi jenis pemisahan |
| algorithm_descriptions -> short_description | Deskripsi kecil tentang jenis pemisahan yang tidak menggunakan HTML. |
| algorithm_descriptions -> long_description | Deskripsi terperinci tentang jenis pemisahan yang menggunakan HTML. |
| algorithm_descriptions -> lang | Kode bahasa yang ditentukan dalam deskripsi. |
Untuk mendapatkan informasi tentang berita terkini tentang MVSEP, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/app/news
| Bidang | Jenis | Deskripsi |
|---|---|---|
| lang | String | (opsional) kode bahasa 2 huruf (en, ru) |
| start | Integer (Bilangan Bulat) | (opsional) Offset titik awal, default ke 0 (yaitu mulai dari yang terbaru) |
| limit | Integer (Bilangan Bulat) | (opsional) Jumlah maksimum hasil yang dikembalikan, default ke 10, maksimum 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Mengembalikan data sebagai array:
| Kunci | Nilai |
|---|---|
| title | Judul berita |
| lang | Judul berita |
| text | Deskripsi berita lengkap |
| created_at | Tanggal berita |
Untuk mendapatkan informasi antrean situs, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/app/queue
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | (opsional) API key pengguna |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Kunci | Nilai |
|---|---|
| queue |
Berisi array antrean saat ini untuk paket yang berbeda:
|
| plan |
Berisi antrean saat ini untuk paket saat ini (tambahkan api_token ke permintaan untuk paket terdaftar/premium):
|
Untuk mendapatkan informasi tentang pemisahan demo, Anda perlu membuat panggilan GET ke url berikut:
https://mvsep.com/api/app/demo
| Bidang | Jenis | Deskripsi |
|---|---|---|
| start | Integer (Bilangan Bulat) | (opsional) Offset titik awal, default ke 0 (yaitu mulai dari yang terbaru) |
| limit | Integer (Bilangan Bulat) | (opsional) Jumlah maksimum hasil yang dikembalikan, default ke 10, maksimum 20. |
| algorithm_id | Integer (Bilangan Bulat) | ID tipe pemisahan opsional. Gunakan ini untuk mengembalikan demo pemisahan yang dibuat oleh satu algoritma saja. Nilai sesuai dengan render_id dari endpoint AMBIL TIPE PEMISAHAN. |
| options[FIELD] | String / Integer | Filter opsional untuk nilai opsi algoritma. Ganti FIELD dengan kunci kolom tambahan dari algorithm_fields -> name dalam respons AMBIL TIPE PEMISAHAN, lalu masukkan salah satu kunci options kolom tersebut sebagai nilainya. Contoh: options[vocals]=1. |
| additional_options | String | Filter 'raw contains' opsional terhadap data opsi pekerjaan yang tersimpan. Lebih disarankan menggunakan options[FIELD] untuk integrasi baru karena lebih eksplisit dan lebih mudah disusun. |
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'
Untuk membangun filter opsi, pertama panggil https://mvsep.com/api/app/algorithms dan periksa daftar algorithm_fields setiap algoritma. Gunakan field name di dalam options[FIELD] dan gunakan salah satu kunci opsi JSON sebagai nilainya.
Mengembalikan data sebagai array:
| Kunci | Nilai |
|---|---|
| hash | Hash Pemisahan |
| date | Tanggal pemisahan |
| input_audio | Masukkan URL audio |
| size | Masukkan ukuran audio |
| algorithm | Berisi informasi dasar tentang jenis pemisahan yang digunakan (lihat tab GET SEPARATION TYPES untuk informasi tentang parameter yang dikembalikan) |
Untuk mengautentikasi pengguna dan mendapatkan kunci API pengguna, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/app/login
| Bidang | Jenis | Deskripsi |
|---|---|---|
| String | Email pengguna | |
| password | String | Kata sandi pengguna |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Email pengguna>"' --form 'password="<Kata sandi pengguna>"'
| Kunci | Nilai |
|---|---|
| success |
|
| data | Berisi informasi saat kredensial valid |
| data -> name | Nama pengguna |
| data -> email | Email pengguna |
| data -> api_token | Kunci API pengguna. Pastikan untuk menyimpannya di tempat penyimpanan yang aman dan gunakan untuk operasi selanjutnya |
| data -> premium_minutes | Kredit tersisa untuk pengguna |
| data -> premium_enabled |
Apakah pengguna mengizinkan kredit untuk dibelanjakan.
|
| data -> long_filenames_enabled |
Apakah pengguna menginginkan informasi tambahan dalam nama file:
|
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | Kredensial yang diberikan salah |
Untuk mendaftarkan pengguna ke situs MVSEP, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/app/register
| Bidang | Jenis | Deskripsi |
|---|---|---|
| name | String | Nama pengguna |
| String | Email pengguna | |
| password | String | Kata sandi pengguna |
| password_confirmation | String | Ulangi kata sandi pengguna |
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"'
| Kunci | Nilai |
|---|---|
| success |
|
| message | Terjadi ketika formulir tersebut valid |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | Formulir tidak valid |
Untuk mendapatkan informasi pengguna, Anda perlu membuat panggilan GET ke url berikut:
https://mvsep.com/api/app/user
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<API Token Anda>'
| Kunci | Nilai |
|---|---|
| success |
|
| data | Berisi informasi saat kredensial valid |
| data -> name | Nama pengguna |
| data -> email | Email pengguna |
| data -> api_token | Kunci API pengguna. Pastikan untuk menyimpannya di tempat penyimpanan yang aman dan gunakan untuk operasi selanjutnya |
| data -> premium_minutes | Kredit tersisa untuk pengguna |
| data -> premium_enabled |
Apakah pengguna mengizinkan kredit untuk dibelanjakan.
|
| data -> long_filenames_enabled |
Apakah pengguna menginginkan informasi tambahan dalam nama file:
|
| data -> current_queue | Menunjukkan pemisahan yang sedang berlangsung untuk pengguna |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | API key tidak valid |
Untuk mendapatkan informasi dasar tentang riwayat pemisahan pengguna, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/app/separation_history
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
| start | Integer (Bilangan Bulat) | (opsional) Offset titik awal, default ke 0 (yaitu mulai dari yang terbaru) |
| limit | Integer (Bilangan Bulat) | (opsional) Jumlah maksimum hasil yang dikembalikan, default ke 10, maksimum 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<API Token Anda>&start=1&limit=2'
| Kunci | Nilai |
|---|---|
| success |
|
| data | Berisi informasi dasar tentang pemisahan sebelumnya |
| data -> hash | Hash Pemisahan |
| data -> job_exists | Berisi informasi dasar tentang pemisahan sebelumnya |
| data -> credits | Berapa banyak kredit yang digunakan untuk pekerjaan itu, null jika pemisahan tidak ada |
| data -> time_left | Perkiraan waktu tersisa hingga pekerjaan dihapus |
| data -> algorithm | Berisi informasi dasar tentang jenis pemisahan yang digunakan (lihat tab GET SEPARATION TYPES untuk informasi tentang parameter yang dikembalikan) |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | API key tidak valid |
Untuk mengaktifkan penggunaan premium bagi pengguna, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/app/enable_premium
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<API Token Anda>"'
| Kunci | Nilai |
|---|---|
| success |
|
| message | Menginformasikan tentang status operasi |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | API key tidak valid |
Untuk menonaktifkan penggunaan premium bagi pengguna, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/app/disable_premium
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<API Token Anda>"'
| Kunci | Nilai |
|---|---|
| success |
|
| message | Menginformasikan tentang status operasi |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | API key tidak valid |
Untuk mengaktifkan nama file yang panjang bagi pengguna, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/app/enable_long_filenames
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<API Token Anda>"'
| Kunci | Nilai |
|---|---|
| success |
|
| message | Menginformasikan tentang status operasi |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | API key tidak valid |
Untuk menonaktifkan nama file yang panjang bagi pengguna, Anda perlu membuat panggilan POST ke url berikut:
https://mvsep.com/api/app/disable_long_filenames
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | API key pengguna |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<API Token Anda>"'
| Kunci | Nilai |
|---|---|
| success |
|
| message | Menginformasikan tentang status operasi |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | API key tidak valid |
Untuk mendapatkan informasi tentang entri antrean Pemeriksa Kualitas, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/quality_checker/queue
| Bidang | Jenis | Deskripsi |
|---|---|---|
| start | Integer (Bilangan Bulat) | (opsional) Offset titik awal, default ke 0 (yaitu mulai dari yang terbaru) |
| limit | Integer (Bilangan Bulat) | (opsional) Jumlah maksimum hasil yang dikembalikan, default ke 10, maksimum 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Mengembalikan data sebagai array:
| Kunci | Nilai |
|---|---|
| id | Nomor identifikasi entri |
| dataset_type | Tipe dataset yang dipilih saat menambahkan entri / tipe papan peringkat
|
| date | Tanggal pembuatan entri |
| algo_name | Nama tipe pemisahan/algoritma yang digunakan |
| main_text | Deskripsi tipe pemisahan/algoritma yang digunakan |
| proc | Status pemrosesan
|
| proc_remote_date | Stempel waktu tanggal pemrosesan |
| msg | Mengembalikan "OK" jika berhasil, jika tidak akan menampilkan pesan kesalahan |
| metrics | Informasi tentang metrik entri |
| sdr_* (wildcard) | SDR dari stem yang sesuai |
| dataset_name | Nama dataset |
Untuk mendapatkan informasi tentang papan peringkat Pemeriksa Kualitas, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/quality_checker/leaderboard
| Bidang | Jenis | Deskripsi |
|---|---|---|
| dataset_type | String | Tipe dataset, default ke 0 jika tidak diberikan.
|
| start | Integer (Bilangan Bulat) | (opsional) Offset titik awal, default ke 0 (yaitu mulai dari yang terbaru) |
| limit | Integer (Bilangan Bulat) | (opsional) Jumlah maksimum hasil yang dikembalikan, default ke 10, maksimum 20. |
| algo_name_filter | String | Menyaring nama tipe pemisahan/algoritma berdasarkan teks yang diberikan |
| sort | String | Urutkan berdasarkan SDR stem yang diberikan. Anda bisa mendapatkan daftar nilai yang dapat diurutkan untuk tipe dataset tertentu dari kunci sortables dalam respons. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Kunci | Nilai |
|---|---|
| data | Berisi array entri Pemeriksa Kualitas. Lihat respons AMBIL ANTREAN dari bagian Pemeriksa Kualitas untuk informasi lebih lanjut. |
| dataset_type | Kunci tipe dataset yang digunakan |
| sortables | Kunci yang dapat digunakan untuk mengurutkan tipe dataset yang digunakan berdasarkan stem tertentu secara berurutan. |
| sort | Kunci pengurutan yang digunakan dari sortable. |
Untuk membuat entri Pemeriksa Kualitas, Anda perlu melakukan panggilan POST ke url berikut:
https://mvsep.com/api/quality_checker/add
| Bidang | Jenis | Deskripsi |
|---|---|---|
| api_token | String | (diperlukan) Kunci API Anda |
| zipfile | Biner | (diperlukan) File zip yang akan diproses |
| algo_name | String | (diperlukan) Nama algoritma |
| main_text | String | (diperlukan) Deskripsi algoritma |
| dataset_type | String | Tipe dataset. Default ke 0.
|
| password | String | (diperlukan) Kata sandi untuk menghapus algoritma |
| ensemble | Integer (Bilangan Bulat) | 0 - algoritma bukan ansambel (ensemble). 1 - algoritma adalah ansambel. |
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"'
| Kunci | Nilai |
|---|---|
| success |
|
| data | Berisi informasi tentang entri |
| data -> id | ID entri |
| data -> link | Tautan ke entri |
API MVSEP menggunakan kode kesalahan berikut:
| Kode Kesalahan | Arti |
|---|---|
| 400 | Formulir tidak valid |
| 401 |
api_token tidak dikenal atau tidak valid. Kesalahan ini muncul jika Anda menggunakan kunci API yang tidak dikenal.
|
Untuk mendapatkan informasi tentang entri antrean Pemeriksa Kualitas berdasarkan id, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/quality_checker/entry
| Bidang | Jenis | Deskripsi |
|---|---|---|
| id | Integer (Bilangan Bulat) | (diperlukan) ID entri |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Untuk menghapus entri antrean Pemeriksa Kualitas berdasarkan id dan kata sandi, Anda perlu melakukan panggilan GET ke url berikut:
https://mvsep.com/api/quality_checker/delete
| Bidang | Jenis | Deskripsi |
|---|---|---|
| id | Integer (Bilangan Bulat) | (diperlukan) ID entri |
| password | String | (diperlukan) Kata sandi yang digunakan untuk entri |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Kunci | Nilai |
|---|---|
| success |
|
| data->message | Menunjukkan apakah entri telah dihapus |
turbo@mvsep.com