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.
Ví dụ trong Python: https://github.com/ZFTurbo/MVSep-API-Examples
Ứng dụng không chính thức MacVSep dành cho Mac OS: https://github.com/septcoco/macvsep
Bạn có thể thiết lập Webhooks tại đây: Trang Webhooks
Đặc tả OpenAPI: mvsep-openapi-spec.json
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.
Để 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)) |
| 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:
|
| BS PolarFormer (vocals, instrumental) | 123 | Khoá: add_opt1 Tên: Overlap Tuỳ chọn:
|
| MelBand Roformer (vocals, instrumental) | 48 | Khoá: add_opt1 Tên: Vocal model type 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:
|
| 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 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 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 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 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 (braam , other) | 117 | |
| MVSep FX (fx, other) | 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:
|
| 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 | |
| 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:
|
| 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
| 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ề) |
Để 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 |
Để đă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ệ |
Để 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ệ |
Để 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 |
turbo@mvsep.com