API ของ MVSEP เปิดให้เข้าถึงผ่านโปรแกรมเพื่อสร้างงานแยกเสียง รับผลลัพธ์ ดูข้อมูลของเว็บไซต์ และควบคุมการตั้งค่าของผู้ใช้
เพื่อที่จะใช้ API นี้ คุณจะต้องมี คีย์ API คุณไม่ได้เข้าสู่ระบบ กรุณาเข้าสู่ระบบเพื่อรับโทเค็น API ของคุณ
โปรดทราบว่าผู้ใช้ระดับพรีเมียมสามารถของานพร้อมกันได้ไม่จำกัด ในขณะที่ผู้ใช้ที่ไม่ใช่ระดับพรีเมียมสามารถขอได้ 1 งานพร้อมกันเท่านั้น
MVSEP ให้บริการ API endpoint ในระดับภูมิภาค โดยทุกภูมิภาคจะใช้ฐานข้อมูลบัญชีผู้ใช้ร่วมกัน ดังนั้นบัญชีผู้ใช้, API key และ job hash ชุดเดียวกันจึงสามารถใช้งานได้ในทุกภูมิภาค
https://de.mvsep.com/apihttps://de2.mvsep.com/apihttps://hk.mvsep.com/apiคำขอที่ส่งไปยัง https://mvsep.com/api จะถูกกำหนดเส้นทางตามตำแหน่งทางภูมิศาสตร์ (geo-steered) โดยผู้เรียกใช้งานในยุโรปจะถูกส่งไปยัง de ผู้เรียกใช้งานในเอเชียเหนือจะถูกส่งไปยัง hk และผู้เรียกใช้งานจากที่อื่นจะถูกส่งไปยัง de2 สำหรับการเชื่อมต่อผ่าน API เราขอแนะนำให้เรียก endpoint ของภูมิภาคใดภูมิภาคหนึ่งโดยตรง วิธีนี้จะช่วยให้วงจรการทำงานทั้งหมดของงานอยู่บนโฮสต์เดียวกัน ไม่ว่าคำขอของคุณจะถูกส่งมาจากที่ใดก็ตาม
กระบวนการแยกไฟล์ (separation) แต่ละรายการจะถูกประมวลผลและจัดเก็บไว้ในภูมิภาคที่สร้างรายการนั้นขึ้นมา และ URL สำหรับดาวน์โหลดที่ได้รับในส่วนการตอบกลับ (response) จะชี้ไปยังโฮสต์ของภูมิภาคนั้นเสมอ เพื่อประสิทธิภาพสูงสุด ควรเลือก endpoint ที่อยู่ใกล้กับเซิร์ฟเวอร์ของคุณมากที่สุด และใช้โฮสต์เดิมตลอดทั้งวงจรการทำงาน (job lifecycle) ซึ่งครอบคลุมทั้งขั้นตอนการสร้างรายการ การตรวจสอบสถานะ และการดาวน์โหลดไฟล์
คุณสามารถตรวจสอบสถานะของงานใดๆ ก็ตามได้จากทุกภูมิภาค (เนื่องจากมีการใช้ฐานข้อมูลร่วมกัน) แต่ไฟล์ผลลัพธ์จะถูกส่งมอบโดยภูมิภาคที่เป็นเจ้าของงานนั้นเสมอ
หากต้องการสร้างการแยกคุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/separation/create
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | คีย์ API ของคุณ |
| audiofile | ไบนารี | ไฟล์เสียงที่จะประมวลผล ไม่จำเป็นต้องระบุหากตั้งค่าพารามิเตอร์ url ไว้แล้ว หรือโมเดลไม่ได้ใช้ไฟล์เป็นอินพุต สำหรับโมเดล matchering ให้ใช้ target_audiofile และ reference_audiofile เป็นอินพุตแทน audiofile |
| url | สตริง | ลิงก์ไปยังไฟล์เสียง ไม่จำเป็นต้องระบุหากตั้งค่าพารามิเตอร์ audiofile ไว้แล้ว |
| remote_type | สตริง | (ไม่บังคับ) ประเภทของแหล่งไฟล์เสียงระยะไกล ค่าเริ่มต้นคือ direct ไม่จำเป็นต้องระบุหากตั้งค่าพารามิเตอร์ audiofile ไว้แล้ว ประเภทที่รองรับ ได้แก่ direct (ดาวน์โหลดโดยตรง), mega (MEGA), drive (Google Drive), dropbox (Dropbox) |
| sep_type | จำนวนเต็ม | (ไม่บังคับ) ประเภทการแยกเสียง ค่าเริ่มต้นคือ 20 ค่านี้คือ ID ของประเภทการแยกเสียง ดูรายละเอียดเพิ่มเติมได้ที่หัวข้อ GET SEPARATION TYPES จะถูกละเว้นเมื่อมีการระบุ <code class="higlighted">preset_id</code> |
| preset_id | จำนวนเต็ม | (ไม่บังคับ) เรียกใช้พรีเซ็ตที่คุณบันทึกไว้รายการใดรายการหนึ่งกับไฟล์ แทนการใช้อัลกอริทึมเพียงรายการเดียว โปรดระบุ sep_type หรือ preset_id อย่างใดอย่างหนึ่ง พรีเซ็ตจะกำหนดอัลกอริทึม ตัวเลือก และรูปแบบผลลัพธ์ของตนเอง ดังนั้น sep_type ฟิลด์ add_opt และ output_format จะถูกละเว้นทั้งหมด ระบบจะส่งคืนค่า hash ซึ่งคุณสามารถตรวจสอบสถานะได้เช่นเดียวกับงานแยกเสียง โดยผลลัพธ์จะมีหนึ่งรายการสำหรับแต่ละโหนด Output ของพรีเซ็ต โปรดดูตารางพรีเซ็ตด้านล่างเพื่อดู ID ของคุณ |
| add_opt1 | สตริง | (ไม่บังคับ) ฟิลด์เพิ่มเติมช่องที่หนึ่งของประเภทการแยกเสียง |
| add_opt2 | สตริง | (ไม่บังคับ) ฟิลด์เพิ่มเติมช่องที่สองของประเภทการแยกเสียง |
| add_opt3 | สตริง | (ไม่บังคับ) ฟิลด์เพิ่มเติมช่องที่สามของประเภทการแยกเสียง |
| output_format | จำนวนเต็ม | (ไม่บังคับ) รูปแบบเอาต์พุต ค่าเริ่มต้นเป็น 0 (mp3 (320kbps)) |
| is_demo | บูลีน | (ไม่บังคับ) กำหนดว่าจะเผยแพร่ผลการแยกเสียงไปยังหน้าเดโมหรือไม่ ค่าเริ่มต้นคือ false |
| webhook_url | สตริง | (optional) A URL we will POST the finished result to, so you do not have to keep polling. The body is the same JSON as GET SEPARATION. This overrides the account-wide address set on the webhooks page, which is useful when several of your own users share one API token. Must be a publicly reachable http or https address. |
| ชื่อ | ค่า | ฟิลด์เพิ่มเติม |
|---|---|---|
| Ensemble (vocals, instrum) | 26 | คีย์: add_opt1 ชื่อ: Output files ตัวเลือก:
คีย์: add_opt2 ชื่อ: Model Type ตัวเลือก:
|
| Ensemble (vocals, instrum, bass, drums, other) | 28 | คีย์: add_opt1 ชื่อ: Output files ตัวเลือก:
คีย์: add_opt2 ชื่อ: Model Type ตัวเลือก:
|
| Ensemble All-In (vocals, bass, drums, piano, guitar, lead/back vocals, other) | 30 | คีย์: add_opt1 ชื่อ: Output files ตัวเลือก:
คีย์: add_opt2 ชื่อ: Model Type ตัวเลือก:
|
| BS Roformer SW (vocals, bass, drums, guitar, piano, other) | 63 | |
| Demucs4 HT (vocals, drums, bass, other) | 20 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| BS Roformer (vocals, instrumental) | 40 | คีย์: add_opt1 ชื่อ: Vocal model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Overlap ตัวเลือก:
คีย์: add_opt3 ชื่อ: Set of stems ตัวเลือก:
|
| BS PolarFormer (vocals, instrumental) | 123 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Overlap ตัวเลือก:
|
| MelBand Roformer (vocals, instrumental) | 48 | คีย์: add_opt1 ชื่อ: Vocal model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Overlap ตัวเลือก:
|
| MDX23C (vocals, instrumental) | 25 | คีย์: add_opt1 ชื่อ: Vocal model type ตัวเลือก:
|
| SCNet (vocals, instrumental) | 46 | คีย์: add_opt1 ชื่อ: Vocal model type ตัวเลือก:
|
| MDX B (vocals, instrumental) | 23 | คีย์: add_opt1 ชื่อ: Vocal model type ตัวเลือก:
|
| Ultimate Vocal Remover VR (vocals, music) | 9 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Agressiveness ตัวเลือก:
|
| Demucs4 Vocals 2023 (vocals, instrum) | 27 | |
| MVSep Karaoke (lead/back vocals) | 49 | คีย์: add_opt1 ชื่อ: Karaoke model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Extraction type ตัวเลือก:
|
| MDX-B Karaoke (lead/back vocals) | 12 | คีย์: add_opt1 ชื่อ: Karaoke model type ตัวเลือก:
|
| MVSep Crowd removal (crowd, other) | 34 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| Medley Vox (Multi-singer separation) | 53 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| MVSep Multichannel BS (vocals, instrumental) | 43 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Processing Mode ตัวเลือก:
|
| MVSep Male/Female separation | 57 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Choir (choir, other) | 112 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep SATB Choir (soprano, alto, tenor, bass) | 111 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Drums (drums, other) | 44 | คีย์: add_opt1 ชื่อ: Drums model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
คีย์: add_opt3 ชื่อ: Output files ตัวเลือก:
|
| MVSep Bass (bass, other) | 41 | คีย์: add_opt1 ชื่อ: Bass model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
คีย์: add_opt3 ชื่อ: Output files ตัวเลือก:
|
| MVSep Synth (synth, other) | 88 | คีย์: add_opt1 ชื่อ: How to extract ตัวเลือก:
|
| DrumSep (4-6 stems: kick, snare, cymbals, toms, ride, hh, crash) | 37 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Preprocess ตัวเลือก:
|
| MVSep Piano (piano, other) | 29 | คีย์: add_opt1 ชื่อ: Piano model type ตัวเลือก:
|
| MVSep Digital Piano (digital-piano, other) | 79 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Keys (keys, other) | 106 | |
| MVSep Organ (organ, other) | 58 | คีย์: add_opt1 ชื่อ: Organ model type ตัวเลือก:
|
| MVSep Harpsichord (harpsichord, other) | 91 | |
| MVSep Accordion (accordion, other) | 99 | |
| MVSep Vibraphone | 129 | |
| MVSep Metal Bars | 130 | |
| MVSep Rhodes | 131 | |
| MVSep Clavinet | 135 | |
| MVSep Mellotron | 136 | |
| MVSep Guitar (guitar, other) | 31 | คีย์: add_opt1 ชื่อ: Guitar model type ตัวเลือก:
|
| MVSep Acoustic Guitar (acoustic-guitar, other) | 66 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Electric Guitar (electric-guitar, other) | 81 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Lead/Rhythm Guitar (lead-guitar, rhythm-guitar) | 101 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| 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 | คีย์: add_opt1 ชื่อ: String model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Violin (violin, other) | 65 | |
| MVSep Viola (viola, other) | 69 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Cello (cello, other) | 70 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Double Bass (double-bass, other) | 73 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Wind (wind, other) | 54 | คีย์: add_opt1 ชื่อ: Wind model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
คีย์: add_opt3 ชื่อ: Output files ตัวเลือก:
|
| MVSep Brass (brass, other) | 107 | คีย์: add_opt1 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Woodwind (woodwind, other) | 108 | คีย์: add_opt1 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Saxophone (saxophone, other) | 61 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| MVSep Flute (flute, other) | 67 | คีย์: add_opt1 ชื่อ: Flute model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Trumpet (trumpet, other) | 71 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Trombone (trombone, other) | 75 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Oboe (oboe, other) | 77 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Clarinet (clarinet, other) | 78 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep French Horn (french-horn, other) | 82 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Harmonica (harmonica, other) | 87 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Tuba (tuba, other) | 92 | |
| MVSep Bassoon (bassoon, other) | 93 | |
| MVSep Bagpipes (bagpipes , other) | 116 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| 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 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Celesta (celesta, other) | 110 | คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
|
| MVSep Clap | 133 | |
| MVSep Cowbell | 128 | |
| MVSep Demucs4HT DNR (speech, music, effects) | 24 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| BandIt Plus (speech, music, effects) | 36 | |
| BandIt v2 (speech, music, effects) | 45 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
|
| MVSep DnR v3 (speech, music, effects) | 56 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: How to extract ตัวเลือก:
คีย์: add_opt3 ชื่อ: Output files ตัวเลือก:
|
| MVSep Braam | 117 | |
| MVSep Risers | 125 | |
| MVSep FX | 122 | |
| Apollo Enhancers (by JusperLee, Lew, baicai1145) | 51 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Cutoff (Hz) ตัวเลือก:
|
| Reverb Removal (noreverb) | 22 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Preprocess ตัวเลือก:
|
| DeNoise by aufr33 and gabox | 47 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| AudioSR (Super Resolution) | 59 | คีย์: add_opt1 ชื่อ: Cutoff (Hz) ตัวเลือก:
|
| FlashSR (Super Resolution) | 60 | |
| Stable Audio Open Gen | 62 | คีย์: add_opt1 ชื่อ: Text prompt ตัวเลือก: คีย์: add_opt2 ชื่อ: Length (in seconds) ตัวเลือก:
|
| Whisper (extract text from audio) | 39 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Transcription type ตัวเลือก:
|
| Parakeet (extract text from audio) | 64 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Version ตัวเลือก:
|
| VibeVoice (Voice Cloning) | 103 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Text prompt ตัวเลือก: คีย์: add_opt3 ชื่อ: Extract vocals first ตัวเลือก:
|
| VibeVoice (TTS) | 104 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
คีย์: add_opt2 ชื่อ: Text prompt ตัวเลือก: |
| Qwen3-TTS (Custom Voice) | 118 | คีย์: add_opt1 ชื่อ: Text prompt ตัวเลือก: คีย์: add_opt2 ชื่อ: Speaker ตัวเลือก:
คีย์: add_opt3 ชื่อ: Language ตัวเลือก:
คีย์: add_opt4 ชื่อ: Voice description ตัวเลือก: |
| Qwen3-TTS (Voice Design) | 119 | คีย์: add_opt1 ชื่อ: Text prompt ตัวเลือก: คีย์: add_opt2 ชื่อ: Voice description ตัวเลือก: คีย์: add_opt3 ชื่อ: Language ตัวเลือก:
|
| Qwen3-TTS (Voice Cloning) | 120 | คีย์: add_opt1 ชื่อ: Text prompt ตัวเลือก: คีย์: add_opt2 ชื่อ: Reference text in audio (optional) ตัวเลือก: คีย์: add_opt3 ชื่อ: Language ตัวเลือก:
คีย์: add_opt4 ชื่อ: Extract vocals first ตัวเลือก:
|
| Mega 53-stem Model | 126 | |
| Upmixing by Jazzpear | 137 | |
| Bark (Speech Gen) | 115 | คีย์: add_opt1 ชื่อ: Text prompt ตัวเลือก: คีย์: add_opt2 ชื่อ: Speaker ตัวเลือก:
|
| MVSep MultiSpeaker (MDX23C) | 42 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
|
| Aspiration (by Sucial) | 50 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| Phantom Centre extraction | 55 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| Matchering (by sergree) | 68 | |
| SOME (Singing-Oriented MIDI Extractor) | 80 | คีย์: add_opt1 ชื่อ: How to use ตัวเลือก:
|
| Transkun (Piano -> MIDI) | 113 | คีย์: add_opt1 ชื่อ: How to extract ตัวเลือก:
|
| Basic Pitch (MIDI Extraction) | 114 | |
| ADTOF Plus (Drums -> MIDI) | 127 | คีย์: add_opt1 ชื่อ: How to extract ตัวเลือก:
|
| HeartMuLa (Song Gen) | 121 | คีย์: add_opt1 ชื่อ: Lyrics ตัวเลือก: คีย์: add_opt10 ชื่อ: Topic ตัวเลือก:
คีย์: add_opt2 ชื่อ: Tags (optional) ตัวเลือก: คีย์: add_opt3 ชื่อ: Genre ตัวเลือก:
คีย์: add_opt4 ชื่อ: Timbre ตัวเลือก:
คีย์: add_opt5 ชื่อ: Gender ตัวเลือก:
คีย์: add_opt6 ชื่อ: Mood ตัวเลือก:
คีย์: add_opt7 ชื่อ: Instrument ตัวเลือก:
คีย์: add_opt8 ชื่อ: Scene ตัวเลือก:
คีย์: add_opt9 ชื่อ: Region ตัวเลือก:
|
| Demucs3 Model (vocals, drums, bass, other) | 10 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| MDX A/B (vocals, drums, bass, other) | 7 | คีย์: add_opt1 ชื่อ: Vocal model type ตัวเลือก:
|
| Vit Large 23 (vocals, instrum) | 33 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| UVRv5 Demucs (vocals, music) | 17 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
|
| 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 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| UnMix | 3 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
| Zero Shot (Query Based) (Low quality) | 14 | คีย์: add_opt1 ชื่อ: Model Type ตัวเลือก:
|
| LarsNet (kick, snare, cymbals, toms, hihat) | 38 | คีย์: add_opt1 ชื่อ: Model type ตัวเลือก:
|
พรีเซ็ตเป็นข้อมูลส่วนตัวของบัญชีที่สร้างขึ้น ดังนั้นตารางนี้จะแสดงพรีเซ็ต ของคุณ รวมถึงพรีเซ็ตที่ได้รับการคัดสรร คุณสามารถสร้างและแก้ไขได้ใน ตัวแก้ไขพรีเซ็ต
คุณยังไม่มีพรีเซ็ต โปรดเข้าสู่ระบบและสร้างพรีเซ็ตใน ตัวแก้ไขพรีเซ็ต แล้ว ID ของพรีเซ็ตจะแสดงที่นี่
| ชื่อ | ค่า |
|---|---|
| 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 "GET RESULT" ของงานที่สร้างขึ้น (แสดงเฉพาะเมื่อ success เป็น true) |
| data -> hash | แสดงแฮชของงานที่สร้างขึ้น (แสดงเฉพาะเมื่อ success เป็น true) |
| data -> message | แสดงคำอธิบายของข้อผิดพลาด (แสดงเฉพาะเมื่อ success เป็น false) |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | พารามิเตอร์บางตัวขาดหายไปหรือไม่ถูกต้อง ข้อผิดพลาดนี้จะปรากฏขึ้นเมื่อคุณไม่ได้ส่งพารามิเตอร์ที่จำเป็นครบทุกตัว หรือส่งพารามิเตอร์ที่ไม่ถูกต้อง |
| 401 |
api_token ไม่รู้จักหรือไม่ถูกต้อง ข้อผิดพลาดนี้จะปรากฏขึ้นหากคุณใช้คีย์ API ที่ไม่รู้จัก
|
เพื่อให้ได้ผลลัพธ์การแยก คุณต้องทำการเรียก GET ไปยัง URL ต่อไปนี้
https://mvsep.com/api/separation/get
endpoint เดียวกันนี้ยังใช้สำหรับส่งคืนผลลัพธ์การทำงานของพรีเซ็ตอีกด้วย โดยให้ตรวจสอบค่า hash ที่ได้รับจาก preset_id เช่นเดียวกับการตรวจสอบงานแยกเสียง โครงสร้างของข้อมูลที่ส่งกลับจะเหมือนกันทุกประการ โดย status จะเปลี่ยนสถานะตามลำดับจาก waiting ไปเป็น processing และ done และ data.type จะมีค่าเป็น preset_run แต่ละรายการใน data.files คือหนึ่งโหนด Output ของพรีเซ็ต ซึ่งถูกตั้งชื่อตาม label ของมัน ไม่ใช่ตาม stem ผลลัพธ์การทำงานจะมองเห็นได้เฉพาะบัญชีผู้ใช้ที่สร้างพรีเซ็ตนั้นเท่านั้น
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| hash | สตริง | แฮชของการแยกเสียง |
| mirror | จำนวนเต็ม | (ไม่บังคับ) ใช้มิเรอร์อื่นหากตั้งค่าเป็น 1 โดยมีค่าเริ่มต้นเป็น 0 ต้องใช้ api_token และ 1 เครดิตหากตั้งค่าเป็น 1 |
| api_token | สตริง | (ไม่บังคับ) คีย์ 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 หรือ distributing) |
| data -> current_order | แสดงลำดับของงานของผู้ใช้ (แสดงเฉพาะเมื่อ status เป็น waiting หรือ distributing) |
| data -> message | แสดงคำอธิบายของสถานะ (แสดงในทุกสถานะ และจะแสดงสาเหตุของข้อผิดพลาดแทนเมื่อ status เป็น failed) |
| data -> algorithm | แสดงอัลกอริทึมที่ใช้กับงานนี้ (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> algorithm_description | แสดงรายละเอียดของอัลกอริทึมที่ใช้กับงานนี้ (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> output_format | แสดงรูปแบบผลลัพธ์ของงาน (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> tags | แสดงเมตาแท็กของไฟล์เสียง (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> input_file | แสดงรายละเอียดการดาวน์โหลดไฟล์เสียงต้นฉบับ (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> files | แสดงรายละเอียดการดาวน์โหลดไฟล์เสียงผลลัพธ์ (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> date | แสดงวันที่ประมวลผลงาน (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> finished_chunks | แสดงจำนวนส่วนย่อยที่เสร็จแล้วของงานขนาดใหญ่ (แสดงเฉพาะเมื่อ status เป็น distributing) |
| data -> all_chunks | แสดงจำนวนส่วนย่อยทั้งหมดของงานขนาดใหญ่ (แสดงเฉพาะเมื่อ status เป็น distributing) |
ลบงานแยกเสียงของคุณเอง ไม่ว่าจะเป็นงานปกติหรือการรันพรีเซ็ต การลบจะเอาทั้งข้อมูลของงานและไฟล์ผลลัพธ์ออก งานแยกเสียงที่ยังประมวลผลอยู่ต้องยกเลิกก่อน การลบจะไม่คืนเครดิต เนื่องจากงานได้ประมวลผลไปแล้ว
POST https://mvsep.com/api/separation/delete
คุณสามารถตรวจสอบสถานะของงานใดๆ ก็ตามได้จากทุกภูมิภาค (เนื่องจากมีการใช้ฐานข้อมูลร่วมกัน) แต่ไฟล์ผลลัพธ์จะถูกส่งมอบโดยภูมิภาคที่เป็นเจ้าของงานนั้นเสมอ
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| hash | สตริง | แฮชของการแยกเสียง |
| api_token | สตริง | คีย์ API ของผู้ใช้ จำเป็นต้องระบุ |
curl --location --request POST 'https://mvsep.com/api/separation/delete'
--form 'api_token="<โทเค็น API ของคุณ>"'
--form 'hash="20230327071601-0e3e5c6c85-13-dimensions.mp3"'
| คีย์ | ค่า |
|---|---|
| success |
|
| data -> message | แสดงคำอธิบายของสถานะ (แสดงในทุกสถานะ และจะแสดงสาเหตุของข้อผิดพลาดแทนเมื่อ status เป็น failed) |
หากต้องการรับผลลัพธ์ของงานระยะไกล คุณต้องเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/separation/get-remote
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| hash | สตริง | แฮชของการแยกเสียง |
curl --location --request GET 'https://mvsep.com/api/separation/get-remote?hash=n2AwBjy4KsFZfqqR'
| คีย์ | ค่า |
|---|---|
| success |
|
| status |
|
| data | เก็บข้อมูลเพิ่มเติมโดยขึ้นอยู่กับคีย์ status |
| data -> queue_count | แสดงจำนวนงานที่ยังไม่ได้ประมวลผลในระดับความสำคัญของผู้ใช้ (แสดงเฉพาะเมื่อ status เป็น waiting) |
| data -> current_order | แสดงลำดับของงานของผู้ใช้ (แสดงเฉพาะเมื่อ status เป็น waiting) |
| data -> message | แสดงคำอธิบายของสถานะ (เฉพาะเมื่อ status เป็น failed) |
| data -> link | แสดงลิงก์ไปยัง URL "GET RESULT" ของงานที่สร้างขึ้น (แสดงเฉพาะเมื่อ status เป็น done) |
| data -> hash | แฮชของงานแยกเสียง (แสดงเฉพาะเมื่อ status เป็น done) |
หากต้องการยกเลิกงานแยกเสียงและคืนเครดิตที่ใช้ไป (ในกรณีที่งานยังไม่เริ่มประมวลผล) คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/separation/cancel
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | คีย์ API ของผู้ใช้ |
| hash | สตริง | แฮชของการแยกเสียง |
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
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| scopes | สตริง | กำหนดว่าจะรวมโมเดลที่ใช้อินพุตรูปแบบอื่นด้วยหรือไม่
single_upload หากไม่ได้ระบุไว้ หากต้องการดูโมเดลทั้งหมด ให้ตั้งค่า scopes=single_upload,no_upload,matchering_upload
|
curl --location --request GET 'https://mvsep.com/api/app/algorithms'
ส่งคืนข้อมูลในรูปแบบอาร์เรย์:
| คีย์ | ค่า |
|---|---|
| render_id | ค่าชนิดการแยกเสียง (ID) |
| name | ชื่อของประเภทการแยกเสียง |
| algorithm_group_id | กลุ่มที่ประเภทการแยกเสียงอยู่: |
| algorithm_group | ประกอบด้วยข้อมูลของกลุ่มอัลกอริทึมที่อัลกอริทึมนี้สังกัดอยู่ |
| algorithm_group -> name | ชื่อของกลุ่มอัลกอริทึม |
| audio_widget |
ประเภทของวิดเจ็ตเสียงที่จะใช้สำหรับอัลกอริทึม ซึ่งสามารถใช้เพื่อกำหนดวิธีแสดงเครื่องเล่นเสียงสำหรับอัลกอริทึมที่ส่วนหน้า ค่าที่เป็นไปได้คือ:
|
| orientation |
ประเภทการแยกเสียงนี้มีไว้สำหรับใคร:
|
| order_id | ลำดับประเภทการแยกเสียง |
| price_coefficient |
ใช้เพื่อคำนวณว่างานจะหักเครดิตจากผู้ใช้พรีเมียมเท่าไร ใช้สูตรนี้ : floor(<ระยะเวลาของไฟล์เสียงเป็นวินาที> * price_coefficient / 60)?:1
|
| usage | แสดงจำนวนการใช้งานรายเดือนของประเภทการแยก |
| rating | แสดงคะแนนการใช้งานรายเดือนของประเภทการแยกเป็นอาร์เรย์:
|
| 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 | สตริง | (ไม่บังคับ) รหัสภาษา 2 ตัวอักษร (en, ru) |
| start | จำนวนเต็ม | (ไม่บังคับ) ตำแหน่งออฟเซ็ตเริ่มต้น ค่าเริ่มต้นคือ 0 (คือเริ่มจากรายการล่าสุด) |
| limit | จำนวนเต็ม | (ไม่บังคับ) จำนวนผลลัพธ์สูงสุดที่ส่งคืน ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
curl --location --request GET 'https://mvsep.com/api/app/news?lang=en&start=2&limit=1'
ส่งคืนข้อมูลในรูปแบบอาร์เรย์:
| คีย์ | ค่า |
|---|---|
| title | หัวข้อข่าว |
| lang | หัวข้อข่าว |
| text | คำอธิบายข่าวแบบเต็ม |
| created_at | วันที่ข่าว |
หากต้องการรับข้อมูลคิวของไซต์ คุณต้องทำการเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/queue
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | (ไม่บังคับ) คีย์ API ของผู้ใช้ |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| คีย์ | ค่า |
|---|---|
| queue |
ประกอบด้วยอาร์เรย์ของคิวปัจจุบันสำหรับแผนต่างๆ:
|
| plan |
แสดงคิวปัจจุบันของแผนที่ใช้อยู่ (เพิ่ม api_token ในคำขอเพื่อดูคิวของแผนลงทะเบียน/พรีเมียม):
|
หากต้องการรับข้อมูลเกี่ยวกับการแยกตัวอย่าง คุณต้องทำการเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/demo
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| start | จำนวนเต็ม | (ไม่บังคับ) ตำแหน่งออฟเซ็ตเริ่มต้น ค่าเริ่มต้นคือ 0 (คือเริ่มจากรายการล่าสุด) |
| limit | จำนวนเต็ม | (ไม่บังคับ) จำนวนผลลัพธ์สูงสุดที่ส่งคืน ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
| algorithm_id | จำนวนเต็ม | (ไม่บังคับ) ID ของประเภทการแยกเสียง ใช้เพื่อให้ส่งคืนเฉพาะตัวอย่างการแยกเสียงที่สร้างจากอัลกอริทึมเดียว ค่าที่ใช้ตรงกับ render_id จาก endpoint GET SEPARATION TYPES |
| options[FIELD] | สตริง / จำนวนเต็ม | ตัวกรองทางเลือกสำหรับค่าตัวเลือกอัลกอริทึม แทนที่ FIELD ด้วยคีย์ฟิลด์เพิ่มเติมจาก algorithm_fields -> name ในการตอบกลับ GET SEPARATION TYPES จากนั้นส่งหนึ่งในคีย์ options ของฟิลด์นั้นเป็นค่า ตัวอย่าง: options[vocals]=1 |
| additional_options | สตริง | (ไม่บังคับ) ตัวกรองแบบดิบที่ค้นหาข้อความในข้อมูลตัวเลือกของงานที่บันทึกไว้ สำหรับการเชื่อมต่อใหม่ ๆ แนะนำให้ใช้ options[FIELD] มากกว่า เพราะชัดเจนกว่าและประกอบเงื่อนไขได้ง่ายกว่า |
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'
หากต้องการสร้างตัวกรองตัวเลือก ขั้นแรกให้เรียก https://mvsep.com/api/app/algorithms และตรวจสอบรายการ algorithm_fields ของอัลกอริทึมแต่ละรายการ ใช้ฟิลด์ name ภายใน options[FIELD] และใช้คีย์ตัวเลือก JSON อันใดอันหนึ่งเป็นค่า
ส่งคืนข้อมูลในรูปแบบอาร์เรย์:
| คีย์ | ค่า |
|---|---|
| hash | แฮชของการแยกเสียง |
| date | วันที่ทำการแยกเสียง |
| input_audio | URL ของไฟล์เสียงต้นฉบับ |
| size | ขนาดของไฟล์เสียงต้นฉบับ |
| algorithm | ประกอบด้วยข้อมูลพื้นฐานเกี่ยวกับประเภทการแยกที่ใช้ (ดูแท็บ รับประเภทการแยกเสียง สำหรับข้อมูลเกี่ยวกับพารามิเตอร์ที่ส่งคืน) |
หากต้องการลงทะเบียนผู้ใช้ในไซต์ MVSEP คุณต้องทำการเรียก POST ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/register
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| name | สตริง | ชื่อผู้ใช้งาน |
| สตริง | อีเมลผู้ใช้งาน | |
| password | สตริง | รหัสผ่านผู้ใช้งาน |
| password_confirmation | สตริง | ยืนยันรหัสผ่านของผู้ใช้อีกครั้ง |
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 | ฟอร์มไม่ถูกต้อง |
หากต้องการพิสูจน์ตัวตนของผู้ใช้และรับคีย์ API คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/login
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| สตริง | อีเมลผู้ใช้งาน | |
| password | สตริง | รหัสผ่านผู้ใช้งาน |
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 | ระบุข้อมูลรับรองไม่ถูกต้อง |
หากต้องการรับข้อมูลผู้ใช้ คุณจะต้องเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/app/user
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | คีย์ 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 | สตริง | คีย์ API ของผู้ใช้ |
| start | จำนวนเต็ม | (ไม่บังคับ) ตำแหน่งออฟเซ็ตเริ่มต้น ค่าเริ่มต้นคือ 0 (คือเริ่มจากรายการล่าสุด) |
| limit | จำนวนเต็ม | (ไม่บังคับ) จำนวนผลลัพธ์สูงสุดที่ส่งคืน ค่าเริ่มต้นคือ 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 | จำนวนเครดิตที่ใช้ไปกับงานนี้ จะเป็น null หากงานแยกเสียงไม่มีอยู่แล้ว |
| data -> time_left | เวลาโดยประมาณที่เหลือก่อนที่งานจะถูกลบ |
| data -> algorithm | ประกอบด้วยข้อมูลพื้นฐานเกี่ยวกับประเภทการแยกที่ใช้ (ดูแท็บ รับประเภทการแยกเสียง สำหรับข้อมูลเกี่ยวกับพารามิเตอร์ที่ส่งคืน) |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการดูประวัติการซื้อเครดิตของบัญชีนี้โดยเรียงจากรายการล่าสุด โปรดส่งคำขอ GET ไปยัง URL ต่อไปนี้
https://mvsep.com/api/purchases
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | คีย์ API ของผู้ใช้ |
| limit | จำนวนเต็ม | (ไม่บังคับ) จำนวนรายการซื้อที่ต้องการให้ส่งกลับ ตั้งแต่ 1–100 ค่าเริ่มต้นคือ 20 |
| offset | จำนวนเต็ม | (ไม่บังคับ) จำนวนรายการซื้อที่จะข้ามสำหรับการแบ่งหน้าในประวัติ ค่าเริ่มต้นคือ 0 |
| status | สตริง | (ไม่บังคับ) ส่งกลับเฉพาะรายการซื้อที่อยู่ในสถานะนี้ เช่น succeeded หากไม่ระบุพารามิเตอร์นี้ (หรือส่งค่า all) ระบบจะส่งกลับข้อมูลทั้งหมดที่แสดงอยู่ในหน้าประวัติของเว็บไซต์ รวมถึงรายการชำระเงินที่เริ่มต้นแล้วแต่ยังไม่เสร็จสมบูรณ์ ซึ่งมีสถานะเป็น unpaid และจะไม่ได้รับเครดิต |
curl --location --request GET 'https://mvsep.com/api/purchases?api_token=<โทเค็น API ของคุณ>&status=succeeded&limit=20'
| คีย์ | ค่า |
|---|---|
| purchases | แต่ละรายการซื้อจะประกอบด้วย payment_id, status, amount, จำนวน credits ที่ได้รับ, payment_method (stripe, paddle, yookassa, google_play หรือ app_store) และ date |
| total | จำนวนรายการซื้อทั้งหมดที่ตรงกัน โดยไม่คำนึงถึง limit และ offset ซึ่งสามารถใช้สำหรับการแบ่งหน้าได้ |
| credits | ยอดเครดิตคงเหลือปัจจุบันของบัญชี |
MVSEP จะส่งอีเมลแจ้งเตือนเมื่อยอดเครดิตคงเหลือของคุณลดลงต่ำกว่าค่าที่คุณกำหนดไว้ เพื่อป้องกันไม่ให้การเชื่อมต่อที่กำลังทำงานอยู่หยุดทำงานโดยไม่คาดคิด คำขอ GET จะส่งคืนการตั้งค่าปัจจุบัน ส่วน POST ใช้สำหรับเปลี่ยนแปลงการตั้งค่า การแจ้งเตือนจะถูกส่งเพียงครั้งเดียว และจะไม่ส่งซ้ำจนกว่ายอดเครดิตจะกลับมาอยู่เหนือค่าที่กำหนด
GET https://mvsep.com/api/credit_alert
POST https://mvsep.com/api/credit_alert
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | คีย์ API ของผู้ใช้ |
| credit_threshold | จำนวนเต็ม | (เฉพาะ POST, จำเป็น) ส่งการแจ้งเตือนเมื่อยอดเครดิตคงเหลือเท่ากับหรือต่ำกว่าค่าที่กำหนด 0 จะปิดการแจ้งเตือน การเปลี่ยนค่าเกณฑ์จะเปิดใช้งานการแจ้งเตือนที่เคยถูกส่งไปแล้วอีกครั้ง |
curl --location --request GET 'https://mvsep.com/api/credit_alert?api_token=<โทเค็น API ของคุณ>'
curl --location --request POST 'https://mvsep.com/api/credit_alert' --form 'api_token=<โทเค็น API ของคุณ>' --form 'credit_threshold=100'
| คีย์ | ค่า |
|---|---|
| credit_threshold | ค่าเกณฑ์ที่ตั้งค่าไว้ในปัจจุบัน (หน่วยเป็นเครดิต) |
| enabled | ระบบจะส่งคืนค่า <code>true</code> เมื่อกำหนดค่าเกณฑ์มากกว่า 0 มิฉะนั้นจะส่งคืนค่า <code>false</code> |
| credits | ยอดเครดิตคงเหลือปัจจุบันของบัญชี |
| notified | ระบบจะส่งคืนค่า <code>true</code> หลังจากส่งการแจ้งเตือนสำหรับการลดลงของยอดเครดิตในครั้งปัจจุบัน และจะรีเซ็ตโดยอัตโนมัติเมื่อยอดเครดิตกลับมาอยู่เหนือค่าเกณฑ์ |
| ที่อยู่อีเมลสำหรับรับการแจ้งเตือน |
หากต้องการเปิดใช้งานพรีเมียมสำหรับผู้ใช้ คุณต้องทำการเรียก POST ไปยัง URL ต่อไปนี้:
https://mvsep.com/api/app/enable_premium
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | คีย์ 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 | สตริง | คีย์ 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 | สตริง | คีย์ 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 | สตริง | คีย์ API ของผู้ใช้ |
curl --location --request POST 'https://mvsep.com/api/app/disable_long_filenames' --form 'api_token="<โทเค็น API ของคุณ>"'
| คีย์ | ค่า |
|---|---|
| success |
|
| message | แจ้งสถานะการดำเนินงาน |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | คีย์ API ไม่ถูกต้อง |
หากต้องการรับข้อมูลเกี่ยวกับรายการในคิวของ Quality Checker คุณต้องทำการเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/quality_checker/queue
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| start | จำนวนเต็ม | (ไม่บังคับ) ตำแหน่งออฟเซ็ตเริ่มต้น ค่าเริ่มต้นคือ 0 (คือเริ่มจากรายการล่าสุด) |
| limit | จำนวนเต็ม | (ไม่บังคับ) จำนวนผลลัพธ์สูงสุดที่ส่งคืน ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
curl --location --request GET 'https://mvsep.com/api/quality_checker/queue?&start=1&limit=2'
ส่งคืนข้อมูลในรูปแบบอาร์เรย์:
| คีย์ | ค่า |
|---|---|
| id | หมายเลขประจำรายการ |
| dataset_type | ประเภทชุดข้อมูลที่เลือกเมื่อเพิ่มรายการ/ประเภทลีดเดอร์บอร์ด
|
| date | วันที่สร้างของรายการ |
| algo_name | ชื่อของประเภทการแยก/อัลกอริทึมที่ใช้ |
| main_text | คำอธิบายของประเภท/อัลกอริทึมการแยกที่ใช้ |
| proc | สถานะของการประมวลผล
|
| proc_remote_date | การประทับเวลาของวันที่ประมวลผล |
| msg | ส่งคืนค่า "OK" หากสำเร็จ มิฉะนั้นจะแสดงข้อความแสดงข้อผิดพลาด |
| metrics | ข้อมูลเกี่ยวกับค่าชี้วัดของรายการ |
| sdr_* (wildcard) | ค่า SDR ของแต่ละ stem ที่เกี่ยวข้อง |
| dataset_name | ชื่อของชุดข้อมูล |
หากต้องการรับข้อมูลเกี่ยวกับลีดเดอร์บอร์ดของ Quality Checker คุณต้องทำการเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/quality_checker/leaderboard
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| dataset_type | สตริง | ประเภทชุดข้อมูล มีค่าเริ่มต้นเป็น 0 หากไม่ได้ระบุ
|
| start | จำนวนเต็ม | (ไม่บังคับ) ตำแหน่งออฟเซ็ตเริ่มต้น ค่าเริ่มต้นคือ 0 (คือเริ่มจากรายการล่าสุด) |
| limit | จำนวนเต็ม | (ไม่บังคับ) จำนวนผลลัพธ์สูงสุดที่ส่งคืน ค่าเริ่มต้นคือ 10 และสูงสุดคือ 20 |
| algo_name_filter | สตริง | กรองชื่อประเภทการแยก/อัลกอริทึมตามข้อความที่กำหนด |
| sort | สตริง | จัดเรียงตามค่า SDR ของ stem ที่ระบุ คุณสามารถดูรายการค่าที่ใช้จัดเรียงได้ของชุดข้อมูลแต่ละประเภทจากคีย์ sortables ในการตอบกลับ |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| คีย์ | ค่า |
|---|---|
| data | ประกอบด้วยอาร์เรย์ของรายการใน Quality Checker ดูข้อมูลเพิ่มเติมได้จากการตอบกลับของ GET QUEUE ในหัวข้อ Quality Checker |
| dataset_type | คีย์ประเภทชุดข้อมูลที่ใช้ |
| sortables | คีย์ที่ใช้จัดเรียงชุดข้อมูลประเภทนั้นตามค่าของ stem ที่ระบุได้ |
| sort | คีย์การเรียงลำดับที่ใช้ จากรายการ sortables |
หากต้องการสร้างรายการตรวจสอบคุณภาพ คุณต้องทำการเรียก POST ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/quality_checker/add
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| api_token | สตริง | (จำเป็น) คีย์ API ของคุณ |
| zipfile | ไบนารี | (จำเป็น) ไฟล์ ZIP ที่จะประมวลผล |
| algo_name | สตริง | (จำเป็น) ชื่อของอัลกอริทึม |
| main_text | สตริง | (จำเป็น) คำอธิบายของอัลกอริทึม |
| dataset_type | สตริง | ประเภทชุดข้อมูล ค่าเริ่มต้นคือ 0
|
| password | สตริง | (จำเป็น) รหัสผ่านสำหรับลบอัลกอริทึม |
| ensemble | จำนวนเต็ม | 0 - อัลกอริทึมไม่ใช่แบบ ensemble 1 - อัลกอริทึมเป็นแบบ 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 | ประกอบด้วยข้อมูลของรายการ |
| data -> id | ID ของรายการ |
| data -> link | ลิงก์ไปยังรายการ |
MVSEP API ใช้รหัสข้อผิดพลาดต่อไปนี้
| รหัสข้อผิดพลาด | ความหมาย |
|---|---|
| 400 | ฟอร์มไม่ถูกต้อง |
| 401 |
api_token ไม่รู้จักหรือไม่ถูกต้อง ข้อผิดพลาดนี้จะปรากฏขึ้นหากคุณใช้คีย์ API ที่ไม่รู้จัก
|
หากต้องการรับข้อมูลของรายการในคิว Quality Checker ตาม ID คุณต้องเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/quality_checker/entry
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| id | จำนวนเต็ม | (จำเป็น) ID ของรายการ |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
หากต้องการลบรายการในคิว Quality Checker ด้วย ID และรหัสผ่าน คุณต้องเรียก GET ไปที่ URL ต่อไปนี้:
https://mvsep.com/api/quality_checker/delete
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
| id | จำนวนเต็ม | (จำเป็น) ID ของรายการ |
| password | สตริง | (จำเป็น) รหัสผ่านที่ใช้กับรายการนี้ |
curl --location 'https://mvsep.com/api/quality_checker/delete' --form 'id="7720"' --form 'password="test"'
| คีย์ | ค่า |
|---|---|
| success |
|
| data->message | แสดงว่ารายการถูกลบแล้วหรือไม่ |
ไลบรารี แอปพลิเคชัน และการเชื่อมต่อที่สร้างขึ้นบน API นี้ ยกเว้นกรณีที่ระบุไว้เป็นอย่างอื่น ทั้งหมดเป็นโครงการของชุมชนซึ่งไม่ได้รับการพัฒนาและดูแลโดย MVSEP ดังนั้น MVSEP จึงไม่สามารถรับรองคุณภาพหรือความน่าเชื่อถือของโครงการเหล่านี้ได้
เครื่องมือนี้เผยแพร่บน PyPI ภายใต้ชื่อ mvsep-cli และระบุให้ MVSEP เป็นผู้เขียน ซึ่งอาจทำให้ดูเหมือนเป็นเครื่องมืออย่างเป็นทางการ อย่างไรก็ตาม เครื่องมือนี้ได้รับการเผยแพร่และดูแลโดยบุคคลที่สาม ไม่ใช่โดย MVSEP และที่เก็บซอร์สโค้ดที่ระบุไว้ก็ไม่มีอยู่จริง เครื่องมือนี้จะขอ API token ของคุณ ดังนั้นโปรดตรวจสอบซอร์สโค้ดก่อนวาง API token ของคุณลงไป
mvsep-cli: pypi.org/project/mvsep-cli