turbo@mvsep.com
API ของ MVSEP ให้การเข้าถึงโปรแกรมเพื่อสร้างการแยก ส่งคืนผลลัพธ์ รับข้อมูลไซต์ และควบคุมความสามารถของผู้ใช้
เพื่อที่จะใช้ API นี้ คุณจะต้องมี คีย์ API คุณไม่ได้เข้าสู่ระบบ กรุณาเข้าสู่ระบบเพื่อรับโทเค็น API ของคุณ
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
โปรดทราบว่าผู้ใช้ Premium สามารถขอใช้งานได้ 10 งานพร้อมกัน ในขณะที่ผู้ใช้ที่ไม่ใช่ Premium สามารถขอใช้งานได้เพียง 1 งานพร้อมกัน
หากต้องการสร้างการแยกคุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/separation/create
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของคุณ |
| audiofile | Binary | ไฟล์เสียงที่จะถูกประมวลผล. 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 | (เป็นทางเลือก) ประเภทการแยก ค่าเริ่มต้นคือ 11 (Demucs3 Model B (นักร้อง กลอง เบส อื่นๆ)) |
| add_opt1 | String | (ไม่บังคับ) ช่องเพิ่มเติมประเภทการแยกช่องแรก |
| add_opt2 | String | (ไม่บังคับ) ฟิลด์เพิ่มเติมที่สองของประเภทการแยก |
| add_opt3 | String | (ทางเลือก) ฟิลด์ประเภทการแยกที่สามเพิ่มเติม |
| output_format | Integer | (ไม่บังคับ) รูปแบบเอาต์พุต ค่าเริ่มต้นเป็น 0 (mp3 (320kbps)) |
| is_demo | Boolean | (ไม่บังคับ) ควรเผยแพร่การแยกไปยังหน้าสาธิต โดยค่าเริ่มต้นเป็นเท็จ |
| ชื่อ | ค่า | 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 |
| ชื่อ | ค่า |
|---|---|
| mp3 (320 kbps) | 0 |
| wav (uncompressed, 16 bit) | 1 |
| flac (lossless, 16 bit) | 2 |
| m4a (lossy) | 3 |
| wav (uncompressed, 32 bit) | 4 |
| flac (lossless, 24 bit) | 5 |
curl --location --request POST 'https://mvsep.com/api/separation/create'
--form 'audiofile=@"/path/to/file.mp3"'
--form 'api_token="<โทเค็น API ของคุณ>"'
--form 'sep_type="9"'
--form 'add_opt1="0"'
--form 'add_opt2="1"'
--form 'output_format="1"'
--form 'is_demo="1"'
| คีย์ | ค่า |
|---|---|
| success |
|
| data | เก็บข้อมูลเพิ่มเติมขึ้นอยู่กับsuccess คีย์ |
| data -> link | แสดงลิงก์ไปยัง URL "รับผลลัพธ์" ของการแยกเสียงที่สร้างขึ้น (แสดงเฉพาะเมื่อ success เป็น จริง) |
| data -> hash | แสดงแฮชการแยกเสียงที่สร้างขึ้น (แสดงเฉพาะเมื่อ success เป็น จริง) |
| data -> message | แสดงคำอธิบายของข้อผิดพลาด (แสดงเฉพาะเมื่อ success เป็น ไม่จริง) |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | พารามิเตอร์บางตัวหายไปหรือไม่ถูกต้อง ข้อผิดพลาดนี้จะปรากฏขึ้นเมื่อคุณไม่ผ่านพารามิเตอร์บังคับทุกตัวหรือผ่านพารามิเตอร์ที่ไม่ถูกต้อง |
| 401 |
ไม่รู้จักหรือไม่ถูกต้อง api_token ข้อผิดพลาดนี้จะปรากฏขึ้นหากคุณใช้คีย์ API ที่ไม่รู้จัก
|
เพื่อให้ได้ผลลัพธ์การแยก คุณต้องทำการเรียก GET ไปยัง URL ต่อไปนี้
https://mvsep.com/api/separation/get
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| hash | String | แยกแฮช |
| mirror | Integer | (ไม่บังคับ) ใช้มิเรอร์อื่นหากตั้งค่าเป็น 1 โดยมีค่าเริ่มต้นเป็น 0 ต้องใช้ api_token และ 1 เครดิตหากตั้งค่าเป็น 1 |
| api_token | string | (ไม่บังคับ) คีย์ API ของผู้ใช้ จำเป็นหากพารามิเตอร์มิเรอร์ถูกตั้งค่าเป็น 1 |
curl --location --request GET 'https://mvsep.com/api/separation/get?hash=20230327071601-0e3e5c6c85-13-dimensions.mp3'
| คีย์ | ค่า |
|---|---|
| success |
|
| status |
|
| data | เก็บข้อมูลเพิ่มเติมขึ้นอยู่กับปุ่ม status |
| data -> queue_count | แสดงจำนวนงานที่ยังไม่ได้ประมวลผลตามลำดับความสำคัญของผู้ใช้ (แสดงเฉพาะเมื่อ status เป็น waiting หรือ กำลังแจกจ่าย) |
| data -> current_order | แสดงลำดับงานของผู้ใช้ (แสดงเฉพาะเมื่อ สถานะ คือ กำลังรอ หรือ กำลังแจกจ่าย) |
| data -> message | แสดงคำอธิบายสถานะ (แสดงในสถานะทั้งหมด แสดงเหตุผลของข้อผิดพลาดแทนเมื่อ สถานะ เป็น ล้มเหลว) |
| data -> algorithm | แสดงอัลกอริทึมที่ใช้ในการแยกเสียง (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> algorithm_description | แสดงรายละเอียดอัลกอริทึมที่ใช้ในงาน (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> output_format | แสดงรูปแบบผลลัพธ์ของงาน (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> tags | แสดงเมตาแท็กเสียง (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> input_file | แสดงรายละเอียดการดาวน์โหลดเสียงอินพุต (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> files | แสดงรายละเอียดการดาวน์โหลดเสียงเอาท์พุต (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> date | แสดงวันที่ดำเนินการแยกเสียง (แสดงเฉพาะเมื่อ สถานะ เป็น เสร็จสิ้น) |
| data -> finished_chunks | แสดงจำนวนส่วนที่เสร็จสมบูรณ์ของการแยกเสียงขนาดใหญ่ (แสดงเฉพาะเมื่อ สถานะ เป็น กำลังแจกจ่าย) |
| data -> all_chunks | แสดงจำนวนส่วนทั้งหมดของการแยกเสียงขนาดใหญ่ (แสดงเฉพาะเมื่อ สถานะ เป็น กำลังแจกจ่าย) |
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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| hash | String | แยกแฮช |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| คีย์ | ค่า |
|---|---|
| success |
|
| status |
|
| data | เก็บข้อมูลเพิ่มเติมขึ้นอยู่กับปุ่ม status |
| 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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | string | คีย์ API ของผู้ใช้ |
| hash | string | แยกแฮช |
curl --location --request POST 'https://mvsep.com/api/separation/cancel' --form 'api_token="<โทเค็น API ของคุณ>"' --form 'hash="<hash>"'
| คีย์ | ค่า |
|---|---|
| success |
|
หากต้องการรับข้อมูลโดยละเอียดเกี่ยวกับประเภทการแยก คุณต้องทำการเรียก GET ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/algorithms
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
ส่งคืนข้อมูลเป็นแบบแถว:
| คีย์ | ค่า |
|---|---|
| render_id | ค่าชนิดการแยกเสียง (ID) |
| name | ชื่อของประเภทการแยกเสียง |
| algorithm_group_id |
กลุ่มที่ประเภทการแยกเสียงอยู่:
|
| orientation |
การแยกประเภทนี้มีไว้สำหรับใคร:
|
| order_id | ลำดับประเภทการแยกเสียง |
| price_coefficient |
ใช้เพื่อคำนวณว่างานจะหักเครดิตจากผู้ใช้พรีเมียมเท่าไร ใช้สูตรนี้ : floor(<ระยะเวลาของไฟล์เสียงเป็นวินาที> * price_coefficient / 60)?:1
|
| usage | Shows monthly usage count of separation type |
| rating | Shows monthly usage rating of separation type as array:
|
| algorithm_fields | ประกอบด้วยข้อมูลเกี่ยวกับฟิลด์เพิ่มเติมของประเภทการแยก |
| algorithm_fields -> name |
แสดงฟิลด์เพิ่มเติมของประเภทการแยกเสียง:
|
| algorithm_fields -> text | แสดงชื่อฟิลด์เพิ่มเติมของประเภทการแยกเสียง |
| algorithm_fields -> options | ค่าคีย์เชนที่เข้ารหัส JSON ของฟิลด์เพิ่มเติม |
| algorithm_fields -> default_key | ค่าเริ่มต้นของฟิลด์เพิ่มเติม หนึ่งในคีย์ของ <code>algorithm_fields -> options</code> |
| algorithm_descriptions | ประกอบด้วยข้อมูลเกี่ยวกับคำอธิบายประเภทการแยกเสียง |
| algorithm_descriptions -> short_description | คำอธิบายสั้นๆ ของประเภทการแยกเสียงที่ไม่ใช้ HTML |
| algorithm_descriptions -> long_description | คำอธิบายโดยละเอียดของประเภทการแยกเสียงที่ใช้ HTML |
| algorithm_descriptions -> lang | โค้ดภาษาที่ระบุของคำอธิบาย |
หากต้องการรับข้อมูลเกี่ยวกับข่าวสารล่าสุดเกี่ยวกับ MVSEP คุณต้องทำการเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/news
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| lang | String | (ทางเลือก) รหัสภาษา 2 ตัวอักษร (en, ru) |
| start | Integer | (ทางเลือก) จุดเริ่มต้นออฟเซ็ต ค่าเริ่มต้นคือ 0 (กล่าวคือ เริ่มจากล่าสุด) |
| limit | Integer | (ทางเลือก) จำนวนผลลัพธ์ที่ส่งคืนสูงสุด ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
ส่งคืนข้อมูลเป็นแบบแถว:
| คีย์ | ค่า |
|---|---|
| title | หัวข้อข่าว |
| lang | หัวข้อข่าว |
| text | คำอธิบายข่าวแบบเต็ม |
| created_at | วันที่ข่าว |
To get site queue information, you need to make a GET call to the following url:
https://mvsep.com/api/app/queue
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | (optional) คีย์ API ของผู้ใช้ |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| คีย์ | ค่า |
|---|---|
| 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):
|
หากต้องการรับข้อมูลเกี่ยวกับการแยกตัวอย่าง คุณต้องทำการเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/demo
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| start | Integer | (ทางเลือก) จุดเริ่มต้นออฟเซ็ต ค่าเริ่มต้นคือ 0 (กล่าวคือ เริ่มจากล่าสุด) |
| limit | Integer | (ทางเลือก) จำนวนผลลัพธ์ที่ส่งคืนสูงสุด ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
curl --location --request GET 'https://mvsep.com/api/app/demo?start=0&limit=2'
ส่งคืนข้อมูลเป็นแบบแถว:
| คีย์ | ค่า |
|---|---|
| hash | แยกแฮช |
| date | วันที่ทำการแยกเสียง |
| input_audio | อินพุต URL เสียง |
| size | ขนาดเสียงอินพุต |
| algorithm | ประกอบด้วยข้อมูลพื้นฐานเกี่ยวกับประเภทการแยกที่ใช้ (ดูแท็บ รับประเภทการแยกเสียง สำหรับข้อมูลเกี่ยวกับพารามิเตอร์ที่ส่งคืน) |
หากต้องการพิสูจน์ตัวตนของผู้ใช้และรับคีย์ API คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/login
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| String | อีเมลผู้ใช้งาน | |
| password | String | รหัสผ่านผู้ใช้งาน |
curl --location --request POST 'https://mvsep.com/api/app/login' --form 'email="<อีเมลผู้ใช้งาน>"' --form 'password="<รหัสผ่านผู้ใช้งาน>"'
| คีย์ | ค่า |
|---|---|
| success |
|
| data | ประกอบด้วยข้อมูลเมื่อข้อมูลประจำตัวถูกต้อง |
| data -> name | ชื่อผู้ใช้งาน |
| data -> email | อีเมลผู้ใช้งาน |
| data -> api_token | รหัส API ของผู้ใช้ โปรดเก็บไว้ให้ปลอดภัยและใช้สำหรับการดำเนินการต่อไป |
| data -> premium_minutes | เครดิตที่เหลือสำหรับผู้ใช้ |
| data -> premium_enabled |
ผู้ใช้อนุญาตให้ใช้เครดิตหรือไม่
|
| data -> long_filenames_enabled |
ผู้ใช้ต้องการข้อมูลเพิ่มเติมในชื่อไฟล์หรือไม่
|
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | ระบุข้อมูลรับรองไม่ถูกต้อง |
หากต้องการลงทะเบียนผู้ใช้ในไซต์ MVSEP คุณต้องทำการเรียก POST ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/register
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| name | String | ชื่อผู้ใช้งาน |
| String | อีเมลผู้ใช้งาน | |
| password | String | รหัสผ่านผู้ใช้งาน |
| password_confirmation | String | เขียนรหัสผ่านของผู้ใช้งานซ้ำอีกรอบ |
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"'
| คีย์ | ค่า |
|---|---|
| success |
|
| message | เกิดขึ้นเมื่อแบบฟอร์มถูกต้อง |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | ฟอร์มไม่ถูกต้อง |
หากต้องการรับข้อมูลผู้ใช้ คุณจะต้องเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/user
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของผู้ใช้ |
curl --location --request GET 'https://mvsep.com/api/app/user?api_token=<โทเค็น API ของคุณ>'
| คีย์ | ค่า |
|---|---|
| success |
|
| data | ประกอบด้วยข้อมูลเมื่อข้อมูลประจำตัวถูกต้อง |
| data -> name | ชื่อผู้ใช้งาน |
| data -> email | อีเมลผู้ใช้งาน |
| data -> api_token | รหัส API ของผู้ใช้ โปรดเก็บไว้ให้ปลอดภัยและใช้สำหรับการดำเนินการต่อไป |
| data -> premium_minutes | เครดิตที่เหลือสำหรับผู้ใช้ |
| data -> premium_enabled |
ผู้ใช้อนุญาตให้ใช้เครดิตหรือไม่
|
| data -> long_filenames_enabled |
ผู้ใช้ต้องการข้อมูลเพิ่มเติมในชื่อไฟล์หรือไม่
|
| data -> current_queue | แสดงการแยกเสียงอย่างต่อเนื่องสำหรับผู้ใช้ |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการรับประวัติข้อมูลการแยกเสียงพื้นฐานของผู้ใช้ คุณต้องเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/separation_history
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของผู้ใช้ |
| start | Integer | (ทางเลือก) จุดเริ่มต้นออฟเซ็ต ค่าเริ่มต้นคือ 0 (กล่าวคือ เริ่มจากล่าสุด) |
| limit | Integer | (ทางเลือก) จำนวนผลลัพธ์ที่ส่งคืนสูงสุด ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
curl --location --request GET 'https://mvsep.com/api/app/separation_history?api_token=<โทเค็น API ของคุณ>&start=1&limit=2'
| คีย์ | ค่า |
|---|---|
| success |
|
| data | ประกอบด้วยอาร์เรย์ข้อมูลพื้นฐานเกี่ยวกับการแยกก่อนหน้า |
| data -> hash | แยกแฮช |
| data -> job_exists | ประกอบด้วยอาร์เรย์ข้อมูลพื้นฐานเกี่ยวกับการแยกก่อนหน้า |
| data -> credits | จำนวนเครดิตที่ใช้สำหรับการแยกเสียงนี้เป็นโมฆะหากไม่เกิดการแยกเสียง |
| data -> time_left | เหลือเวลาประมาณจนกว่าการแยกเสียงจะโดนลบ |
| data -> algorithm | ประกอบด้วยข้อมูลพื้นฐานเกี่ยวกับประเภทการแยกที่ใช้ (ดูแท็บ รับประเภทการแยกเสียง สำหรับข้อมูลเกี่ยวกับพารามิเตอร์ที่ส่งคืน) |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการเปิดใช้งานพรีเมียมสำหรับผู้ใช้ คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/enable_premium
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของผู้ใช้ |
curl --location --request POST 'https://mvsep.com/api/app/enable_premium' --form 'api_token="<โทเค็น API ของคุณ>"'
| คีย์ | ค่า |
|---|---|
| success |
|
| message | แจ้งสถานะการดำเนินงาน |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการปิดใช้งานพรีเมียมสำหรับผู้ใช้ คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/disable_premium
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของผู้ใช้ |
curl --location --request POST 'https://mvsep.com/api/app/disable_premium' --form 'api_token="<โทเค็น API ของคุณ>"'
| คีย์ | ค่า |
|---|---|
| success |
|
| message | แจ้งสถานะการดำเนินงาน |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการเปิดใช้งานชื่อไฟล์แบบยาวสำหรับผู้ใช้ คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/enable_long_filenames
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของผู้ใช้ |
curl --location --request POST 'https://mvsep.com/api/app/enable_long_filenames' --form 'api_token="<โทเค็น API ของคุณ>"'
| คีย์ | ค่า |
|---|---|
| success |
|
| message | แจ้งสถานะการดำเนินงาน |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการปิดใช้งานชื่อไฟล์แบบยาวสำหรับผู้ใช้ คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/disable_long_filenames
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | คีย์ API ของผู้ใช้ |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<โทเค็น API ของคุณ>"'
| คีย์ | ค่า |
|---|---|
| success |
|
| message | แจ้งสถานะการดำเนินงาน |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| start | Integer | (ทางเลือก) จุดเริ่มต้นออฟเซ็ต ค่าเริ่มต้นคือ 0 (กล่าวคือ เริ่มจากล่าสุด) |
| limit | Integer | (ทางเลือก) จำนวนผลลัพธ์ที่ส่งคืนสูงสุด ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
ส่งคืนข้อมูลเป็นแบบแถว:
| คีย์ | ค่า |
|---|---|
| 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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| dataset_type | String | Dataset Type, defaults to 0 if not given
|
| start | Integer | (ทางเลือก) จุดเริ่มต้นออฟเซ็ต ค่าเริ่มต้นคือ 0 (กล่าวคือ เริ่มจากล่าสุด) |
| limit | Integer | (ทางเลือก) จำนวนผลลัพธ์ที่ส่งคืนสูงสุด ค่าเริ่มต้นคือ 10 และสูงสุดคือ 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'
| คีย์ | ค่า |
|---|---|
| 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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | String | (required) คีย์ API ของคุณ |
| 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"'
| คีย์ | ค่า |
|---|---|
| success |
|
| data | Contains information about entry |
| data -> id | ID of the entry. |
| data -> link | Link to the entry. |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | ฟอร์มไม่ถูกต้อง |
| 401 |
ไม่รู้จักหรือไม่ถูกต้อง api_token ข้อผิดพลาดนี้จะปรากฏขึ้นหากคุณใช้คีย์ API ที่ไม่รู้จัก
|
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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| 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
| สนาม | ชนิด | คำอธิบาย |
|---|---|---|
| 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"'
| คีย์ | ค่า |
|---|---|
| success |
|
| data->message | Shows whether entry was deleted |
turbo@mvsep.com