turbo@mvsep.com
API MVSEP cung cấp quyền truy cập theo chương trình để tạo tách, trả về kết quả, lấy thông tin trang web và kiểm soát khả năng của người dùng.
Để sử dụng API, bạn phải cần Token API. Bạn chưa đăng nhập, vui lòng đăng nhập để nhận token API của bạn.
Lưu ý rằng người dùng Premium có thể yêu cầu số lượng tác vụ đồng thời không giới hạn, trong khi người dùng không phải Premium chỉ có thể yêu cầu 1 tác vụ đồng thời.
MVSEP vận hành các điểm cuối API theo khu vực. Tất cả các khu vực đều sử dụng chung một cơ sở dữ liệu tài khoản, do đó cùng một tài khoản, khóa API và mã băm công việc sẽ hoạt động ở mọi nơi:
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://hk.mvsep.com/apiCác yêu cầu gửi đến https://mvsep.com/api sẽ được định hướng theo vị trí địa lý đến khu vực gần nhất với người gọi. Đối với việc tích hợp API, chúng tôi khuyến nghị gọi trực tiếp đến điểm cuối khu vực — điều này giúp duy trì toàn bộ vòng đời công việc trên một máy chủ duy nhất, bất kể yêu cầu của bạn xuất phát từ đâu.
Mỗi quá trình tách dữ liệu đều được xử lý và lưu trữ tại vùng mà nó được tạo ra, và các URL tải xuống được trả về trong phản hồi luôn trỏ đến máy chủ của vùng đó. Để đạt hiệu suất tốt nhất, hãy chọn điểm cuối gần nhất với các máy chủ của bạn và sử dụng cùng một máy chủ cho toàn bộ vòng đời công việc — từ tạo công việc, kiểm tra trạng thái đến tải xuống tệp.
Bạn có thể tra cứu trạng thái của bất kỳ tác vụ nào từ bất kỳ khu vực nào (cơ sở dữ liệu được chia sẻ), nhưng các tệp đầu ra luôn được cung cấp bởi khu vực sở hữu tác vụ đó.
Để tạo môi trường tách, bạn cần yêu cầu lệnh POST tới url sau:
https://mvsep.com/api/separation/create
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Token API của bạn |
| audiofile | Nhị phân | Tệp âm thanh cần xử lý. Thông số này không bắt buộc nếu thông số url đã được thiết lập hoặc mô hình không sử dụng đầu vào tệp. Đối với các mô hình so sánh, hãy sử dụng target_audiofile và reference_audiofile làm đầu vào thay vì audiofile. |
| url | Dây | Liên kết đến tệp âm thanh. Không bắt buộc nếu tham số audiofile đã được thiết lập. |
| remote_type | Dây | (tùy chọn) Loại tải xuống từ xa của tệp âm thanh. Giá trị mặc định là direct. Không bắt buộc nếu tham số audiofile đã được thiết lập. Các loại được hỗ trợ bao gồm direct (Tải xuống trực tiếp), mega (MEGA), drive (Google Drive), dropbox (Dropbox). |
| sep_type | Số nguyên | (tùy chọn) Loại mô hình, mặc định là 11 (Demucs3 Model B (vocals, drums, bass, other)) |
| preset_id | Số nguyên | (tùy chọn) Áp dụng một trong các cài đặt sẵn đã lưu của bạn lên tệp thay vì sử dụng một thuật toán duy nhất. Cung cấp sep_type hoặc preset_id — một cài đặt sẵn định nghĩa các thuật toán, tùy chọn và định dạng đầu ra riêng của nó, do đó sep_type, các trường add_opt và output_format đều bị bỏ qua cùng với nó. Phản hồi trả về một đối tượng hash mà bạn truy vấn giống hệt như khi thực hiện tách dữ liệu; kết quả chứa một mục cho mỗi nút Output của preset. Xem bảng preset bên dưới để biết các ID tương ứng. |
| add_opt1 | Dây | (tùy chọn) Loại trường phân tách bổ sung đầu tiên |
| add_opt2 | Dây | (tùy chọn) Loại trường phân tách bổ sung thứ hai |
| add_opt3 | Dây | (tùy chọn) Loại tách bổ sung thứ ba |
| output_format | Số nguyên | (tùy chọn) định dạng đầu ra, mặc định là 0 (mp3 (320kbps)) |
| is_demo | Boolean | (tùy chọn) tệp được xuất bản lên trang demo, mặc định là false |
| Tên | Giá trị | Các trường bổ sung |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Khoá: add_opt1 Tên: Output files Tuỳ chọn:
Khoá: add_opt2 Tên: Model Type Tuỳ chọn:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Khoá: add_opt1 Tên: Output files Tuỳ chọn:
Khoá: add_opt2 Tên: Model Type Tuỳ chọn:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Khoá: add_opt1 Tên: Output files Tuỳ chọn:
Khoá: add_opt2 Tên: Model Type Tuỳ chọn:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| BS Roformer (vocals, instrumental) | 40 | Khoá: add_opt1 Tên: Vocal model type Tuỳ chọn:
Khoá: add_opt2 Tên: Overlap Tuỳ chọn:
Khoá: add_opt3 Tên: Set of stems Tuỳ chọn:
|
| BS PolarFormer (vocals, instrumental) | 123 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: Overlap Tuỳ chọn:
|
| MelBand Roformer (vocals, instrumental) | 48 | Khoá: add_opt1 Tên: Vocal model type Tuỳ chọn:
Khoá: add_opt2 Tên: Overlap Tuỳ chọn:
|
| MDX23C (vocals, instrumental) | 25 | Khoá: add_opt1 Tên: Vocal model type Tuỳ chọn:
|
| SCNet (vocals, instrumental) | 46 | Khoá: add_opt1 Tên: Vocal model type Tuỳ chọn:
|
| MDX B (vocals, instrumental) | 23 | Khoá: add_opt1 Tên: Vocal model type Tuỳ chọn:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
Khoá: add_opt2 Tên: Agressiveness Tuỳ chọn:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | Khoá: add_opt1 Tên: Karaoke model type Tuỳ chọn:
Khoá: add_opt2 Tên: Extraction type Tuỳ chọn:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Khoá: add_opt1 Tên: Karaoke model type Tuỳ chọn:
|
| MVSep Crowd removal (crowd, other) | 34 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| Medley Vox (Multi-singer separation) | 53 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
Khoá: add_opt2 Tên: Processing Mode Tuỳ chọn:
|
| MVSep Male/Female separation | 57 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Choir (choir, other) | 112 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Drums (drums, other) | 44 | Khoá: add_opt1 Tên: Drums model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
Khoá: add_opt3 Tên: Output files Tuỳ chọn:
|
| MVSep Bass (bass, other) | 41 | Khoá: add_opt1 Tên: Bass model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
Khoá: add_opt3 Tên: Output files Tuỳ chọn:
|
| MVSep Synth (synth, other) | 88 | Khoá: add_opt1 Tên: How to extract Tuỳ chọn:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
Khoá: add_opt2 Tên: Preprocess Tuỳ chọn:
|
| MVSep Piano (piano, other) | 29 | Khoá: add_opt1 Tên: Piano model type Tuỳ chọn:
|
| MVSep Digital Piano (digital-piano, other) | 79 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | Khoá: add_opt1 Tên: Organ model type Tuỳ chọn:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| MVSep Guitar (guitar, other) | 31 | Khoá: add_opt1 Tên: Guitar model type Tuỳ chọn:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| 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 | Khoá: add_opt1 Tên: String model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Cello (cello, other) | 70 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Double Bass (double-bass, other) | 73 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Wind (wind, other) | 54 | Khoá: add_opt1 Tên: Wind model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
Khoá: add_opt3 Tên: Output files Tuỳ chọn:
|
| MVSep Brass (brass, other) | 107 | Khoá: add_opt1 Tên: How to extract Tuỳ chọn:
|
| MVSep Woodwind (woodwind, other) | 108 | Khoá: add_opt1 Tên: How to extract Tuỳ chọn:
|
| MVSep Saxophone (saxophone, other) | 61 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| MVSep Flute (flute, other) | 67 | Khoá: add_opt1 Tên: Flute model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Trumpet (trumpet, other) | 71 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Trombone (trombone, other) | 75 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Oboe (oboe, other) | 77 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Clarinet (clarinet, other) | 78 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep French Horn (french-horn, other) | 82 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Harmonica (harmonica, other) | 87 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| 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 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Celesta (celesta, other) | 110 | Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
|
| MVSep DnR v3 (speech, music, effects) | 56 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: How to extract Tuỳ chọn:
Khoá: add_opt3 Tên: Output files Tuỳ chọn:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: Cutoff (Hz) Tuỳ chọn:
|
| Reverb Removal (noreverb) | 22 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
Khoá: add_opt2 Tên: Preprocess Tuỳ chọn:
|
| DeNoise by aufr33 and gabox | 47 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| AudioSR (Super Resolution) | 59 | Khoá: add_opt1 Tên: Cutoff (Hz) Tuỳ chọn:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | Khoá: add_opt1 Tên: Text prompt Tuỳ chọn: Khoá: add_opt2 Tên: Length (in seconds) Tuỳ chọn:
|
| Whisper (extract text from audio) | 39 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: Transcription type Tuỳ chọn:
|
| Parakeet (extract text from audio) | 64 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: Version Tuỳ chọn:
|
| VibeVoice (Voice Cloning) | 103 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: Text prompt Tuỳ chọn: Khoá: add_opt3 Tên: Extract vocals first Tuỳ chọn:
|
| VibeVoice (TTS) | 104 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
Khoá: add_opt2 Tên: Text prompt Tuỳ chọn: |
| Qwen3-TTS (Custom Voice) | 118 | Khoá: add_opt1 Tên: Text prompt Tuỳ chọn: Khoá: add_opt2 Tên: Speaker Tuỳ chọn:
Khoá: add_opt3 Tên: Language Tuỳ chọn:
Khoá: add_opt4 Tên: Voice description Tuỳ chọn: |
| Qwen3-TTS (Voice Design) | 119 | Khoá: add_opt1 Tên: Text prompt Tuỳ chọn: Khoá: add_opt2 Tên: Voice description Tuỳ chọn: Khoá: add_opt3 Tên: Language Tuỳ chọn:
|
| Qwen3-TTS (Voice Cloning) | 120 | Khoá: add_opt1 Tên: Text prompt Tuỳ chọn: Khoá: add_opt2 Tên: Reference text in audio (optional) Tuỳ chọn: Khoá: add_opt3 Tên: Language Tuỳ chọn:
Khoá: add_opt4 Tên: Extract vocals first Tuỳ chọn:
|
| Mega 53-stem Model | 126 | |
| Bark (Speech Gen) | 115 | Khoá: add_opt1 Tên: Text prompt Tuỳ chọn: Khoá: add_opt2 Tên: Speaker Tuỳ chọn:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
|
| Aspiration (by Sucial) | 50 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| Phantom Centre extraction | 55 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | Khoá: add_opt1 Tên: How to use Tuỳ chọn:
|
| Transkun (Piano -> MIDI) | 113 | Khoá: add_opt1 Tên: How to extract Tuỳ chọn:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | Khoá: add_opt1 Tên: How to extract Tuỳ chọn:
|
| HeartMuLa (Song Gen) | 121 | Khoá: add_opt1 Tên: Lyrics Tuỳ chọn: Khoá: add_opt10 Tên: Topic Tuỳ chọn:
Khoá: add_opt2 Tên: Tags (optional) Tuỳ chọn: Khoá: add_opt3 Tên: Genre Tuỳ chọn:
Khoá: add_opt4 Tên: Timbre Tuỳ chọn:
Khoá: add_opt5 Tên: Gender Tuỳ chọn:
Khoá: add_opt6 Tên: Mood Tuỳ chọn:
Khoá: add_opt7 Tên: Instrument Tuỳ chọn:
Khoá: add_opt8 Tên: Scene Tuỳ chọn:
Khoá: add_opt9 Tên: Region Tuỳ chọn:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Khoá: add_opt1 Tên: Vocal model type Tuỳ chọn:
|
| Vit Large 23 (vocals, instrum) | 33 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| UVRv5 Demucs (vocals, music) | 17 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
|
| 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 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| UnMix | 3 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
| Zero Shot (Query Based) (Low quality) | 14 | Khoá: add_opt1 Tên: Model Type Tuỳ chọn:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Khoá: add_opt1 Tên: Model type Tuỳ chọn:
|
Các cài đặt sẵn chỉ dành riêng cho tài khoản đã tạo ra chúng, do đó bảng này hiển thị các cài đặt sẵn của bạn cùng với những cài đặt sẵn đã được chọn lọc. Bạn có thể tạo và chỉnh sửa chúng trong trình chỉnh sửa cài đặt sẵn.
Bạn chưa có cài đặt sẵn nào. Hãy đăng nhập và tạo một cài đặt sẵn trong trình chỉnh sửa cài đặt sẵn, và ID của nó sẽ xuất hiện tại đây.
| Tên | Giá trị |
|---|---|
| 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="<Token API của bạn>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| Khoá | Giá trị |
|---|---|
| success |
|
| data | Giữ thông tin bổ sung tùy thuộc vào khóa thành công |
| data -> link | Hiển thị liên kết đến URL "NHẬN KẾT QUẢ" của công việc đã tạo (chỉ hiển thị khi thành công là đúng) |
| data -> hash | Hiển thị công việc đã tạo (chỉ hiển thị khi thành công là đúng) |
| data -> message | Hiển thị mô tả về lỗi (chỉ hiển thị khi thành công là sai) |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Một số tham số bị thiếu hoặc không hợp lệ. Lỗi này xuất hiện khi bạn không đặt các tham số bắt buộc hoặc truyền các tham số không hợp lệ. |
| 401 |
api_token không xác định hoặc không hợp lệ. Lỗi này xuất hiện nếu bạn sử dụng token API không xác định.
|
Để nhận kết quả tách, bạn cần yêu cầu lệnh GET tới url sau:
https://mvsep.com/api/separation/get
Cùng một điểm cuối này trả về các lần chạy đã được cài đặt sẵn: hãy truy vấn giá trị băm mà bạn nhận được từ preset_id theo cách hoàn toàn giống như khi bạn thực hiện một lần tách dữ liệu. Phần bao bọc là giống hệt nhau — status chuyển từ waiting và processing sang done — và data.type là preset_run. Mỗi mục trong data.files là một nút Output của cài đặt sẵn, được đặt tên theo nhãn của nó thay vì theo gốc từ. Một lần chạy chỉ hiển thị với tài khoản đã tạo ra nó.
| Trường | Loại | Mô tả |
|---|---|---|
| hash | Dây | Hash được phân tách |
| mirror | Số nguyên | (tùy chọn) Sử dụng một bản sao khác nếu đặt thành 1, mặc định là 0. Yêu cầu api_token và 1 điểm tín dụng nếu đặt thành 1. |
| api_token | Dây | (tùy chọn) Khóa API của người dùng. Bắt buộc nếu tham số phản chiếu được đặt thành 1. |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| Khoá | Giá trị |
|---|---|
| success |
|
| status |
|
| data | Giữ thông tin bổ sung tùy thuộc vào phím trạng thái |
| data -> queue_count | Hiển thị số lượng tác vụ chưa được xử lý trong mức độ ưu tiên của người dùng (chỉ hiển thị khi trạng thái đang chờ hoặc phân phối) |
| data -> current_order | Hiển thị thứ tự công việc của người dùng (chỉ hiển thị khi trạng thái đang chờ hoặc phân phối) |
| data -> message | Hiển thị mô tả trạng thái (hiển thị trên tất cả các trạng thái, thay vào đó hiển thị lý do lỗi khi trạng thái không thành công) |
| data -> algorithm | Hiển thị thuật toán được sử dụng trong công việc (chỉ hiển thị khi trạng thái hoàn tất) |
| data -> algorithm_description | Hiển thị chi tiết thuật toán được sử dụng trên công việc (chỉ hiển thị khi trạng thái được thực hiện) |
| data -> output_format | Hiển thị định dạng đầu ra của công việc (chỉ hiển thị khi trạng thái được thực hiện) |
| data -> tags | Hiển thị thẻ meta âm thanh (chỉ hiển thị khi trạng thái hoàn tất) |
| data -> input_file | Hiển thị chi tiết tải xuống âm thanh đầu vào (chỉ hiển thị khi trạng thái hoàn tất) |
| data -> files | Hiển thị chi tiết tải xuống âm thanh đầu ra (chỉ hiển thị khi trạng thái hoàn tất) |
| data -> date | Hiển thị ngày xử lý công việc (chỉ hiển thị khi trạng thái được thực hiện) |
| data -> finished_chunks | Hiển thị số lượng các bộ phận đã hoàn thành của một tác vụ lớn (chỉ hiển thị khi trạng thái đang phân phối) |
| data -> all_chunks | Hiển thị số lượng tất cả các bộ phận của một tác vụ lớn (chỉ hiển thị khi trạng thái đang phân phối) |
Để lấy kết quả của một tác vụ từ xa, bạn cần thực hiện một yêu cầu GET tới URL sau:
https://mvsep.com/api/separation/get-remote
| Trường | Loại | Mô tả |
|---|---|---|
| hash | Dây | Hash được phân tách |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| Khoá | Giá trị |
|---|---|
| success |
|
| status |
|
| data | Giữ thông tin bổ sung tùy thuộc vào phím trạng thái |
| data -> queue_count | Hiển thị số lượng tác vụ chưa được xử lý theo mức độ ưu tiên của người dùng (chỉ hiển thị khi trạng thái status là waiting). |
| data -> current_order | Hiển thị thứ tự công việc của người dùng (chỉ hiển thị khi trạng thái là đang chờ). |
| data -> message | Hiển thị mô tả trạng thái (chỉ khi status là failed). |
| data -> link | Hiển thị liên kết đến URL "GET RESULT" của tác vụ đã tạo (chỉ hiển thị khi trạng thái là hoàn tất). |
| data -> hash | Băm của quá trình tách (chỉ hiển thị khi trạng thái là hoàn tất). |
Để hủy việc tách tài khoản và hoàn lại số dư đã sử dụng (nếu việc tách tài khoản chưa được xử lý), bạn cần thực hiện yêu cầu POST tới URL sau:
https://mvsep.com/api/separation/cancel
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
| hash | Dây | Hash được phân tách |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<Token API của bạn>"' --form 'hash="<hash>"'
| Khoá | Giá trị |
|---|---|
| success |
|
Để nhận dữ liệu chi tiết về các kiểu phân tách, bạn cần thực hiện lệnh gọi GET đến url sau:
https://mvsep.com/api/app/algorithms
| Trường | Loại | Mô tả |
|---|---|---|
| scopes | Dây | Có nên bao gồm các mô hình sử dụng các dạng đầu vào khác nhau hay không.
single_upload. Để lấy tất cả các mô hình, hãy đặt scopes=single_upload,no_upload,matchering_upload.
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
Trả về dữ liệu dưới dạng mảng:
| Khoá | Giá trị |
|---|---|
| render_id | Giá trị loại phân tách (ID) |
| name | Tên của loại phân tách |
| algorithm_group_id | Nhóm nơi loại phân tách thuộc về: |
| algorithm_group | Chứa thông tin về nhóm thuật toán mà thuật toán này thuộc về. |
| algorithm_group -> name | Tên nhóm thuật toán. |
| audio_widget |
Loại tiện ích âm thanh sẽ được sử dụng cho thuật toán. Thông số này có thể được dùng để xác định cách hiển thị trình phát âm thanh của thuật toán trên giao diện người dùng. Các giá trị có thể là:
|
| orientation |
Loại phân tách này dự định cho ai:
|
| order_id | Thứ tự của loại phân tách |
| price_coefficient |
Được sử dụng để tính toán công việc lấy bao nhiêu điểm tín dụng từ người dùng cao cấp. Sử dụng công thức này : floor(<Thời lượng tệp âm thanh tính bằng giây> * price_coefficient / 60)?:1
|
| usage | Hiển thị số lượng sử dụng hàng tháng theo loại phân loại |
| rating | Hiển thị tỷ lệ sử dụng hàng tháng của từng loại phân loại dưới dạng mảng:
|
| algorithm_fields | Chứa thông tin về các trường bổ sung của kiểu phân tách |
| algorithm_fields -> name |
Hiển thị trường bổ sung nào của kiểu phân tách:
|
| algorithm_fields -> text | Hiển thị tên của trường bổ sung của loại phân tách. |
| algorithm_fields -> options | Chuỗi khóa-giá trị được mã hóa JSON của trường bổ sung |
| algorithm_fields -> default_key | Giá trị mặc định của trường bổ sung. Một trong những chìa khóa của <code>algorithm_fields -> tùy chọn</code> |
| algorithm_descriptions | Chứa thông tin về các mô tả của loại phân tách |
| algorithm_descriptions -> short_description | Mô tả nhỏ về kiểu phân tách không sử dụng HTML. |
| algorithm_descriptions -> long_description | Mô tả chi tiết về kiểu phân tách sử dụng HTML. |
| algorithm_descriptions -> lang | Mã ngôn ngữ được chỉ định của mô tả. |
Để nhận thông tin về tin tức mới nhất về MVSEP, bạn cần thực hiện lệnh gọi GET đến url sau:
https://mvsep.com/api/app/news
| Trường | Loại | Mô tả |
|---|---|---|
| lang | Dây | (tùy chọn) Mã ngôn ngữ gồm 2 chữ cái (en, ru) |
| start | Số nguyên | (tùy chọn) Độ lệch điểm bắt đầu, mặc định là 0 (tức là bắt đầu từ mới nhất) |
| limit | Số nguyên | (tùy chọn) Số lượng kết quả trả về tối đa, mặc định là 10, tối đa là 20. |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
Trả về dữ liệu dưới dạng mảng:
| Khoá | Giá trị |
|---|---|
| title | Tiêu để của tin tức |
| lang | Tiêu để của tin tức |
| text | Mô tả đầy đủ về tin tức |
| created_at | Ngày của tin tức |
Để lấy thông tin về hàng đợi của trang web, bạn cần thực hiện một yêu cầu GET tới URL sau:
https://mvsep.com/api/app/queue
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | (tùy chọn) Khóa API của người dùng |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Khoá | Giá trị |
|---|---|
| queue |
Chứa mảng các hàng đợi hiện tại cho các gói dịch vụ khác nhau:
|
| plan |
Chứa hàng đợi hiện tại cho gói hiện tại (thêm api_token vào yêu cầu đối với gói đã đăng ký/gói cao cấp):
|
Để nhận thông tin về tách demo, bạn cần thực hiện lệnh gọi GET đến url sau:
https://mvsep.com/api/app/demo
| Trường | Loại | Mô tả |
|---|---|---|
| start | Số nguyên | (tùy chọn) Độ lệch điểm bắt đầu, mặc định là 0 (tức là bắt đầu từ mới nhất) |
| limit | Số nguyên | (tùy chọn) Số lượng kết quả trả về tối đa, mặc định là 10, tối đa là 20. |
| algorithm_id | Số nguyên | ID loại tách màu tùy chọn. Sử dụng tùy chọn này để trả về các bản tách màu demo được tạo bởi duy nhất một thuật toán. Các giá trị này tương ứng với render_id từ điểm cuối GET SEPARATION TYPES. |
| options[FIELD] | Chuỗi / Số nguyên | Bộ lọc tùy chọn cho các giá trị tùy chọn của thuật toán. Thay thế FIELD bằng một khóa trường bổ sung từ algorithm_fields -> name trong phản hồi GET SEPARATION TYPES, sau đó truyền một trong các khóa options của trường đó làm giá trị. Ví dụ: options[vocals]=1. |
| additional_options | Dây | Tùy chọn raw chứa bộ lọc dựa trên dữ liệu tùy chọn công việc đã lưu. Nên ưu tiên sử dụng options[FIELD] cho các tích hợp mới vì cách này rõ ràng và dễ cấu hình hơn. |
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'
Để tạo bộ lọc tùy chọn, trước tiên hãy gọi https://mvsep.com/api/app/algorithms và kiểm tra danh sách algorithm_fields của từng thuật toán. Sử dụng trường name bên trong options[FIELD] và lấy một trong các khóa tùy chọn JSON làm giá trị.
Trả về dữ liệu dưới dạng mảng:
| Khoá | Giá trị |
|---|---|
| hash | Hash được phân tách |
| date | Ngày chia tay |
| input_audio | URL âm thanh đầu vào |
| size | Kích thước âm thanh đầu vào |
| algorithm | Chứa thông tin cơ bản về kiểu phân tách đã sử dụng (tham khảo tab Nhận các loại phân tách để biết thông tin về các tham số trả về) |
Để đăng ký người dùng vào trang MVSEP, bạn cần thực hiện lệnh gọi POST đến url sau:
https://mvsep.com/api/app/register
| Trường | Loại | Mô tả |
|---|---|---|
| name | Dây | Tên của người dùng |
| Dây | Email của người dùng | |
| password | Dây | Mật khẩu của người dùng |
| password_confirmation | Dây | Lặp lại mật khẩu của người dùng |
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"'
| Khoá | Giá trị |
|---|---|
| success |
|
| message | Xảy ra khi biểu mẫu hợp lệ |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Biểu mẫu không hợp lệ |
Để xác thực người dùng và nhận khóa API của người dùng, bạn cần thực hiện lệnh gọi POST đến url sau:
https://mvsep.com/api/app/login
| Trường | Loại | Mô tả |
|---|---|---|
| Dây | Email của người dùng | |
| password | Dây | Mật khẩu của người dùng |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<Email của người dùng>"' --form 'password="<Mật khẩu của người dùng>"'
| Khoá | Giá trị |
|---|---|
| success |
|
| data | Chứa thông tin khi thông tin đăng nhập hợp lệ |
| data -> name | Tên của người dùng |
| data -> email | Email của người dùng |
| data -> api_token | Khóa API của người dùng. Đảm bảo lưu trữ nó trong bộ nhớ an toàn và sử dụng cho các hoạt động tiếp theo. |
| data -> premium_minutes | Điểm tín dụng còn lại cho người dùng |
| data -> premium_enabled |
Người dùng có cho phép sử dụng điểm tín dụng hay không.
|
| data -> long_filenames_enabled |
Người dùng có muốn biết thêm thông tin trong tên tệp hay không:
|
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Thông tin đăng nhập không chính xác được chỉ định |
Để lấy thông tin người dùng, bạn cần thực hiện lệnh gọi GET đến url sau:
https://mvsep.com/api/app/user
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<Token API của bạn>'
| Khoá | Giá trị |
|---|---|
| success |
|
| data | Chứa thông tin khi thông tin đăng nhập hợp lệ |
| data -> name | Tên của người dùng |
| data -> email | Email của người dùng |
| data -> api_token | Khóa API của người dùng. Đảm bảo lưu trữ nó trong bộ nhớ an toàn và sử dụng cho các hoạt động tiếp theo. |
| data -> premium_minutes | Điểm tín dụng còn lại cho người dùng |
| data -> premium_enabled |
Người dùng có cho phép sử dụng điểm tín dụng hay không.
|
| data -> long_filenames_enabled |
Người dùng có muốn biết thêm thông tin trong tên tệp hay không:
|
| data -> current_queue | Hiển thị các khoảng cách đang diễn ra cho người dùng |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Khóa API không hợp lệ |
Để có được lịch sử tách thông tin cơ bản của người dùng, bạn cần thực hiện lệnh gọi GET đến url sau:
https://mvsep.com/api/app/separation_history
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
| start | Số nguyên | (tùy chọn) Độ lệch điểm bắt đầu, mặc định là 0 (tức là bắt đầu từ mới nhất) |
| limit | Số nguyên | (tùy chọn) Số lượng kết quả trả về tối đa, mặc định là 10, tối đa là 20. |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<Token API của bạn>&start=1&limit=2'
| Khoá | Giá trị |
|---|---|
| success |
|
| data | Chứa mảng thông tin cơ bản về các phân tách trước đó |
| data -> hash | Hash được phân tách |
| data -> job_exists | Chứa mảng thông tin cơ bản về các phân tách trước đó |
| data -> credits | Có bao nhiêu điểm tín dụng đã được sử dụng cho yêu cầu, trống nếu tách không tồn tại |
| data -> time_left | Thời gian gần đúng còn lại cho đến khi công việc bị xóa |
| data -> algorithm | Chứa thông tin cơ bản về kiểu phân tách đã sử dụng (tham khảo tab Nhận các loại phân tách để biết thông tin về các tham số trả về) |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Khóa API không hợp lệ |
Để lấy danh sách các giao dịch mua hàng bằng tín dụng của tài khoản này, sắp xếp theo thứ tự từ mới nhất đến cũ nhất, hãy thực hiện một yêu cầu GET đến URL sau:
https://mvsep.com/api/purchases
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
| limit | Số nguyên | (tùy chọn) Số lượng giao dịch cần hoàn trả, từ 1 đến 100. Giá trị mặc định là 20. |
| offset | Số nguyên | (tùy chọn) Số giao dịch cần bỏ qua khi duyệt qua lịch sử. Giá trị mặc định là 0. |
| status | Dây | (tùy chọn) Chỉ trả về các giao dịch mua ở trạng thái này, ví dụ: thành công. Bỏ qua tham số này (hoặc truyền all) để lấy tất cả các giao dịch mà trang lịch sử của chính trang web hiển thị, bao gồm cả các giao dịch đã bắt đầu nhưng chưa hoàn tất — những giao dịch này có trạng thái unpaid và không được cấp tín dụng. |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<Token API của bạn>&status=succeeded&limit=20'
| Khoá | Giá trị |
|---|---|
| purchases | Mỗi giao dịch tương ứng với một mục nhập: payment_id, status, amount, credits đã được cấp, payment_method (stripe, paddle, yookassa, google_play hoặc app_store) và date. |
| total | Tổng cộng có bao nhiêu giao dịch khớp, không tính đến giới hạn và độ lệch — sử dụng con số này để phân trang. |
| credits | Số dư tín dụng hiện tại của tài khoản. |
MVSEP sẽ gửi email cho bạn khi số dư tín dụng của bạn giảm xuống mức ngưỡng mà bạn đã chọn, để đảm bảo quá trình tích hợp đang chạy không bị dừng đột ngột. GET trả về cài đặt hiện tại; POST thay đổi cài đặt đó. Thông báo cảnh báo chỉ được gửi một lần và sẽ không lặp lại cho đến khi số dư tăng trở lại trên mức ngưỡng.
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
| credit_threshold | Số nguyên | (Chỉ POST, bắt buộc) Gửi thông báo khi số dư bằng hoặc thấp hơn số tín dụng này. 0 sẽ tắt thông báo. Việc thay đổi ngưỡng sẽ kích hoạt lại thông báo đã được gửi trước đó. |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<Token API của bạn>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<Token API của bạn>' --form 'credit_threshold=100'
| Khoá | Giá trị |
|---|---|
| credit_threshold | Ngưỡng hiện tại được quy định, tính bằng tín chỉ. |
| enabled | <code>true</code> khi ngưỡng lớn hơn 0 được đặt, ngược lại là <code>false</code>. |
| credits | Số dư tín dụng hiện tại của tài khoản. |
| notified | <code>true</code> sau khi cảnh báo đã được gửi đi cho đợt sụt giảm hiện tại; cảnh báo sẽ tự động biến mất khi mức dư trở lại trên ngưỡng. |
| Địa chỉ mà thông báo được gửi đến. |
Để bật sử dụng điểm tín dụng cho người dùng, bạn cần thực hiện lệnh gọi POST đến url sau:
https://mvsep.com/api/app/enable_premium
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<Token API của bạn>"'
| Khoá | Giá trị |
|---|---|
| success |
|
| message | Thông báo về tình trạng hoạt động |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Khóa API không hợp lệ |
Để tắt sử dụng điểm tín dụng cho người dùng, bạn cần thực hiện lệnh gọi POST đến url sau:
https://mvsep.com/api/app/disable_premium
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<Token API của bạn>"'
| Khoá | Giá trị |
|---|---|
| success |
|
| message | Thông báo về tình trạng hoạt động |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Khóa API không hợp lệ |
Để bật tên tệp dài cho người dùng, bạn cần thực hiện lệnh gọi POST đến url sau:
https://mvsep.com/api/app/enable_long_filenames
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<Token API của bạn>"'
| Khoá | Giá trị |
|---|---|
| success |
|
| message | Thông báo về tình trạng hoạt động |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Khóa API không hợp lệ |
Để tắt tên tệp dài cho người dùng, bạn cần thực hiện lệnh gọi POST đến url sau:
https://mvsep.com/api/app/disable_long_filenames
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | Khóa API của người dùng |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<Token API của bạn>"'
| Khoá | Giá trị |
|---|---|
| success |
|
| message | Thông báo về tình trạng hoạt động |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Khóa API không hợp lệ |
Để lấy thông tin về các mục trong hàng đợi của Quality Checker, bạn cần thực hiện một yêu cầu GET tới URL sau:
https://mvsep.com/api/quality_checker/queue
| Trường | Loại | Mô tả |
|---|---|---|
| start | Số nguyên | (tùy chọn) Độ lệch điểm bắt đầu, mặc định là 0 (tức là bắt đầu từ mới nhất) |
| limit | Số nguyên | (tùy chọn) Số lượng kết quả trả về tối đa, mặc định là 10, tối đa là 20. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
Trả về dữ liệu dưới dạng mảng:
| Khoá | Giá trị |
|---|---|
| id | Số nhận dạng lô hàng |
| dataset_type | Loại tập dữ liệu được chọn khi thêm mục / loại bảng xếp hạng
|
| date | Ngày tạo mục |
| algo_name | Tên loại/thuật toán phân tách được sử dụng |
| main_text | Mô tả về loại phương pháp tách/thuật toán được sử dụng |
| proc | Tình trạng xử lý
|
| proc_remote_date | Dấu thời gian của ngày xử lý |
| msg | Trả về "OK" nếu thành công, ngược lại sẽ hiển thị thông báo lỗi |
| metrics | Thông tin về các chỉ số truy cập |
| sdr_* (wildcard) | SDR của các gốc từ tương ứng |
| dataset_name | Tên bộ dữ liệu |
Để lấy thông tin về bảng xếp hạng của Quality Checker, bạn cần thực hiện một yêu cầu GET tới URL sau:
https://mvsep.com/api/quality_checker/leaderboard
| Trường | Loại | Mô tả |
|---|---|---|
| dataset_type | Dây | Loại tập dữ liệu, mặc định là 0 nếu không được chỉ định.
|
| start | Số nguyên | (tùy chọn) Độ lệch điểm bắt đầu, mặc định là 0 (tức là bắt đầu từ mới nhất) |
| limit | Số nguyên | (tùy chọn) Số lượng kết quả trả về tối đa, mặc định là 10, tối đa là 20. |
| algo_name_filter | Dây | Lọc các tên loại/thuật toán phân tách theo văn bản đã cho |
| sort | Dây | Sắp xếp theo giá trị SDR của phần gốc. Bạn có thể lấy danh sách các giá trị có thể sắp xếp cho loại tập dữ liệu cụ thể từ khóa sortables trong phản hồi. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Khoá | Giá trị |
|---|---|
| data | Chứa mảng các mục trong Quality Checker. Để biết thêm thông tin, vui lòng tham khảo phần “Phản hồi GET QUEUE từ Quality Checker”. |
| dataset_type | Khóa loại tập dữ liệu đã sử dụng |
| sortables | Các khóa có thể được sử dụng để sắp xếp các loại tập dữ liệu đã sử dụng theo thứ tự tuần tự dựa trên gốc từ được chỉ định. |
| sort | Đã sử dụng khóa sắp xếp từ sortable. |
Để tạo mục Quality Checker, bạn cần thực hiện yêu cầu POST tới URL sau:
https://mvsep.com/api/quality_checker/add
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | Dây | (bắt buộc) Token API của bạn |
| zipfile | Nhị phân | (bắt buộc) Tệp nén cần xử lý |
| algo_name | Dây | (bắt buộc) Tên thuật toán |
| main_text | Dây | (bắt buộc) Mô tả thuật toán |
| dataset_type | Dây | Loại tập dữ liệu. Giá trị mặc định là 0.
|
| password | Dây | (bắt buộc) Thuật toán xóa mật khẩu |
| ensemble | Số nguyên | 0 - thuật toán không phải là phương pháp kết hợp. 1 - thuật toán là phương pháp kết hợp. |
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"'
| Khoá | Giá trị |
|---|---|
| success |
|
| data | Chứa thông tin về mục |
| data -> id | Mã số của mục |
| data -> link | Liên kết đến bài viết |
MVSEP API sử dụng các mã lỗi sau:
| Mã lỗi | Nguyên nhân |
|---|---|
| 400 | Biểu mẫu không hợp lệ |
| 401 |
api_token không xác định hoặc không hợp lệ. Lỗi này xuất hiện nếu bạn sử dụng token API không xác định.
|
Để lấy thông tin về mục trong hàng đợi của Quality Checker theo ID, bạn cần thực hiện yêu cầu GET tới URL sau:
https://mvsep.com/api/quality_checker/entry
| Trường | Loại | Mô tả |
|---|---|---|
| id | Số nguyên | (bắt buộc) Mã số của mục |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
Để xóa mục trong hàng đợi của Quality Checker bằng ID và mật khẩu, bạn cần thực hiện yêu cầu GET tới URL sau:
https://mvsep.com/api/quality_checker/delete
| Trường | Loại | Mô tả |
|---|---|---|
| id | Số nguyên | (bắt buộc) Mã số của mục |
| password | Dây | (bắt buộc) Mật khẩu đã sử dụng cho mục này |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Khoá | Giá trị |
|---|---|
| success |
|
| data->message | Cho biết mục đó đã bị xóa hay chưa |
Các thư viện, ứng dụng và tính năng tích hợp được phát triển dựa trên API này. Trừ khi có ghi chú khác, đây đều là các dự án của cộng đồng: chúng không được MVSEP duy trì và chúng tôi không thể đảm bảo chất lượng của chúng.
Gói này được phân phối trên PyPI dưới tên mvsep-cli và ghi MVSEP là tác giả, điều này có thể khiến nó trông giống như một gói chính thức. Gói này được phát hành và duy trì bởi một bên thứ ba, không phải bởi MVSEP, và kho mã nguồn mà nó liên kết đến không tồn tại. Gói này yêu cầu mã thông báo API của bạn, vì vậy hãy đọc mã nguồn của nó trước khi dán mã thông báo vào đó.
mvsep-cli: pypi.org/project/mvsep-cli
turbo@mvsep.com