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.
Examples in Python: https://github.com/ZFTurbo/MVSep-API-Examples
Unofficial application MacVSep for Mac OS: https://github.com/septcoco/macvsep
Webhooks can be setup here: Webhooks Page
Lưu ý rằng người dùng Premium có thể yêu cầu tối đa 10 tệp cùng lúc, trong khi người dùng miễn phí chỉ được 1 tệp.
Để 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 | String | Token API của bạn |
| audiofile | Binary | Tệp âm thanh được xử lý. Not required if url parameter is set |
| url | String | Link to the audiofile. Not required if audiofile parameter is set |
| remote_type | String | (optional) Remote type of the audiofile. Defaults to direct. Not required if audiofile parameter is set. Supported types are direct (Direct Download), mega (MEGA), drive (Google Drive), dropbox (Dropbox) |
| sep_type | Integer | (tùy chọn) Loại mô hình, mặc định là 11 (Demucs3 Model B (vocals, drums, bass, other)) |
| add_opt1 | String | (tùy chọn) Loại trường phân tách bổ sung đầu tiên |
| add_opt2 | String | (tùy chọn) Loại trường phân tách bổ sung thứ hai |
| add_opt3 | String | (tùy chọn) Loại tách bổ sung thứ ba |
| output_format | Integer | (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ị | Additional fields |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | Key: add_opt1 Name: Output files Options:
Key: add_opt2 Name: Model Type Options:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | Key: add_opt1 Name: Output files Options:
Key: add_opt2 Name: Model Type Options:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | Key: add_opt1 Name: Output files Options:
Key: add_opt2 Name: Model Type Options:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| BS Roformer (vocals, instrumental) | 40 | Key: add_opt1 Name: Vocal model type Options:
|
| MelBand Roformer (vocals, instrumental) | 48 | Key: add_opt1 Name: Vocal model type Options:
|
| MDX23C (vocals, instrumental) | 25 | Key: add_opt1 Name: Vocal model type Options:
|
| SCNet (vocals, instrumental) | 46 | Key: add_opt1 Name: Vocal model type Options:
|
| Demucs4 HT (vocals, drums, bass, other) | 20 | Key: add_opt1 Name: Model type Options:
|
| MDX B (vocals, instrumental) | 23 | Key: add_opt1 Name: Vocal model type Options:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | Key: add_opt1 Name: Model Type Options:
Key: add_opt2 Name: Agressiveness Options:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MelBand Karaoke (lead/back vocals) | 49 | Key: add_opt1 Name: Karaoke model type Options:
Key: add_opt2 Name: Extraction type Options:
|
| MDX-B Karaoke (lead/back vocals) | 12 | Key: add_opt1 Name: Karaoke model type Options:
|
| MVSep Piano (piano, other) | 29 | Key: add_opt1 Name: Piano model type Options:
|
| MVSep Guitar (guitar, other) | 31 | Key: add_opt1 Name: Guitar model type Options:
|
| MVSep Bass (bass, other) | 41 | Key: add_opt1 Name: Bass model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| MVSep Drums (drums, other) | 44 | Key: add_opt1 Name: Drums model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| MVSep Strings (strings, other) | 52 | |
| MVSep Wind (wind, other) | 54 | Key: add_opt1 Name: Wind model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| MVSep Organ (organ, other) | 58 | Key: add_opt1 Name: Organ model type Options:
|
| MVSep Saxophone (saxophone, other) | 61 | Key: add_opt1 Name: Model type Options:
|
| MVSep Violin (violin, other) | 65 | |
| Apollo Enhancers (by JusperLee and Lew) | 51 | Key: add_opt1 Name: Model type Options:
|
| Reverb Removal (noreverb) | 22 | Key: add_opt1 Name: Model Type Options:
Key: add_opt2 Name: Preprocess Options:
|
| MVSep Crowd removal (crowd, other) | 34 | Key: add_opt1 Name: Model type Options:
|
| MVSep Demucs4HT DNR (dialog, sfx, music) | 24 | Key: add_opt1 Name: Model type Options:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | Key: add_opt1 Name: Model Type Options:
|
| MVSep DnR v3 (speech, music, sfx) | 56 | Key: add_opt1 Name: Model type Options:
Key: add_opt2 Name: How to extract Options:
Key: add_opt3 Name: Output files Options:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | Key: add_opt1 Name: Model Type Options:
Key: add_opt2 Name: Preprocess Options:
|
| DeNoise by aufr33 | 47 | Key: add_opt1 Name: Model type Options:
|
| Whisper (extract text from audio) | 39 | Key: add_opt1 Name: Model type Options:
Key: add_opt2 Name: Transcription type Options:
|
| Parakeet (extract text from audio) | 64 | Key: add_opt1 Name: Model type Options:
|
| Medley Vox (Multi-singer separation) | 53 | Key: add_opt1 Name: Model type Options:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | Key: add_opt1 Name: Model Type Options:
|
| MVSep Male/Female separation | 57 | Key: add_opt1 Name: Model type Options:
Key: add_opt2 Name: How to extract Options:
|
| MDX A/B (vocals, drums, bass, other) | 7 | Key: add_opt1 Name: Vocal model type Options:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | Key: add_opt1 Name: Model type Options:
|
| Vit Large 23 (vocals, instrum) | 33 | Key: add_opt1 Name: Model type Options:
|
| UVRv5 Demucs (vocals, music) | 17 | Key: add_opt1 Name: Model Type Options:
|
| MVSep DNR (music, sfx, speech) | 18 | |
| MVSep 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 | Key: add_opt1 Name: Model type Options:
|
| UnMix | 3 | Key: add_opt1 Name: Model type Options:
|
| Zero Shot (Query Based) (Low quality) | 14 | Key: add_opt1 Name: Model Type Options:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | Key: add_opt1 Name: Model type Options:
|
| Stable Audio Open Gen | 62 | Key: add_opt1 Name: Text prompt Options: Key: add_opt2 Name: Length (in seconds) Options:
|
| MVSep MultiSpeaker (MDX23C) | 42 | Key: add_opt1 Name: Model Type Options:
|
| Aspiration (by Sucial) | 50 | Key: add_opt1 Name: Model type Options:
|
| AudioSR (Super Resolution) | 59 | Key: add_opt1 Name: Cutoff (Hz) Options:
|
| Phantom Centre extraction (by wesleyr36) | 55 | |
| FlashSR (Super Resolution) | 60 |
| 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 | Some parameters are missing or invalid. 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 |
Unknown or unvalid api_token. 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 | String | Hash được phân tách |
| mirror | Integer | (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 | string | (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) |
To get the result of remote job, you need to make a GET call to the following url:
https://mvsep.com/api/separation/get-remote
| Trường | Loại | Mô tả |
|---|---|---|
| hash | String | 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 | Shows unprocessed jobs count in user's priority (only shown when status is waiting) |
| data -> current_order | Shows the order of user's job (only shown when status is waiting) |
| data -> message | Shows the description of status (only when status is failed) |
| data -> link | Shows link to "GET RESULT" URL of created job (only shown when status is done) |
| data -> hash | Hash of the separation (only shown when status is done) |
To cancel the separation and refund used credits (if the separation is not being processed yet), you need to make a POST call to the following url:
https://mvsep.com/api/separation/cancel
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | string | Khóa API của người dùng |
| hash | string | 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
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ề:
|
| 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 | Shows monthly usage count of separation type |
| rating | Shows monthly usage rating of separation type as array:
|
| 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 | String | (tùy chọn) Mã ngôn ngữ gồm 2 chữ cái (en, ru) |
| start | Integer | (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 | Integer | (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 |
To get site queue information, you need to make a GET call to the following url:
https://mvsep.com/api/app/queue
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | String | (optional) Khóa API của người dùng |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| Khoá | Giá trị |
|---|---|
| queue |
Contains array of current queues for different plans:
|
| plan |
Contains current queue for current plan (add api_token to request for registered/premium plan):
|
Để 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 | Integer | (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 | Integer | (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/demo?start=0&limit=2'
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ả |
|---|---|---|
| String | Email của người dùng | |
| password | String | 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 | String | Tên của người dùng |
| String | Email của người dùng | |
| password | String | Mật khẩu của người dùng |
| password_confirmation | String | 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 | String | 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 | String | Khóa API của người dùng |
| start | Integer | (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 | Integer | (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 | String | 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 | String | 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 | String | 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 | String | 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ệ |
To get information about Quality Checker queue entries, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/queue
| Trường | Loại | Mô tả |
|---|---|---|
| start | Integer | (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 | Integer | (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 | Identification number of entry |
| dataset_type | Dataset Type chosen when adding the entry / Leaderboard type
|
| date | Created date of the entry |
| algo_name | Name of the used separation type/algorithm |
| main_text | Description of the used separation type/algorithm |
| proc | Status of the processing
|
| proc_remote_date | Timestamp of processing date |
| msg | Returns "OK" if successful, otherwise shows error message |
| metrics | Information about entry metrics |
| sdr_* (wildcard) | SDR of the corresponding stems |
| dataset_name | Name of the dataset |
To get information about Quality Checker leaderboards, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/leaderboard
| Trường | Loại | Mô tả |
|---|---|---|
| dataset_type | String | Dataset Type, defaults to 0 if not given
|
| start | Integer | (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 | Integer | (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 | String | Filters Separation Type/Algorithm names by given text |
| sort | String | Sort by given SDR of the stem. You can get list of sortable values for given dataset type from sortables key in response |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| Khoá | Giá trị |
|---|---|
| data | Contains array of Quality Checker entries. Refer to GET QUEUE response from Quality Checker Section for more information |
| dataset_type | Used dataset type key |
| sortables | Keys that can be used to sort used dataset type by given stem in sequential order. |
| sort | Used sorting key from sortable. |
To create Quality Checker entry, you need to make a POST call to the following url:
https://mvsep.com/api/quality_checker/add
| Trường | Loại | Mô tả |
|---|---|---|
| api_token | String | (required) Token API của bạn |
| zipfile | Binary | (required) Zip file to be processed |
| algo_name | String | (required) Name of the algorithm |
| main_text | String | (required) Description of the algorithm |
| dataset_type | String | Dataset type. Defaults to 0.
|
| password | String | (required) Password to delete algorithm |
| ensemble | integer | 0 - algorithm is not ensemble. 1 - algorithm is ensemble. |
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 | Contains information about entry |
| data -> id | ID of the entry. |
| data -> link | Link to the entry. |
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 |
Unknown or unvalid api_token. Lỗi này xuất hiện nếu bạn sử dụng token API không xác định.
|
To get information about Quality Checker queue entry by id, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/entry
| Trường | Loại | Mô tả |
|---|---|---|
| id | Integer | (required) ID of the entry |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
To delete Quality Checker queue entry by id and password, you need to make a GET call to the following url:
https://mvsep.com/api/quality_checker/delete
| Trường | Loại | Mô tả |
|---|---|---|
| id | Integer | (required) ID of the entry |
| password | String | (required) Used password for the entry |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| Khoá | Giá trị |
|---|---|
| success |
|
| data->message | Shows whether entry was deleted |
turbo@mvsep.com