turbo@mvsep.com
MVSEP API는 분리를 생성하고, 결과를 반환하고, 사이트 정보를 얻고, 사용자 기능을 제어할 수 있는 프로그래밍 방식의 액세스를 제공합니다.
이 API를 사용하려면 API 키가 필요합니다. 로그인하지 않았습니다. 로그인하여 API 토큰을 받아보세요.
Python 예제: https://github.com/ZFTurbo/MVSep-API-Examples
Mac용 비공식 애플리케이션 MacVSep: https://github.com/septcoco/macvsep
Webhook은 여기에서 설정할 수 있습니다: Webhook 페이지
OpenAPI 사양: mvsep-openapi-spec.json
프리미엄 사용자는 무제한 동시 작업을 요청할 수 있지만, 비프리미엄 사용자는 동시 작업 1개만 요청할 수 있습니다.
MVSEP runs regional API endpoints. All regions share one account database, so the same account, API key and job hashes work everywhere:
https://de.mvsep.com/apihttps://hk.mvsep.com/apiRequests to https://mvsep.com/api are geo-steered to the region nearest to the caller. For API integrations we recommend calling a regional endpoint explicitly — it keeps the whole job lifecycle on one host regardless of where your requests originate from.
Every separation is processed and stored in the region where it was created, and the download URLs returned in responses always point to that region's host. For best performance, choose the endpoint closest to your servers and use the same host for the whole job lifecycle — create, status polling and file downloads.
You can query the status of any job from any region (the database is shared), but the output files themselves are always served by the region that owns the job.
분리를 생성하기 위해서는 다음의 URL로 POST 호출을 해야 합니다.
https://mvsep.com/api/separation/create
| 필드 | 타입 | 설명 |
|---|---|---|
| api_token | 문자열 | 당신의 API 키 |
| audiofile | 바이너리 | 처리할 오디오 파일입니다. url 매개변수가 설정되어 있거나 모델이 파일 입력을 사용하지 않는 경우에는 필요하지 않습니다. 매처링 모델의 경우 입력에 audiofile 대신 target_audiofile 및 reference_audiofile을 사용하세요. |
| url | 문자열 | 오디오 파일 링크입니다. audiofile 매개변수가 설정된 경우에는 필요하지 않습니다. |
| remote_type | 문자열 | (선택 사항) 오디오 파일의 원격 유형입니다. 기본값은 direct입니다. audiofile 매개변수가 설정된 경우에는 필요하지 않습니다. 지원되는 유형은 direct(직접 다운로드), mega(MEGA), drive(Google Drive), dropbox(Dropbox)입니다. |
| sep_type | 정수 | (선택 과목) 분리 유형, 기본값은 11입니다 (Demucs3 모델 B (보컬, 드럼, 베이스, 기타)) |
| add_opt1 | 문자열 | (선택 과목) 분리 유형 첫 번째 추가 필드 |
| add_opt2 | 문자열 | (선택 과목) 분리 유형 두 번째 추가 필드 |
| add_opt3 | 문자열 | (선택 사항) 분리 유형 세 번째 추가 필드 |
| output_format | 정수 | (선택 과목) 출력 형식, 기본값은 0입니다 (mp3 (320kbps)) |
| is_demo | 불리언 | (선택 과목) 분리 결과를 데모 페이지에 게시할 것인가, 기본값은 false입니다. |
| 이름 | 값 | 추가 필드 |
|---|---|---|
| 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 옵션들:
|
| 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 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 | |
| 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 옵션들:
|
| 이름 | 값 |
|---|---|
| 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 | 생성된 작업의 "GET RESULT" URL에 대한 링크 표시(success가 true인 경우에만 표시됨) |
| data -> hash | 생성된 작업 해시를 표시합니다(success가 true인 경우에만 표시됨). |
| data -> message | 오류에 대한 설명을 표시합니다(success가 false인 경우에만 표시됨). |
MVSEP API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 일부 매개변수가 누락되었거나 유효하지 않습니다. 필수 매개변수를 모두 전달하지 않거나 잘못된 매개변수를 전달할 때 이 오류가 발생합니다. |
| 401 |
알 수 없거나 유효하지 않은 api_token. 알려지지 않은 API 키를 사용할 경우 이 오류가 나타납니다.
|
분리 결과를 얻으려면 다음 URL로 GET 요청을 해야 합니다:
https://mvsep.com/api/separation/get
| 필드 | 타입 | 설명 |
|---|---|---|
| hash | 문자열 | 분리 해시 |
| mirror | 정수 | (선택 사항) 1로 설정된 경우 다른 미러를 사용하고 기본값은 0입니다. 1로 설정된 경우 api_token와 1학점이 필요합니다. |
| api_token | 문자열 | (선택 사항) 사용자의 API 키입니다. mirror 매개 변수가 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인 경우에만 표시됨). |
원격 작업의 결과를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
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 | 생성된 작업의 "GET RESULT" URL 링크를 표시합니다(status가 done일 때만 표시). |
| data -> hash | 분리 해시를 표시합니다(status가 done일 때만 표시). |
분리를 취소하고 사용한 크레딧을 환불받으려면(분리가 아직 처리 중이 아닌 경우) 다음 URL로 POST 호출을 해야 합니다:
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 |
|
분리 유형에 대한 자세한 데이터를 얻으려면 다음 URL로 GET 호출을 해야 합니다:
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에 대한 최신 뉴스를 확인하려면 다음 URL로 GET 호출을 해야 합니다:
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 | 뉴스 날짜 |
사이트 대기열 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/app/queue
| 필드 | 타입 | 설명 |
|---|---|---|
| api_token | 문자열 | (선택 사항) 사용자의 API 키 |
curl --location --request GET 'https://mvsep.com/api/app/queue'
| 키 | 값 |
|---|---|
| queue |
다양한 요금제의 현재 대기열 배열을 포함합니다:
|
| plan |
현재 요금제의 현재 대기열을 포함합니다(등록/프리미엄 요금제로 요청하려면 api_token을 추가):
|
데모 분리에 대한 정보를 얻으려면 다음 URL에 대한 GET 호출을 수행해야 합니다.
https://mvsep.com/api/app/demo
| 필드 | 타입 | 설명 |
|---|---|---|
| start | 정수 | (선택 사항) 시작점 오프셋, 기본값은 0(즉, 최신부터 시작)입니다. |
| limit | 정수 | (선택 사항) 반환되는 최대 결과 수, 기본값은 10개, 최대값은 20개입니다. |
| algorithm_id | 정수 | 선택 사항인 분리 유형 ID입니다. 특정 알고리즘으로 생성된 데모 분리만 반환하려면 사용하세요. 값은 GET SEPARATION TYPES 엔드포인트의 render_id와 일치합니다. |
| options[FIELD] | 문자열 / 정수 | 알고리즘 옵션 값에 대한 선택적 필터입니다. FIELD를 GET SEPARATION TYPES 응답의 algorithm_fields -> name에 있는 추가 필드 키로 바꾼 다음, 해당 필드의 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 목록을 확인하세요. options[FIELD] 안에는 필드 name을 사용하고, JSON 옵션 키 중 하나를 값으로 사용하세요.
데이터를 어레이로 반환합니다:
| 키 | 값 |
|---|---|
| hash | 분리 해시 |
| date | 분리 날짜 |
| input_audio | 오디오 URL 입력 |
| size | 입력 오디오 크기 |
| algorithm | 사용된 분리 유형에 대한 기본 정보를 포함합니다(반환된 매개변수에 대한 정보는 GET SEPARATION TYPES 탭 참조). |
사용자를 인증하고 사용자의 API 키를 받으려면 다음 URL로 POST 호출을 해야 합니다:
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 | 잘못된 자격 증명이 지정됨 |
MVSEP 사이트에 사용자를 등록하려면 다음 URL로 POST 호출을 해야 합니다:
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 | 양식이 잘못되었습니다 |
사용자 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
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 키 |
사용자의 기본 정보 분리 기록을 가져오려면 다음 URL로 GET 호출을 해야 합니다:
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 | 사용된 분리 유형에 대한 기본 정보를 포함합니다(반환된 매개변수에 대한 정보는 GET SEPARATION TYPES 탭 참조). |
MVSEP API는 다음 오류 코드를 사용합니다:
| 오류 코드 | 의미 |
|---|---|
| 400 | 잘못된 API 키 |
사용자의 프리미엄 사용을 활성화하려면 다음 URL로 POST 호출을 해야 합니다:
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 키 |
사용자의 프리미엄 사용을 비활성화하려면 다음 URL로 POST 호출을 해야 합니다:
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 키 |
사용자에게 긴 파일 이름을 사용하도록 설정하려면 다음 URL로 POST 호출을 해야 합니다:
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 키 |
사용자의 긴 파일명을 사용하지 않으려면 다음 URL로 POST 호출을 해야 합니다:
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 키 |
품질 검사기 대기열 항목 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
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 |
| dataset_name | 데이터셋 이름 |
품질 검사기 리더보드 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/quality_checker/leaderboard
| 필드 | 타입 | 설명 |
|---|---|---|
| dataset_type | 문자열 | 데이터셋 유형입니다. 지정하지 않으면 기본값은 0입니다.
|
| start | 정수 | (선택 사항) 시작점 오프셋, 기본값은 0(즉, 최신부터 시작)입니다. |
| limit | 정수 | (선택 사항) 반환되는 최대 결과 수, 기본값은 10개, 최대값은 20개입니다. |
| algo_name_filter | 문자열 | 지정한 텍스트로 분리 유형/알고리즘 이름을 필터링합니다 |
| sort | 문자열 | 지정한 스템의 SDR 기준으로 정렬합니다. 응답의 sortables 키에서 지정한 데이터셋 유형에 대해 정렬 가능한 값 목록을 얻을 수 있습니다. |
curl --location --request GET 'https://mvsep.com/api/quality_checker/leaderboard?&start=1&limit=2&algo_name_filter=MVSep'
| 키 | 값 |
|---|---|
| data | 품질 검사기 항목 배열을 포함합니다. 자세한 내용은 품질 검사기 섹션의 GET QUEUE 응답을 참조하세요. |
| dataset_type | 사용된 데이터셋 유형 키 |
| sortables | 사용된 데이터셋 유형을 지정한 스템 기준으로 순차 정렬하는 데 사용할 수 있는 키입니다. |
| sort | sortable에서 사용된 정렬 키입니다. |
품질 검사기 항목을 생성하려면 다음 URL로 POST 호출을 해야 합니다:
https://mvsep.com/api/quality_checker/add
| 필드 | 타입 | 설명 |
|---|---|---|
| api_token | 문자열 | (필수) 당신의 API 키 |
| zipfile | 바이너리 | (필수) 처리할 ZIP 파일 |
| algo_name | 문자열 | (필수) 알고리즘 이름 |
| main_text | 문자열 | (필수) 알고리즘 설명 |
| dataset_type | 문자열 | 데이터셋 유형입니다. 기본값은 0입니다.
|
| password | 문자열 | (필수) 알고리즘을 삭제하기 위한 비밀번호 |
| ensemble | 정수 | 0 - 알고리즘이 앙상블이 아닙니다. 1 - 알고리즘이 앙상블입니다. |
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 키를 사용할 경우 이 오류가 나타납니다.
|
ID로 품질 검사기 대기열 항목 정보를 가져오려면 다음 URL로 GET 호출을 해야 합니다:
https://mvsep.com/api/quality_checker/entry
| 필드 | 타입 | 설명 |
|---|---|---|
| id | 정수 | (필수) 항목 ID |
curl --location --request GET 'https://mvsep.com/api/quality_checker/entry?id=7675'
ID와 비밀번호로 품질 검사기 대기열 항목을 삭제하려면 다음 URL로 GET 호출을 해야 합니다:
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 | 항목이 삭제되었는지 여부를 표시합니다 |
turbo@mvsep.com